@girs/arrowflight-23.0 4.4.0 → 4.6.0

package/README.md

@@ -4,82 +4,77 @@
 ![version](https://img.shields.io/npm/v/@girs/arrowflight-23.0)
 ![downloads/week](https://img.shields.io/npm/dw/@girs/arrowflight-23.0)
 
+GJS TypeScript type definitions for ArrowFlight-23.0, generated from library version 23.0.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.6.0.
 
-GJS TypeScript type definitions for ArrowFlight-23.0, generated from library version 23.0.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.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/arrowflight-23.0
 ```
 
-## Usage
+Any package manager works. The package has no dependencies beyond other `@girs/*`
+type packages.
+
+## What it exports
+
+| Import | What you get |
+|---|---|
+| `@girs/arrowflight-23.0` | the namespace as a default export, plus the ambient and global declarations |
+| `@girs/arrowflight-23.0/ambient` | only the `gi://` module declarations |
+| `@girs/arrowflight-23.0/import` | only the `imports.gi` declarations |
+| `@girs/arrowflight-23.0/arrowflight-23.0` | 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 ArrowFlight from '@girs/arrowflight-23.0';
 ```
 
-### 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/arrowflight-23.0` or `@girs/arrowflight-23.0/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/arrowflight-23.0'
+import '@girs/arrowflight-23.0';
 ```
 
-`tsconfig.json`:
 ```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/arrowflight-23.0"],
-  ...
-}
+{ "include": ["@girs/arrowflight-23.0"] }
 ```
 
-The ambient module now resolves with types:
+Then the runtime spelling type-checks:
 
 ```ts
 import ArrowFlight from 'gi://ArrowFlight?version=23.0';
 ```
 
-### Global import
-
-GJS's global `imports.gi` works too, with types.
-For this you need to include `@girs/arrowflight-23.0` or `@girs/arrowflight-23.0/import` in your `tsconfig` or entry point Typescript file:
+Referencing `@girs/arrowflight-23.0/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/arrowflight-23.0'
-```
-
-`tsconfig.json`:
-```json
-{
-  "compilerOptions": {
-    ...
-  },
-  "include": ["@girs/arrowflight-23.0"],
-  ...
-}
-```
+### As `imports.gi`
 
-That form carries types as well:
+GJS's global object works the same way, via `@girs/arrowflight-23.0/import`:
 
 ```ts
 const ArrowFlight = imports.gi.ArrowFlight;
 ```
 
-### 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/arrowflight-23.0.d.ts

@@ -27,18 +27,21 @@ export namespace ArrowFlight {
     /**
      * The major version.
      * @since 17.0.0
+     * @default 23
      */
     const VERSION_MAJOR: number;
 
     /**
      * The micro version.
      * @since 17.0.0
+     * @default 1
      */
     const VERSION_MICRO: number;
 
     /**
      * The minor version.
      * @since 17.0.0
+     * @default 0
      */
     const VERSION_MINOR: number;
 
@@ -199,12 +202,14 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.CallOptions}.
          * @returns `true` on success, `false` if there was an error.
          * @since 12.0.0
+         * @throws GLib.Error
          */
         authenticate_basic_token(user: string, password: string, options: CallOptions | null): [boolean, string, string];
 
         /**
          * @returns `true` on success, `false` if there was an error.
          * @since 8.0.0
+         * @throws GLib.Error
          */
         close(): boolean;
 
@@ -213,6 +218,7 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.CallOptions}.
          * @returns The {@link ArrowFlight.StreamReader} to read record batched from the server   on success, `null` on error.
          * @since 6.0.0
+         * @throws GLib.Error
          */
         do_get(ticket: Ticket, options: CallOptions | null): StreamReader | null;
 
@@ -229,6 +235,7 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.CallOptions}.
          * @returns The `GAFlighDoPutResult` holding a reader and a writer on success,   `null` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         do_put(descriptor: Descriptor, schema: Arrow.Schema, options: CallOptions | null): DoPutResult | null;
 
@@ -237,6 +244,7 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.CallOptions}.
          * @returns The returned {@link ArrowFlight.Info} on   success, `null` on error.
          * @since 9.0.0
+         * @throws GLib.Error
          */
         get_flight_info(descriptor: Descriptor, options: CallOptions | null): Info | null;
 
@@ -245,6 +253,7 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.CallOptions}.
          * @returns The returned list of {@link ArrowFlight.Info} on success, `null` on error.
          * @since 5.0.0
+         * @throws GLib.Error
          */
         list_flights(criteria: Criteria | null, options: CallOptions | null): Info[] | null;
     }
@@ -866,6 +875,7 @@ export namespace ArrowFlight {
          * @param options A {@link Arrow.ReadOptions}.
          * @returns Deserialized {@link Arrow.Schema}, `null` on error.
          * @since 5.0.0
+         * @throws GLib.Error
          */
         get_schema(options: Arrow.ReadOptions | null): Arrow.Schema;
 
@@ -1056,6 +1066,7 @@ export namespace ArrowFlight {
         /**
          * @returns The metadata on success, `null` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         read(): Arrow.Buffer;
     }
@@ -1118,6 +1129,7 @@ export namespace ArrowFlight {
          * @param metadata A {@link Arrow.Buffer} to be sent.
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         write(metadata: Arrow.Buffer): boolean;
     }
@@ -1247,12 +1259,14 @@ export namespace ArrowFlight {
         /**
          * @returns The all data on success, `null` on error.
          * @since 6.0.0
+         * @throws GLib.Error
          */
         read_all(): Arrow.Table;
 
         /**
          * @returns The next chunk on success, `null` on end   of stream, `null` on error.
          * @since 6.0.0
+         * @throws GLib.Error
          */
         read_next(): StreamChunk;
     }
@@ -1367,6 +1381,7 @@ export namespace ArrowFlight {
          * @param options A {@link Arrow.WriteOptions}.
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         begin(schema: Arrow.Schema, options: Arrow.WriteOptions | null): boolean;
 
@@ -1375,6 +1390,7 @@ export namespace ArrowFlight {
          * @param metadata A {@link Arrow.Buffer}.
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         write_metadata(metadata: Arrow.Buffer): boolean;
 
@@ -1384,6 +1400,7 @@ export namespace ArrowFlight {
          * @param metadata A {@link Arrow.Buffer}.
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         write_record_batch(record_batch: Arrow.RecordBatch, metadata: Arrow.Buffer | null): boolean;
 
@@ -1479,6 +1496,7 @@ export namespace ArrowFlight {
          * @param ticket A {@link ArrowFlight.Ticket}.
          * @returns {@link ArrowFlight.DataStream} on success, `null` on error.
          * @since 6.0.0
+         * @throws GLib.Error
          */
         do_get(context: ServerCallContext, ticket: Ticket): DataStream;
 
@@ -1489,6 +1507,7 @@ export namespace ArrowFlight {
          * @param writer A {@link ArrowFlight.MetadataWriter}.
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         do_put(context: ServerCallContext, reader: MessageReader, writer: MetadataWriter): boolean;
 
@@ -1497,6 +1516,7 @@ export namespace ArrowFlight {
          * @param request A {@link ArrowFlight.Descriptor}.
          * @returns A {@link ArrowFlight.Info} on success, `null` on error.
          * @since 9.0.0
+         * @throws GLib.Error
          */
         get_flight_info(context: ServerCallContext, request: Descriptor): Info;
 
@@ -1507,6 +1527,7 @@ export namespace ArrowFlight {
          * @param criteria A {@link ArrowFlight.Criteria}.
          * @returns {@link GLib.List} of {@link ArrowFlight.Info} on success, `null` on error.
          * @since 5.0.0
+         * @throws GLib.Error
          */
         list_flights(context: ServerCallContext, criteria: Criteria | null): Info[];
 
@@ -1514,6 +1535,7 @@ export namespace ArrowFlight {
          * @param options A {@link ArrowFlight.ServerOptions}.
          * @returns `true` on success, `false` on error.
          * @since 5.0.0
+         * @throws GLib.Error
          */
         listen(options: ServerOptions): boolean;
 
@@ -1522,9 +1544,13 @@ export namespace ArrowFlight {
          * handler or another thread.
          * @returns `true` on success, `false` on error.
          * @since 5.0.0
+         * @throws GLib.Error
          */
         shutdown(): boolean;
 
+        /**
+         * @throws GLib.Error
+         */
         wait(): boolean;
     }
 
@@ -1638,6 +1664,7 @@ export namespace ArrowFlight {
          * Reads a message from the client.
          * @returns Read data as {@link GLib.Bytes} on   success, `null` on error.
          * @since 12.0.0
+         * @throws GLib.Error
          */
         read(): GLib.Bytes | null;
     }
@@ -1700,6 +1727,7 @@ export namespace ArrowFlight {
          * @param message A {@link GLib.Bytes} to be sent.
          * @returns `true` on success, `false` on error.
          * @since 12.0.0
+         * @throws GLib.Error
          */
         write(message: GLib.Bytes | Uint8Array): boolean;
     }
@@ -1844,6 +1872,7 @@ export namespace ArrowFlight {
          * @param sender A {@link ArrowFlight.ServerAuthSender}.
          * @param reader A {@link ArrowFlight.ServerAuthReader}.
          * @since 12.0.0
+         * @throws GLib.Error
          */
         authenticate(context: ServerCallContext, sender: ServerAuthSender, reader: ServerAuthReader): void;
 
@@ -1853,6 +1882,7 @@ export namespace ArrowFlight {
          * @param token The client token. May be the empty string if the client does not   provide a token.
          * @returns The identity of the peer, if   this authentication method supports it.
          * @since 12.0.0
+         * @throws GLib.Error
          */
         is_valid(context: ServerCallContext, token: GLib.Bytes | Uint8Array): GLib.Bytes | null;
     }
@@ -2097,6 +2127,7 @@ export namespace ArrowFlight {
         /**
          * @returns `true` on success, `false` on error.
          * @since 18.0.0
+         * @throws GLib.Error
          */
         done_writing(): boolean;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@girs/arrowflight-23.0",
-    "version": "4.4.0",
+    "version": "4.6.0",
     "libraryVersion": "23.0.1",
     "description": "GJS TypeScript type definitions for ArrowFlight-23.0, generated from library version 23.0.1",
     "type": "module",
@@ -32,12 +32,12 @@
       "test": "tsc --project tsconfig.json"
     },
     "dependencies": {
-      "@girs/gjs": "^4.4.0",
-      "@girs/arrow-23.0": "^4.4.0",
-      "@girs/gio-2.0": "^4.4.0",
-      "@girs/gobject-2.0": "^4.4.0",
-      "@girs/glib-2.0": "^4.4.0",
-      "@girs/gmodule-2.0": "^4.4.0"    },
+      "@girs/gjs": "^4.6.0",
+      "@girs/arrow-23.0": "^4.6.0",
+      "@girs/gio-2.0": "^4.6.0",
+      "@girs/gobject-2.0": "^4.6.0",
+      "@girs/glib-2.0": "^4.6.0",
+      "@girs/gmodule-2.0": "^4.6.0"    },
     "devDependencies": {
       "typescript": "*"
     },