@girs/gcr-4 4.4.0-4.0.4 → 4.5.0

package/README.md

@@ -4,82 +4,77 @@
 ![version](https://img.shields.io/npm/v/@girs/gcr-4)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gcr-4)
 
+GJS TypeScript type definitions for Gcr-4, generated from library version 4.4.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.5.0.
 
-GJS TypeScript type definitions for Gcr-4, generated from library version 4.4.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.4.
+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
 
-To use this type definitions, install them with NPM:
 ```bash
 npm install @girs/gcr-4
 ```
 
-## Usage
+Any package manager works. The package has no dependencies beyond other `@girs/*`
+type packages.
+
+## What it exports
+
+| Import | What you get |
+|---|---|
+| `@girs/gcr-4` | the namespace as a default export, plus the ambient and global declarations |
+| `@girs/gcr-4/ambient` | only the `gi://` module declarations |
+| `@girs/gcr-4/import` | only the `imports.gi` declarations |
+| `@girs/gcr-4/gcr-4` | 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
 
-You can import this package into your project like this:
 ```ts
 import Gcr from '@girs/gcr-4';
 ```
 
-### Ambient Modules
+### As `gi://`
 
-You can also use [ambient modules](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules) to import this module like you would do this in JavaScript.
-For this you need to include `@girs/gcr-4` or `@girs/gcr-4/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-4'
+import '@girs/gcr-4';
 ```
 
-`tsconfig.json`:
 ```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gcr-4"],
-  ...
-}
+{ "include": ["@girs/gcr-4"] }
 ```
 
-Now you can import the ambient module with TypeScript support: 
+Then the runtime spelling type-checks:
 
 ```ts
 import Gcr from 'gi://Gcr?version=4';
 ```
 
-### Global import
-
-You can also import the module with Typescript support using the global `imports.gi` object of GJS.
-For this you need to include `@girs/gcr-4` or `@girs/gcr-4/import` in your `tsconfig` or entry point Typescript file:
+Referencing `@girs/gcr-4/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-4'
-```
-
-`tsconfig.json`:
-```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/gcr-4"],
-  ...
-}
-```
+### As `imports.gi`
 
-Now you have also type support for this, too:
+GJS's global object works the same way, via `@girs/gcr-4/import`:
 
 ```ts
 const Gcr = imports.gi.Gcr;
 ```
 
-### Bundle
+## Building
 
-Depending on your project configuration, it is recommended to use a bundler like [esbuild](https://esbuild.github.io/). You can find examples using different bundlers [here](https://github.com/gjsify/ts-for-gir/tree/main/examples).
+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-4.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,48 +278,55 @@ export namespace Gcr {
         /**
          * only one prompt shown at a time
          */
-        SINGLE,
+        SINGLE = 0,
         /**
          * more than one prompt shown at a time
          */
-        MULTIPLE,
+        MULTIPLE = 1,
     }
 
 
     /**
      * The major version number of the Gcr library.
+     * @default 4
      */
     const MAJOR_VERSION: number;
 
     /**
      * The micro version number of the Gcr library.
+     * @default 0
      */
     const MICRO_VERSION: number;
 
     /**
      * The minor version number of the Gcr library.
+     * @default 4
      */
     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;
 
@@ -327,15 +334,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;
 
     function data_error_get_domain(): GLib.Quark;
@@ -498,6 +518,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;
 
@@ -551,6 +572,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;
 
@@ -577,6 +599,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;
 
@@ -626,6 +649,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;
 
@@ -688,6 +712,7 @@ export namespace Gcr {
      * {@link 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;
 
@@ -705,6 +730,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;
 
@@ -758,6 +784,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;
 
@@ -773,6 +800,7 @@ export namespace Gcr {
      * @param issuer The raw issuer
      * @param cancellable a {@link Gio.Cancellable} or `null`
      * @returns `true` if the certificate is marked as distrusted
+     * @throws GLib.Error
      */
     function trust_is_certificate_distrusted(serial_nr: Uint8Array | string, issuer: Uint8Array | string, cancellable: Gio.Cancellable | null): boolean;
 
@@ -838,6 +866,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_distrusted_finish(result: Gio.AsyncResult): boolean;
 
@@ -855,6 +884,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;
 
@@ -908,6 +938,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;
 
@@ -924,6 +955,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;
 
@@ -980,6 +1012,7 @@ export namespace Gcr {
      * {@link 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;
 
@@ -991,14 +1024,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,
     }
 
 
@@ -1006,8 +1039,8 @@ export namespace Gcr {
      * @gir-type Flags
      */
     enum CertificateSectionFlags {
-        NONE,
-        IMPORTANT,
+        NONE = 0,
+        IMPORTANT = 1,
     }
 
 
@@ -1212,6 +1245,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;
 
@@ -1333,6 +1367,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;
 
@@ -1468,17 +1503,20 @@ export namespace Gcr {
          * Returns a user-displayable description of the OID that identifies the
          * extension, if known.
          * @returns A user-facing description, or `null` if   unknown
+         * @since 4.3.90
          */
         get_description(): string | null;
 
         /**
          * Returns the OID that identifies the extension
+         * @since 4.3.90
          */
         get_oid(): string;
 
         /**
          * Returns the raw value in bytes of the extension.
          * @returns The raw value date
+         * @since 4.3.90
          */
         get_value(): GLib.Bytes;
 
@@ -1587,6 +1625,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -1597,6 +1636,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -1615,6 +1655,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -1642,6 +1683,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -1654,6 +1696,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -1667,6 +1710,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -1677,6 +1721,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -1915,6 +1960,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -1925,6 +1971,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -1943,6 +1990,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -1970,6 +2018,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -1982,6 +2031,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -1995,6 +2045,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2005,6 +2056,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -2100,6 +2152,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -2110,6 +2163,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -2128,6 +2182,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -2155,6 +2210,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -2167,6 +2223,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -2180,6 +2237,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2190,6 +2248,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -2393,6 +2452,7 @@ export namespace Gcr {
          * Looks for an extension with the given OID.
          * @param oid The OID of the certificate extension
          * @returns The certificate extension with  the given OID, or `null` if not found.
+         * @since 4.3.90
          */
         find_by_oid(oid: string): CertificateExtension | null;
 
@@ -2415,6 +2475,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -2425,6 +2486,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -2443,6 +2505,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -2470,6 +2533,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -2482,6 +2546,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -2495,6 +2560,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2505,6 +2571,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -2581,6 +2648,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -2591,6 +2659,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -2609,6 +2678,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -2636,6 +2706,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -2648,6 +2719,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -2661,6 +2733,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2671,6 +2744,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -2901,6 +2975,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -2911,6 +2986,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -2929,6 +3005,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -2956,6 +3033,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -2968,6 +3046,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -2981,6 +3060,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -2991,6 +3071,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -3164,6 +3245,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;
 
@@ -3201,6 +3283,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;
 
@@ -3514,6 +3597,7 @@ export namespace Gcr {
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
          * @returns the {@link GObject.GType} of the items contained in `list`.
+         * @since 2.44
          */
         get_item_type(): GObject.GType;
 
@@ -3524,6 +3608,7 @@ export namespace Gcr {
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
          * @returns the number of items in `list`.
+         * @since 2.44
          */
         get_n_items(): number;
 
@@ -3542,6 +3627,7 @@ export namespace Gcr {
          * See also: `g_list_model_get_n_items()`
          * @param position the position of the item to fetch
          * @returns the object at `position`.
+         * @since 2.44
          */
         get_item(position: number): A | null;
 
@@ -3569,6 +3655,7 @@ export namespace Gcr {
          * @param position the position at which `list` changed
          * @param removed the number of items removed
          * @param added the number of items added
+         * @since 2.44
          */
         items_changed(position: number, removed: number, added: number): void;
 
@@ -3581,6 +3668,7 @@ export namespace Gcr {
          * 
          * The same {@link GObject.Object} instance may not appear more than once in a {@link Gio.ListModel}.
          * @param position the position of the item to fetch
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item(position: number): A | null;
@@ -3594,6 +3682,7 @@ export namespace Gcr {
          * 
          * The item type of a {@link Gio.ListModel} can not change during the life of the
          * model.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_item_type(): GObject.GType;
@@ -3604,6 +3693,7 @@ export namespace Gcr {
          * Depending on the model implementation, calling this function may be
          * less efficient than iterating the list with increasing values for
          * `position` until `g_list_model_get_item()` returns `null`.
+         * @since 2.44
          * @virtual
          */
         vfunc_get_n_items(): number;
@@ -3628,7 +3718,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()`,
@@ -3849,6 +3939,7 @@ export namespace Gcr {
          * `Gcr.Parser::authenticate` signals 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;
 
@@ -3860,6 +3951,7 @@ export namespace Gcr {
          * 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;
 
@@ -3873,6 +3965,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;
 
@@ -3915,6 +4008,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;
 
@@ -4335,6 +4429,7 @@ export namespace Gcr {
          * Creates a {@link CertificateExtensionList} that can be used to inspect the
          * extensions of this certificate.
          * @returns The certificate's extensions
+         * @since 4.3.90
          */
         list_extensions(): CertificateExtensionList;
 
@@ -4846,6 +4941,7 @@ export namespace Gcr {
          * Creates a {@link CertificateExtensionList} that can be used to inspect the
          * extensions of this certificate.
          * @returns The certificate's extensions
+         * @since 4.3.90
          */
         list_extensions(): CertificateExtensionList;
 
@@ -5140,6 +5236,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;
 
@@ -5188,6 +5285,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;
 
@@ -5416,6 +5514,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;
 
@@ -5459,6 +5558,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;
 
@@ -5476,6 +5576,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;
 
@@ -5596,6 +5697,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;
 
@@ -5639,6 +5741,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;
 
@@ -5658,6 +5761,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;
 
@@ -5857,6 +5961,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>;
 
@@ -5900,6 +6005,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;
 
@@ -5943,6 +6049,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;
 
@@ -5951,6 +6058,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;
 
@@ -5959,6 +6068,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;
 
@@ -6002,6 +6113,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;
@@ -6010,6 +6122,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;
@@ -6055,6 +6168,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;
 
@@ -6098,6 +6213,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;
@@ -6873,6 +6989,7 @@ export namespace Gcr {
          * Creates a {@link CertificateExtensionList} that can be used to inspect the
          * extensions of this certificate.
          * @returns The certificate's extensions
+         * @since 4.3.90
          */
         list_extensions(): CertificateExtensionList;
 
@@ -6976,6 +7093,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;
 
@@ -7021,6 +7139,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;
 
@@ -7195,6 +7314,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;
 
@@ -7549,6 +7669,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;
 
@@ -7592,6 +7713,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;
 
@@ -7609,6 +7731,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;
 
@@ -7729,6 +7852,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;
 
@@ -7772,6 +7896,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;
 
@@ -7791,6 +7916,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,7 @@
 {
     "name": "@girs/gcr-4",
-    "version": "4.4.0-4.0.4",
+    "version": "4.5.0",
+    "libraryVersion": "4.4.0",
     "description": "GJS TypeScript type definitions for Gcr-4, generated from library version 4.4.0",
     "type": "module",
     "module": "gcr-4.js",
@@ -31,12 +32,12 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "4.0.4",
-      "@girs/gio-2.0": "2.88.0-4.0.4",
-      "@girs/gobject-2.0": "2.88.0-4.0.4",
-      "@girs/glib-2.0": "2.88.0-4.0.4",
-      "@girs/gmodule-2.0": "2.0.0-4.0.4",
-      "@girs/gck-2": "4.4.0-4.0.4"    },
+      "@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-2": "^4.5.0"    },
     "devDependencies": {
       "typescript": "*"
     },