@girs/gcr-3 4.3.0 → 4.5.0

package/README.md

@@ -4,82 +4,77 @@
 ![version](https://img.shields.io/npm/v/@girs/gcr-3)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gcr-3)
 
+GJS TypeScript type definitions for Gcr-3, generated from library version 3.41.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.5.0.
 
-GJS TypeScript type definitions for Gcr-3, generated from library version 3.41.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.3.0.
+This package contains type declarations only. It ships no runtime code, so it adds
+nothing to your program and works with any bundler or none at all.
 
 ## Install
 
-Install the type definitions with npm:
 ```bash
 npm install @girs/gcr-3
 ```
 
-## Usage
+Any package manager works. The package has no dependencies beyond other `@girs/*`
+type packages.
+
+## What it exports
+
+| Import | What you get |
+|---|---|
+| `@girs/gcr-3` | the namespace as a default export, plus the ambient and global declarations |
+| `@girs/gcr-3/ambient` | only the `gi://` module declarations |
+| `@girs/gcr-3/import` | only the `imports.gi` declarations |
+| `@girs/gcr-3/gcr-3` | the namespace, without the side-effecting declarations |
+
+## Three ways to import
+
+Which one you use depends on how you write imports elsewhere, not on your toolchain.
+
+### As a module
 
-Import it like any other module:
 ```ts
 import Gcr from '@girs/gcr-3';
 ```
 
-### Ambient Modules
+### As `gi://`
 
-[Ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) let you write the same import you would in plain JavaScript.
-For this you need to include `@girs/gcr-3` or `@girs/gcr-3/ambient` in your `tsconfig` or entry point Typescript file:
+GJS resolves `gi://` at runtime. To give it types, reference the package once, either
+from your entry point or from `tsconfig.json`:
 
-`index.ts`:
 ```ts
-import '@girs/gcr-3'
+import '@girs/gcr-3';
 ```
 
-`tsconfig.json`:
 ```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gcr-3"],
-  ...
-}
+{ "include": ["@girs/gcr-3"] }
 ```
 
-The ambient module now resolves with types:
+Then the runtime spelling type-checks:
 
 ```ts
 import Gcr from 'gi://Gcr?version=3';
 ```
 
-### Global import
-
-GJS's global `imports.gi` works too, with types.
-For this you need to include `@girs/gcr-3` or `@girs/gcr-3/import` in your `tsconfig` or entry point Typescript file:
+Referencing `@girs/gcr-3/ambient` instead pulls in these declarations
+alone. See [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules).
 
-`index.ts`:
-```ts
-import '@girs/gcr-3'
-```
-
-`tsconfig.json`:
-```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gcr-3"],
-  ...
-}
-```
+### As `imports.gi`
 
-That form carries types as well:
+GJS's global object works the same way, via `@girs/gcr-3/import`:
 
 ```ts
 const Gcr = imports.gi.Gcr;
 ```
 
-### Bundle
+## Building
 
-Most projects want a bundler. [esbuild](https://esbuild.github.io/) is the smallest thing that works; the [examples directory](https://github.com/gjsify/ts-for-gir/tree/main/examples) has setups for several others.
+The declarations need no build step. If you bundle, every bundler works, since there is
+no runtime code to resolve. The [examples](https://github.com/gjsify/ts-for-gir/tree/main/examples)
+show working setups for several.
 
 ## Other packages
 
-All existing pre-generated packages can be found on [gjsify/types](https://github.com/gjsify/types).
+Every pre-generated package is at [gjsify/types](https://github.com/gjsify/types).
+
 

package/gcr-3.d.ts

@@ -36,35 +36,35 @@ export namespace Gcr {
          * When a chain is not yet built it has this status. If a chain is modified after
          * being built, it has this status.
          */
-        UNKNOWN,
+        UNKNOWN = 0,
         /**
          * A full chain could not be loaded. The
          * chain does not end with a self-signed certificate, a trusted anchor, or a
          * pinned certificate.
          */
-        INCOMPLETE,
+        INCOMPLETE = 1,
         /**
          * The certificate chain contains a revoked
          * or otherwise explicitly distrusted certificate. The entire chain should
          * be distrusted.
          */
-        DISTRUSTED,
+        DISTRUSTED = 2,
         /**
          * The chain ends with a self-signed
          * certificate. No trust anchor was found.
          */
-        SELFSIGNED,
+        SELFSIGNED = 3,
         /**
          * The chain represents a pinned certificate. A
          * pinned certificate is an exception which trusts a given certificate
          * explicitly for a purpose and communication with a certain peer.
          */
-        PINNED,
+        PINNED = 4,
         /**
          * The chain ends with an anchored
          * certificate. The anchored certificate is not necessarily self-signed.
          */
-        ANCHORED,
+        ANCHORED = 5,
     }
 
 
@@ -76,7 +76,7 @@ export namespace Gcr {
         /**
          * certificate request is in PKCS#10 format
          */
-        CERTIFICATE_REQUEST_PKCS10,
+        CERTIFICATE_REQUEST_PKCS10 = 1,
     }
 
 
@@ -88,19 +88,19 @@ export namespace Gcr {
         /**
          * Failed to parse or serialize the data
          */
-        FAILURE,
+        FAILURE = -1,
         /**
          * The data was unrecognized or unsupported
          */
-        UNRECOGNIZED,
+        UNRECOGNIZED = 1,
         /**
          * The operation was cancelled
          */
-        CANCELLED,
+        CANCELLED = 2,
         /**
          * The data was encrypted or locked and could not be unlocked.
          */
-        LOCKED,
+        LOCKED = 3,
     }
 
 
@@ -112,127 +112,127 @@ export namespace Gcr {
         /**
          * Represents all the formats, when enabling or disabling
          */
-        ALL,
+        ALL = -1,
         /**
          * Not a valid format
          */
-        INVALID,
+        INVALID = 0,
         /**
          * DER encoded private key
          */
-        DER_PRIVATE_KEY,
+        DER_PRIVATE_KEY = 100,
         /**
          * DER encoded RSA private key
          */
-        DER_PRIVATE_KEY_RSA,
+        DER_PRIVATE_KEY_RSA = 101,
         /**
          * DER encoded DSA private key
          */
-        DER_PRIVATE_KEY_DSA,
+        DER_PRIVATE_KEY_DSA = 102,
         /**
          * DER encoded EC private key
          */
-        DER_PRIVATE_KEY_EC,
+        DER_PRIVATE_KEY_EC = 103,
         /**
          * DER encoded SubjectPublicKeyInfo
          */
-        DER_SUBJECT_PUBLIC_KEY,
+        DER_SUBJECT_PUBLIC_KEY = 150,
         /**
          * DER encoded X.509 certificate
          */
-        DER_CERTIFICATE_X509,
+        DER_CERTIFICATE_X509 = 200,
         /**
          * DER encoded PKCS#7 container file which can contain certificates
          */
-        DER_PKCS7,
+        DER_PKCS7 = 300,
         /**
          * DER encoded PKCS#8 file which can contain a key
          */
-        DER_PKCS8,
+        DER_PKCS8 = 400,
         /**
          * Unencrypted DER encoded PKCS#8 file which can contain a key
          */
-        DER_PKCS8_PLAIN,
+        DER_PKCS8_PLAIN = 401,
         /**
          * Encrypted DER encoded PKCS#8 file which can contain a key
          */
-        DER_PKCS8_ENCRYPTED,
+        DER_PKCS8_ENCRYPTED = 402,
         /**
          * DER encoded PKCS#10 certificate request file
          */
-        DER_PKCS10,
+        DER_PKCS10 = 450,
         /**
          * DER encoded SPKAC as generated by HTML5 keygen element
          */
-        DER_SPKAC,
+        DER_SPKAC = 455,
         /**
          * OpenSSL style SPKAC data
          */
-        BASE64_SPKAC,
+        BASE64_SPKAC = 456,
         /**
          * DER encoded PKCS#12 file which can contain certificates and/or keys
          */
-        DER_PKCS12,
+        DER_PKCS12 = 500,
         /**
          * OpenSSH v1 or v2 public key
          */
-        OPENSSH_PUBLIC,
+        OPENSSH_PUBLIC = 600,
         /**
          * OpenPGP key packet(s)
          */
-        OPENPGP_PACKET,
+        OPENPGP_PACKET = 700,
         /**
          * OpenPGP public or private key armor encoded data
          */
-        OPENPGP_ARMOR,
+        OPENPGP_ARMOR = 701,
         /**
          * An OpenSSL style PEM file with unspecified contents
          */
-        PEM,
+        PEM = 1000,
         /**
          * An OpenSSL style PEM file with a private RSA key
          */
-        PEM_PRIVATE_KEY_RSA,
+        PEM_PRIVATE_KEY_RSA = 1001,
         /**
          * An OpenSSL style PEM file with a private DSA key
          */
-        PEM_PRIVATE_KEY_DSA,
+        PEM_PRIVATE_KEY_DSA = 1002,
         /**
          * An OpenSSL style PEM file with an X.509 certificate
          */
-        PEM_CERTIFICATE_X509,
+        PEM_CERTIFICATE_X509 = 1003,
         /**
          * An OpenSSL style PEM file containing PKCS#7
          */
-        PEM_PKCS7,
+        PEM_PKCS7 = 1004,
         /**
          * Unencrypted OpenSSL style PEM file containing PKCS#8
          */
-        PEM_PKCS8_PLAIN,
+        PEM_PKCS8_PLAIN = 1005,
         /**
          * Encrypted OpenSSL style PEM file containing PKCS#8
          */
-        PEM_PKCS8_ENCRYPTED,
+        PEM_PKCS8_ENCRYPTED = 1006,
         /**
          * An OpenSSL style PEM file containing PKCS#12
          */
-        PEM_PKCS12,
+        PEM_PKCS12 = 1007,
         /**
          * An OpenSSL style PEM file with a private key
          */
-        PEM_PRIVATE_KEY,
+        PEM_PRIVATE_KEY = 1008,
         /**
          * An OpenSSL style PEM file containing PKCS#10
          */
-        PEM_PKCS10,
+        PEM_PKCS10 = 1009,
         /**
          * An OpenSSL style PEM file with a private EC key
          */
-        PEM_PRIVATE_KEY_EC,
+        PEM_PRIVATE_KEY_EC = 1010,
         /**
          * An OpenSSL style PEM file containing a SubjectPublicKeyInfo
          */
-        PEM_PUBLIC_KEY,
+        PEM_PUBLIC_KEY = 1011,
     }
 
 
@@ -244,11 +244,11 @@ export namespace Gcr {
         /**
          * the prompt was cancelled
          */
-        CANCEL,
+        CANCEL = 0,
         /**
          * the user replied with 'ok'
          */
-        CONTINUE,
+        CONTINUE = 1,
     }
 
 
@@ -265,7 +265,7 @@ export namespace Gcr {
         /**
          * another prompt is already in progress
          */
-        SYSTEM_PROMPT_IN_PROGRESS,
+        SYSTEM_PROMPT_IN_PROGRESS = 1,
     }
 
 
@@ -278,62 +278,90 @@ export namespace Gcr {
         /**
          * only one prompt shown at a time
          */
-        SINGLE,
+        SINGLE = 0,
         /**
          * more than one prompt shown at a time
          */
-        MULTIPLE,
+        MULTIPLE = 1,
     }
 
 
+    /**
+     * @default application-certificate
+     */
     const ICON_CERTIFICATE: string;
 
+    /**
+     * @default gcr-gnupg
+     */
     const ICON_GNUPG: string;
 
+    /**
+     * @default user-home
+     */
     const ICON_HOME_DIRECTORY: string;
 
+    /**
+     * @default gcr-key
+     */
     const ICON_KEY: string;
 
+    /**
+     * @default gcr-key-pair
+     */
     const ICON_KEY_PAIR: string;
 
+    /**
+     * @default gcr-password
+     */
     const ICON_PASSWORD: string;
 
+    /**
+     * @default gcr-smart-card
+     */
     const ICON_SMART_CARD: string;
 
     /**
      * The major version number of the Gcr library.
+     * @default 3
      */
     const MAJOR_VERSION: number;
 
     /**
      * The micro version number of the Gcr library.
+     * @default 2
      */
     const MICRO_VERSION: number;
 
     /**
      * The minor version number of the Gcr library.
+     * @default 41
      */
     const MINOR_VERSION: number;
 
     /**
      * The purpose used to verify the client certificate in a TLS connection.
+     * @default 1.3.6.1.5.5.7.3.2
      */
     const PURPOSE_CLIENT_AUTH: string;
 
     /**
      * The purpose used to verify certificate used for the signature on signed code.
+     * @default 1.3.6.1.5.5.7.3.3
      */
     const PURPOSE_CODE_SIGNING: string;
 
     /**
      * The purpose used to verify certificates that are used in email communication
      * such as S/MIME.
+     * @default 1.3.6.1.5.5.7.3.4
      */
     const PURPOSE_EMAIL: string;
 
     /**
      * The purpose used to verify the server certificate in a TLS connection. This
      * is the most common purpose in use.
+     * @default 1.3.6.1.5.5.7.3.1
      */
     const PURPOSE_SERVER_AUTH: string;
 
@@ -341,15 +369,28 @@ export namespace Gcr {
      * The current secret exchange protocol. Key agreement is done using DH with the
      * 1536 bit IKE parameter group. Keys are derived using SHA256 with HKDF. The
      * transport encryption is done with 128 bit AES.
+     * @default sx-aes-1
      */
     const SECRET_EXCHANGE_PROTOCOL_1: string;
 
+    /**
+     * @default always
+     */
     const UNLOCK_OPTION_ALWAYS: string;
 
+    /**
+     * @default idle
+     */
     const UNLOCK_OPTION_IDLE: string;
 
+    /**
+     * @default session
+     */
     const UNLOCK_OPTION_SESSION: string;
 
+    /**
+     * @default timeout
+     */
     const UNLOCK_OPTION_TIMEOUT: string;
 
     /**
@@ -533,6 +574,7 @@ export namespace Gcr {
      * @param module_path the full file path of the PKCS#11 module
      * @param unused unused
      * @returns whether the module was sucessfully added.
+     * @throws GLib.Error
      */
     function pkcs11_add_module_from_file(module_path: string, unused: null): boolean;
 
@@ -588,6 +630,7 @@ export namespace Gcr {
      * Asynchronously initialize the registered PKCS#11 modules.
      * @param cancellable optional cancellable used to cancel the operation
      * @returns whether the operation was successful or not.
+     * @throws GLib.Error
      */
     function pkcs11_initialize(cancellable: Gio.Cancellable | null): boolean;
 
@@ -614,6 +657,7 @@ export namespace Gcr {
      * modules.
      * @param result the asynchronous result
      * @returns whether the operation was successful or not.
+     * @throws GLib.Error
      */
     function pkcs11_initialize_finish(result: Gio.AsyncResult): boolean;
 
@@ -663,6 +707,7 @@ export namespace Gcr {
      * @param peer the peer for this pinned certificate
      * @param cancellable a {@link Gio.Cancellable}
      * @returns `true` if the pinned certificate is recorded successfully
+     * @throws GLib.Error
      */
     function trust_add_pinned_certificate(certificate: Certificate, purpose: string, peer: string, cancellable: Gio.Cancellable | null): boolean;
 
@@ -725,6 +770,7 @@ export namespace Gcr {
      * `gcr_trust_add_pinned_certificate_async()`.
      * @param result the {@link Gio.AsyncResult} passed to the callback
      * @returns `true` if the pinned certificate is recorded successfully
+     * @throws GLib.Error
      */
     function trust_add_pinned_certificate_finish(result: Gio.AsyncResult): boolean;
 
@@ -742,6 +788,7 @@ export namespace Gcr {
      * @param purpose the purpose string
      * @param cancellable a {@link Gio.Cancellable}
      * @returns `true` if the certificate is a trust anchor
+     * @throws GLib.Error
      */
     function trust_is_certificate_anchored(certificate: Certificate, purpose: string, cancellable: Gio.Cancellable | null): boolean;
 
@@ -792,6 +839,7 @@ export namespace Gcr {
      * if an error occurred.
      * @param result the {@link Gio.AsyncResult} passed to the callback
      * @returns `true` if the certificate is a trust anchor
+     * @throws GLib.Error
      */
     function trust_is_certificate_anchored_finish(result: Gio.AsyncResult): boolean;
 
@@ -809,6 +857,7 @@ export namespace Gcr {
      * @param peer the peer for this pinned
      * @param cancellable a {@link Gio.Cancellable}
      * @returns `true` if the certificate is pinned for the host and purpose
+     * @throws GLib.Error
      */
     function trust_is_certificate_pinned(certificate: Certificate, purpose: string, peer: string, cancellable: Gio.Cancellable | null): boolean;
 
@@ -862,6 +911,7 @@ export namespace Gcr {
      * if an error occurred.
      * @param result the {@link Gio.AsyncResult} passed to the callback
      * @returns `true` if the certificate is pinned.
+     * @throws GLib.Error
      */
     function trust_is_certificate_pinned_finish(result: Gio.AsyncResult): boolean;
 
@@ -878,6 +928,7 @@ export namespace Gcr {
      * @param peer the peer for this pinned certificate
      * @param cancellable a {@link Gio.Cancellable}
      * @returns `true` if the pinned certificate no longer exists
+     * @throws GLib.Error
      */
     function trust_remove_pinned_certificate(certificate: Certificate, purpose: string, peer: string, cancellable: Gio.Cancellable | null): boolean;
 
@@ -934,6 +985,7 @@ export namespace Gcr {
      * `gcr_trust_remove_pinned_certificate_async()`.
      * @param result the {@link Gio.AsyncResult} passed to the callback
      * @returns `true` if the pinned certificate no longer exists
+     * @throws GLib.Error
      */
     function trust_remove_pinned_certificate_finish(result: Gio.AsyncResult): boolean;
 
@@ -952,14 +1004,14 @@ export namespace Gcr {
         /**
          * no flags
          */
-        NONE,
+        NONE = 0,
         /**
          * If this flag is specified then no
          * lookups for anchors or pinned certificates are done, and the resulting chain
          * will be neither anchored or pinned. Additionally no missing certificate
          * authorities are looked up in PKCS#11.
          */
-        NO_LOOKUPS,
+        NO_LOOKUPS = 1,
     }
 
 
@@ -967,9 +1019,9 @@ export namespace Gcr {
      * @gir-type Flags
      */
     enum ColumnFlags {
-        NONE,
-        HIDDEN,
-        SORTABLE,
+        NONE = 0,
+        HIDDEN = 2,
+        SORTABLE = 4,
     }
 
 
@@ -1106,6 +1158,7 @@ export namespace Gcr {
          * @param flags chain completion flags
          * @param cancellable a {@link Gio.Cancellable} or `null`
          * @returns whether the operation completed successfully
+         * @throws GLib.Error
          */
         build(purpose: string, peer: string | null, flags: CertificateChainFlags, cancellable: Gio.Cancellable | null): boolean;
 
@@ -1227,6 +1280,7 @@ export namespace Gcr {
          * `gcr_certificate_chain_build_async()`.
          * @param result the {@link Gio.AsyncResult} passed to the callback
          * @returns whether the operation succeeded
+         * @throws GLib.Error
          */
         build_finish(result: Gio.AsyncResult): boolean;
 
@@ -1383,6 +1437,7 @@ export namespace Gcr {
          * This call may block as it signs the request using the private key.
          * @param cancellable a cancellation object
          * @returns whether certificate request was successfully completed or not
+         * @throws GLib.Error
          */
         complete(cancellable: Gio.Cancellable | null): boolean;
 
@@ -1420,6 +1475,7 @@ export namespace Gcr {
          * request.
          * @param result result of the asynchronous operation
          * @returns whether certificate request was successfully completed or not
+         * @throws GLib.Error
          */
         complete_finish(result: Gio.AsyncResult): boolean;
 
@@ -1628,7 +1684,7 @@ export namespace Gcr {
              * @signal
              * @run-last
              */
-            authenticate: (arg0: number) => boolean | void;
+            authenticate: (count: number) => boolean | void;
             /**
              * This signal is emitted when an item is sucessfully parsed. To access
              * the information about the item use the `gcr_parser_get_parsed_label()`,
@@ -1848,6 +1904,7 @@ export namespace Gcr {
          * may fire during the parsing.
          * @param data the data to parse
          * @returns Whether the data was parsed successfully or not.
+         * @throws GLib.Error
          */
         parse_bytes(data: GLib.Bytes | Uint8Array): boolean;
 
@@ -1858,6 +1915,7 @@ export namespace Gcr {
          * A copy of the data will be made. Use `gcr_parser_parse_bytes()` to avoid this.
          * @param data the data to parse
          * @returns Whether the data was parsed successfully or not.
+         * @throws GLib.Error
          */
         parse_data(data: Uint8Array | string): boolean;
 
@@ -1871,6 +1929,7 @@ export namespace Gcr {
          * @param input The input stream
          * @param cancellable An optional cancellation object
          * @returns Whether the parsing completed successfully or not.
+         * @throws GLib.Error
          */
         parse_stream(input: Gio.InputStream, cancellable: Gio.Cancellable | null): boolean;
 
@@ -1913,6 +1972,7 @@ export namespace Gcr {
          * Complete an operation to parse a stream.
          * @param result The operation result
          * @returns Whether the parsing completed successfully or not.
+         * @throws GLib.Error
          */
         parse_stream_finish(result: Gio.AsyncResult): boolean;
 
@@ -3228,6 +3288,7 @@ export namespace Gcr {
          * still closed and may not be further used.
          * @param cancellable an optional cancellation object
          * @returns whether close was cleanly completed
+         * @throws GLib.Error
          */
         close(cancellable: Gio.Cancellable | null): boolean;
 
@@ -3276,6 +3337,7 @@ export namespace Gcr {
          * still closed and may not be further used.
          * @param result asynchronous operation result
          * @returns whether close was cleanly completed
+         * @throws GLib.Error
          */
         close_finish(result: Gio.AsyncResult): boolean;
 
@@ -3504,6 +3566,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm(cancellable: Gio.Cancellable | null): PromptReply;
 
@@ -3547,6 +3610,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param result asynchronous result passed to callback
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm_finish(result: Gio.AsyncResult): PromptReply;
 
@@ -3564,6 +3628,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm_run(cancellable: Gio.Cancellable | null): PromptReply;
 
@@ -3684,6 +3749,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password(cancellable: Gio.Cancellable | null): string;
 
@@ -3727,6 +3793,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param result asynchronous result passed to callback
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password_finish(result: Gio.AsyncResult): string;
 
@@ -3746,6 +3813,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password_run(cancellable: Gio.Cancellable | null): string;
 
@@ -3945,6 +4013,7 @@ export namespace Gcr {
          * any interface methods.
          * @param io_priority the [I/O priority](iface.AsyncResult.html#io-priority) of the operation
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @since 2.22
          */
         init_async(io_priority: number, cancellable: Gio.Cancellable | null): globalThis.Promise<boolean>;
 
@@ -3988,6 +4057,7 @@ export namespace Gcr {
          * @param io_priority the [I/O priority](iface.AsyncResult.html#io-priority) of the operation
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied
+         * @since 2.22
          */
         init_async(io_priority: number, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
 
@@ -4031,6 +4101,7 @@ export namespace Gcr {
          * @param io_priority the [I/O priority](iface.AsyncResult.html#io-priority) of the operation
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied
+         * @since 2.22
          */
         init_async(io_priority: number, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<boolean> | void;
 
@@ -4039,6 +4110,8 @@ export namespace Gcr {
          * See `g_async_initable_init_async()`.
          * @param res a {@link Gio.AsyncResult}.
          * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
+         * @since 2.22
+         * @throws GLib.Error
          */
         init_finish(res: Gio.AsyncResult): boolean;
 
@@ -4047,6 +4120,8 @@ export namespace Gcr {
          * calls, returning the created object or `null` on error.
          * @param res the {@link Gio.AsyncResult} from the callback
          * @returns a newly created {@link GObject.Object},      or `null` on error. Free with `g_object_unref()`.
+         * @since 2.22
+         * @throws GLib.Error
          */
         new_finish(res: Gio.AsyncResult): SystemPrompt;
 
@@ -4090,6 +4165,7 @@ export namespace Gcr {
          * @param io_priority the [I/O priority](iface.AsyncResult.html#io-priority) of the operation
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied
+         * @since 2.22
          * @virtual
          */
         vfunc_init_async(io_priority: number, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
@@ -4098,6 +4174,7 @@ export namespace Gcr {
          * Finishes asynchronous initialization and returns the result.
          * See `g_async_initable_init_async()`.
          * @param res a {@link Gio.AsyncResult}.
+         * @since 2.22
          * @virtual
          */
         vfunc_init_finish(res: Gio.AsyncResult): boolean;
@@ -4143,6 +4220,8 @@ export namespace Gcr {
          * instance.
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
          * @returns `true` if successful. If an error has occurred, this function will     return `false` and set `error` appropriately if present.
+         * @since 2.22
+         * @throws GLib.Error
          */
         init(cancellable: Gio.Cancellable | null): boolean;
 
@@ -4186,6 +4265,7 @@ export namespace Gcr {
          * on the result of `g_object_new()`, regardless of whether it is in fact a new
          * instance.
          * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @since 2.22
          * @virtual
          */
         vfunc_init(cancellable: Gio.Cancellable | null): boolean;
@@ -5295,6 +5375,7 @@ export namespace Gcr {
          * @param builder supplemented attributes
          * @param cancellable optional cancellable object
          * @returns {@link Gio.TlsInteractionResult.HANDLED} if successful or {@link Gio.TlsInteractionResult.FAILED}
+         * @throws GLib.Error
          */
         supplement(builder: Gck.Builder, cancellable: Gio.Cancellable | null): Gio.TlsInteractionResult;
 
@@ -5340,6 +5421,7 @@ export namespace Gcr {
          * with {@link Gio.IOErrorEnum.CANCELLED}.
          * @param result the asynchronous result
          * @returns {@link Gio.TlsInteractionResult.HANDLED} if successful or {@link Gio.TlsInteractionResult.FAILED}
+         * @throws GLib.Error
          */
         supplement_finish(result: Gio.AsyncResult): Gio.TlsInteractionResult;
 
@@ -5507,6 +5589,7 @@ export namespace Gcr {
          * until the operation completes.
          * @param cancellable a {@link Gio.Cancellable}, or `null`
          * @returns whether the items were imported successfully or not
+         * @throws GLib.Error
          */
         ["import"](cancellable: Gio.Cancellable | null): boolean;
 
@@ -5537,6 +5620,7 @@ export namespace Gcr {
          * Complete an asynchronous operation to import queued items.
          * @param result an asynchronous result
          * @returns whether the import succeeded or failed
+         * @throws GLib.Error
          */
         import_finish(result: Gio.AsyncResult): boolean;
 
@@ -5891,6 +5975,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm(cancellable: Gio.Cancellable | null): PromptReply;
 
@@ -5934,6 +6019,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param result asynchronous result passed to callback
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm_finish(result: Gio.AsyncResult): PromptReply;
 
@@ -5951,6 +6037,7 @@ export namespace Gcr {
          * an error occurs. Check the `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the reply from the prompt
+         * @throws GLib.Error
          */
         confirm_run(cancellable: Gio.Cancellable | null): PromptReply;
 
@@ -6071,6 +6158,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password(cancellable: Gio.Cancellable | null): string;
 
@@ -6114,6 +6202,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param result asynchronous result passed to callback
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password_finish(result: Gio.AsyncResult): string;
 
@@ -6133,6 +6222,7 @@ export namespace Gcr {
          * `error` argument to tell the difference.
          * @param cancellable optional cancellation object
          * @returns the password owned by the prompt, or `null`
+         * @throws GLib.Error
          */
         password_run(cancellable: Gio.Cancellable | null): string;
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/gcr-3",
-    "version": "4.3.0",
+    "version": "4.5.0",
     "libraryVersion": "3.41.2",
     "description": "GJS TypeScript type definitions for Gcr-3, generated from library version 3.41.2",
     "type": "module",
@@ -32,12 +32,12 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.3.0",
-      "@girs/gio-2.0": "^4.3.0",
-      "@girs/gobject-2.0": "^4.3.0",
-      "@girs/glib-2.0": "^4.3.0",
-      "@girs/gmodule-2.0": "^4.3.0",
-      "@girs/gck-1": "^4.3.0"    },
+      "@girs/gjs": "^4.5.0",
+      "@girs/gio-2.0": "^4.5.0",
+      "@girs/gobject-2.0": "^4.5.0",
+      "@girs/glib-2.0": "^4.5.0",
+      "@girs/gmodule-2.0": "^4.5.0",
+      "@girs/gck-1": "^4.5.0"    },
     "devDependencies": {
       "typescript": "*"
     },