Merge pull request #61 from gleanwork/speakeasy-sdk-regen-1759249969

chore: 🐝 Update SDK - Generate 0.11.0

Author: rwjblue-glean

.devcontainer/setup.sh

@@ -7,8 +7,8 @@ curl -fsSL https://raw.githubusercontent.com/speakeasy-api/speakeasy/main/instal
 rmdir samples || true
 mkdir samples
 
-npm install
-npm install -g ts-node
+npm install --ignore-scripts
+npm install -g ts-node --ignore-scripts
 npm link
 npm link @gleanwork/api-client
 TS_CONFIG_CONTENT=$(cat <<EOL

.speakeasy/gen.lock

@@ -19,13 +19,15 @@ generation:
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
+    hoistGlobalSecurity: true
   mockServer:
     disabled: false
   tests:
+    generateTests: true
     generateNewTests: true
     skipResponseBodyAssertions: true
 typescript:
-  version: 0.10.5
+  version: 0.11.0
   additionalDependencies:
     dependencies: {}
     devDependencies: {}

.speakeasy/gen.yaml

@@ -3799,6 +3799,7 @@ components:
                         - SEARCH
                         - SIDEBAR
                         - SUMMARY
+                        - TASKS
                 issue:
                     type: string
                     description: The issue the user indicated in the feedback.

.speakeasy/glean-merged-spec.yaml

@@ -1,12 +1,12 @@
-speakeasyVersion: 1.551.0
+speakeasyVersion: 1.631.5
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8e30ec07a1e4d68c15f8d788704ddf4230cba6443cfebd960477c45f6ad3f563
-        sourceBlobDigest: sha256:3c8246030e43ada387eaa07c5ddce8c7710d35f8c519057ce7d1541a3dd8aef2
+        sourceRevisionDigest: sha256:e26b15f8d8e3781ac9b2d0167bcbdf95ac01a876716fdda482dce7e2d1f7ee1d
+        sourceBlobDigest: sha256:caf2a61beb1f621f4c17121eb19113bddbda574eec8bf3a3e9e9be902e7adeaa
         tags:
             - latest
-            - speakeasy-sdk-regen-1759193224
+            - speakeasy-sdk-regen-1759249969
     Glean Client API:
         sourceNamespace: glean-client-api
         sourceRevisionDigest: sha256:aec0770b5bcca91068c3a844cb9ef4a091281f6cc3b7d86f2abef1bd6fb2b301
@@ -18,10 +18,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8e30ec07a1e4d68c15f8d788704ddf4230cba6443cfebd960477c45f6ad3f563
-        sourceBlobDigest: sha256:3c8246030e43ada387eaa07c5ddce8c7710d35f8c519057ce7d1541a3dd8aef2
+        sourceRevisionDigest: sha256:e26b15f8d8e3781ac9b2d0167bcbdf95ac01a876716fdda482dce7e2d1f7ee1d
+        sourceBlobDigest: sha256:caf2a61beb1f621f4c17121eb19113bddbda574eec8bf3a3e9e9be902e7adeaa
         codeSamplesNamespace: glean-api-specs-typescript-code-samples
-        codeSamplesRevisionDigest: sha256:89dfb1843dba80ceb447d1956c4bb0f75ea348c3f70073a8187b3593c60e7a33
+        codeSamplesRevisionDigest: sha256:08435f3ef18a9ebd9eda58790384d9de8ed996b42ca679494f95bb92c019058d
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -21,7 +21,6 @@ specific category of applications.
 ```typescript
 import { GleanCore } from "@gleanwork/api-client/core.js";
 import { clientChatCreate } from "@gleanwork/api-client/funcs/clientChatCreate.js";
-import { SDKValidationError } from "@gleanwork/api-client/models/errors/sdkvalidationerror.js";
 
 // Use `GleanCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
@@ -41,28 +40,12 @@ async function run() {
       },
     ],
   });
-
-  switch (true) {
-    case res.ok:
-      // The success case will be handled outside of the switch block
-      break;
-    case res.error instanceof SDKValidationError:
-      // Pretty-print validation errors.
-      return console.log(res.error.pretty());
-    case res.error instanceof Error:
-      return console.log(res.error);
-    default:
-      // TypeScript's type checking will fail on the following line if the above
-      // cases were not exhaustive.
-      res.error satisfies never;
-      throw new Error("Assertion failed: expected error checks to be exhaustive: " + res.error);
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("clientChatCreate failed:", res.error);
   }
-
-
-  const { value: result } = res;
-
-  // Handle the result
-  console.log(result);
 }
 
 run();

FUNCTIONS.md

@@ -70,6 +70,7 @@ These API clients provide type-safe, idiomatic interfaces for working with Glean
   * [Available Resources and Operations](#available-resources-and-operations)
   * [Standalone functions](#standalone-functions)
   * [React hooks with TanStack Query](#react-hooks-with-tanstack-query)
+  * [File uploads](#file-uploads)
   * [Retries](#retries)
   * [Error Handling](#error-handling)
   * [Server Selection](#server-selection)
@@ -113,12 +114,9 @@ bun add @tanstack/react-query react react-dom
 ### Yarn
 
 ```bash
-yarn add @gleanwork/api-client zod
+yarn add @gleanwork/api-client
 # Install optional peer dependencies if you plan to use React hooks
 yarn add @tanstack/react-query react react-dom
-
-# Note that Yarn does not install peer dependencies automatically. You will need
-# to install zod as shown above.
 ```
 
 > [!NOTE]
@@ -156,7 +154,6 @@ async function run() {
     ],
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -186,7 +183,6 @@ async function run() {
     ],
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -353,10 +349,6 @@ For more information on obtaining the appropriate token type, please contact you
 * [list](docs/sdks/entities/README.md#list) - List entities
 * [readPeople](docs/sdks/entities/README.md#readpeople) - Read people
 
-
-#### [client.governance.data](docs/sdks/data/README.md)
-
-
 #### [client.governance.data.policies](docs/sdks/policies/README.md)
 
 * [retrieve](docs/sdks/policies/README.md#retrieve) - Gets specified policy
@@ -371,9 +363,6 @@ For more information on obtaining the appropriate token type, please contact you
 * [download](docs/sdks/reports/README.md#download) - Downloads violations CSV for report
 * [status](docs/sdks/reports/README.md#status) - Fetches report run status
 
-#### [client.governance.documents](docs/sdks/governancedocuments/README.md)
-
-
 #### [client.governance.documents.visibilityoverrides](docs/sdks/visibilityoverrides/README.md)
 
 * [list](docs/sdks/visibilityoverrides/README.md#list) - Fetches documents visibility
@@ -762,6 +751,43 @@ To learn about this feature and how to get started, check
 </details>
 <!-- End React hooks with TanStack Query [react-query] -->
 
+<!-- Start File uploads [file-upload] -->
+## File uploads
+
+Certain SDK methods accept files as part of a multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
+
+> [!TIP]
+>
+> Depending on your JavaScript runtime, there are convenient utilities that return a handle to a file without reading the entire contents into memory:
+>
+> - **Node.js v20+:** Since v20, Node.js comes with a native `openAsBlob` function in [`node:fs`](https://nodejs.org/docs/latest-v20.x/api/fs.html#fsopenasblobpath-options).
+> - **Bun:** The native [`Bun.file`](https://bun.sh/docs/api/file-io#reading-files-bun-file) function produces a file handle that can be used for streaming file uploads.
+> - **Browsers:** All supported browsers return an instance to a [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File) when reading the value from an `<input type="file">` element.
+> - **Node.js v18:** A file stream can be created using the `fileFrom` helper from [`fetch-blob/from.js`](https://www.npmjs.com/package/fetch-blob).
+
+```typescript
+import { Glean } from "@gleanwork/api-client";
+import { openAsBlob } from "node:fs";
+
+const glean = new Glean({
+  apiToken: process.env["GLEAN_API_TOKEN"] ?? "",
+});
+
+async function run() {
+  const result = await glean.client.chat.uploadFiles({
+    files: [
+      await openAsBlob("example.file"),
+    ],
+  });
+
+  console.log(result);
+}
+
+run();
+
+```
+<!-- End File uploads [file-upload] -->
+
 <!-- Start Retries [retries] -->
 ## Retries
 
@@ -1078,7 +1104,7 @@ httpClient.addHook("requestError", (error, request) => {
   console.groupEnd();
 });
 
-const sdk = new Glean({ httpClient });
+const sdk = new Glean({ httpClient: httpClient });
 ```
 <!-- End Custom HTTP Client [http-client] -->
 

README.md

@@ -278,4 +278,14 @@ Based on:
 ### Generated
 - [typescript v0.10.5] .
 ### Releases
-- [NPM v0.10.5] https://www.npmjs.com/package/@gleanwork/api-client/v/0.10.5 - .
+- [NPM v0.10.5] https://www.npmjs.com/package/@gleanwork/api-client/v/0.10.5 - .
+
+## 2025-09-30 21:42:46
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.631.5 (2.716.16) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [typescript v0.11.0] .
+### Releases
+- [NPM v0.11.0] https://www.npmjs.com/package/@gleanwork/api-client/v/0.11.0 - .

RELEASES.md

@@ -19,7 +19,6 @@ async function run() {
     ],
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -47,7 +46,6 @@ async function run() {
     ],
   });
 
-  // Handle the result
   console.log(result);
 }
 

USAGE.md

@@ -8,9 +8,8 @@ import { AddCollectionItemsResponse } from "@gleanwork/api-client/models/compone
 let value: AddCollectionItemsResponse = {
   collection: {
     name: "<value>",
-    description: "jaggedly anti triumphantly frenetically eek with",
-    addedRoles: [],
-    removedRoles: [],
+    description:
+      "feline charming fast vibraphone immediately viciously creator",
     audienceFilters: [
       {
         fieldName: "type",
@@ -26,7 +25,7 @@ let value: AddCollectionItemsResponse = {
         ],
       },
     ],
-    id: 320120,
+    id: 278414,
     creator: {
       name: "George Clooney",
       obfuscatedId: "abc123",
@@ -35,9 +34,36 @@ let value: AddCollectionItemsResponse = {
       name: "George Clooney",
       obfuscatedId: "abc123",
     },
-    items: [],
-    children: [],
-    roles: [],
+    children: [
+      {
+        name: "<value>",
+        description: "design cappelletti kettledrum",
+        audienceFilters: [
+          {
+            fieldName: "type",
+            values: [
+              {
+                value: "Spreadsheet",
+                relationType: "EQUALS",
+              },
+              {
+                value: "Presentation",
+                relationType: "EQUALS",
+              },
+            ],
+          },
+        ],
+        id: 635422,
+        creator: {
+          name: "George Clooney",
+          obfuscatedId: "abc123",
+        },
+        updatedBy: {
+          name: "George Clooney",
+          obfuscatedId: "abc123",
+        },
+      },
+    ],
   },
 };
 ```