Add helper to fetch SDK artifacts directly from Github

Author: pschutz93

examples/docusaurus/speakeasy.glean.config.github.mjs

@@ -0,0 +1,33 @@
+import { withGithubSdks } from "@speakeasy-api/docs-md";
+
+const sdkConfigs = await withGithubSdks(
+  [
+    {
+      language: "typescript",
+      owner: "gleanwork",
+      repo: "api-client-typescript",
+      version: "v0.11.2",
+      tryItNow: {
+        outDir: "./public/glean-try-it-now",
+        urlPrefix: "/glean-try-it-now",
+      },
+    },
+    {
+      language: "curl",
+    },
+  ],
+  process.env.GITHUB_TOKEN
+);
+
+export default {
+  spec: "../specs/glean.yaml",
+  output: {
+    pageOutDir: "./docs/glean/api",
+    embedOutDir: "./src/components/glean-embeds",
+    framework: "docusaurus",
+  },
+  display: {
+    maxNestingLevel: 2,
+  },
+  ...sdkConfigs,
+};

package-lock.json

@@ -36,6 +36,8 @@
     "@microsoft/api-extractor": "^7.52.15",
     "@speakeasy-api/docs-md-react": "0.2.36",
     "@speakeasy-api/docs-md-shared": "0.2.36",
+    "@octokit/request-error": "^6.1.8",
+    "@octokit/rest": "^21.0.2",
     "arg": "^5.0.2",
     "chalk": "^5.3.0",
     "change-case": "^5.4.4",
@@ -54,4 +56,4 @@
     "globals": "^16.3.0",
     "typescript": "^5.8.3"
   }
-}
+}

packages/compiler/package.json

@@ -1,4 +1,5 @@
 export { getSettings } from "./settings.ts";
 export { escapeText } from "./renderers/util.ts";
+export { withGithubSdks } from "./fetchers/withGithub.ts";
 export type { FrameworkConfig } from "./types/FrameworkConfig.ts";
 export type { Settings } from "./settings.ts";