@wix/evalforge-github-client 0.1.0

package/build/index.js

@@ -0,0 +1,138 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  fetchSkillFolder: () => fetchSkillFolder,
+  fetchSkillFolderRaw: () => fetchSkillFolderRaw,
+  validateGitHubSource: () => validateGitHubSource
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/github-contents-client.ts
+var GITHUB_API_BASE = "https://api.github.com";
+function githubHeaders(options) {
+  const token = options?.token ?? process.env.GITHUB_TOKEN;
+  const headers = {
+    Accept: "application/vnd.github.v3+json",
+    "User-Agent": options?.userAgent ?? "EvalForge"
+  };
+  if (token) {
+    headers.Authorization = `Bearer ${token}`;
+  }
+  return headers;
+}
+async function fetchSkillFolder(source, options) {
+  const files = await fetchDirectory(
+    source.owner,
+    source.repo,
+    source.path,
+    source.ref,
+    "",
+    options
+  );
+  const hasSkillMd = files.some((f) => f.path === "SKILL.md");
+  if (!hasSkillMd) {
+    throw new Error(
+      `SKILL.md not found in ${source.owner}/${source.repo}/${source.path} at ref ${source.ref}`
+    );
+  }
+  return files;
+}
+async function fetchSkillFolderRaw(source, options) {
+  return fetchDirectory(
+    source.owner,
+    source.repo,
+    source.path,
+    source.ref,
+    "",
+    options
+  );
+}
+async function validateGitHubSource(source, options) {
+  await fetchSkillFolder(source, options);
+}
+async function fetchDirectory(owner, repo, dirPath, ref, relativePath, options) {
+  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${dirPath}?ref=${ref}`;
+  const response = await fetch(url, {
+    headers: githubHeaders(options)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `GitHub API error: ${response.status} ${response.statusText} for ${url}`
+    );
+  }
+  const entries = await response.json();
+  const filePromises = entries.map(async (entry) => {
+    if (entry.type === "file") {
+      const filePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      let content;
+      if (entry.content && entry.encoding === "base64") {
+        content = Buffer.from(entry.content, "base64").toString("utf-8");
+      } else {
+        content = await fetchFileContent(
+          owner,
+          repo,
+          `${dirPath}/${entry.name}`,
+          ref,
+          options
+        );
+      }
+      return [{ path: filePath, content }];
+    }
+    if (entry.type === "dir") {
+      const subPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      return fetchDirectory(
+        owner,
+        repo,
+        `${dirPath}/${entry.name}`,
+        ref,
+        subPath,
+        options
+      );
+    }
+    return [];
+  });
+  const results = await Promise.all(filePromises);
+  return results.flat();
+}
+async function fetchFileContent(owner, repo, filePath, ref, options) {
+  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${filePath}?ref=${ref}`;
+  const response = await fetch(url, {
+    headers: githubHeaders(options)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `GitHub API error: ${response.status} ${response.statusText} for ${url}`
+    );
+  }
+  const data = await response.json();
+  if (data.content && data.encoding === "base64") {
+    return Buffer.from(data.content, "base64").toString("utf-8");
+  }
+  throw new Error(`No content returned for file: ${filePath}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchSkillFolder,
+  fetchSkillFolderRaw,
+  validateGitHubSource
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/github-contents-client.ts"],
+  "sourcesContent": ["export {\n  fetchSkillFolder,\n  fetchSkillFolderRaw,\n  validateGitHubSource,\n} from \"./github-contents-client.js\";\nexport type { FetchSkillFolderOptions } from \"./github-contents-client.js\";\n", "/**\n * GitHub Contents API client for fetching skill directories.\n *\n * Authenticates with GITHUB_TOKEN if set.\n */\n\nimport type { GitHubSource, SkillFile } from \"@wix/evalforge-types\";\n\nconst GITHUB_API_BASE = \"https://api.github.com\";\n\nexport interface FetchSkillFolderOptions {\n  /** GitHub token for authentication (increases rate limit). Read from env if not provided. */\n  token?: string;\n  /** User-Agent header value. Defaults to \"EvalForge\". */\n  userAgent?: string;\n}\n\ninterface GitHubContentsEntry {\n  name: string;\n  path: string;\n  type: \"file\" | \"dir\";\n  content?: string;\n  encoding?: string;\n}\n\nfunction githubHeaders(\n  options?: FetchSkillFolderOptions,\n): Record<string, string> {\n  const token = options?.token ?? process.env.GITHUB_TOKEN;\n  const headers: Record<string, string> = {\n    Accept: \"application/vnd.github.v3+json\",\n    \"User-Agent\": options?.userAgent ?? \"EvalForge\",\n  };\n  if (token) {\n    headers.Authorization = `Bearer ${token}`;\n  }\n  return headers;\n}\n\n/**\n * Fetches all files in a skill directory from a GitHub repo.\n * Validates that SKILL.md exists at the root of the directory.\n */\nexport async function fetchSkillFolder(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  const files = await fetchDirectory(\n    source.owner,\n    source.repo,\n    source.path,\n    source.ref,\n    \"\",\n    options,\n  );\n\n  const hasSkillMd = files.some((f) => f.path === \"SKILL.md\");\n  if (!hasSkillMd) {\n    throw new Error(\n      `SKILL.md not found in ${source.owner}/${source.repo}/${source.path} at ref ${source.ref}`,\n    );\n  }\n\n  return files;\n}\n\n/**\n * Fetches all files in a skill directory without validating SKILL.md presence.\n */\nexport async function fetchSkillFolderRaw(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  return fetchDirectory(\n    source.owner,\n    source.repo,\n    source.path,\n    source.ref,\n    \"\",\n    options,\n  );\n}\n\n/**\n * Validates that a GitHub source points to a valid skill directory\n * (i.e., the directory exists and contains SKILL.md).\n */\nexport async function validateGitHubSource(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<void> {\n  await fetchSkillFolder(source, options);\n}\n\nasync function fetchDirectory(\n  owner: string,\n  repo: string,\n  dirPath: string,\n  ref: string,\n  relativePath: string,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${dirPath}?ref=${ref}`;\n  const response = await fetch(url, {\n    headers: githubHeaders(options),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `GitHub API error: ${response.status} ${response.statusText} for ${url}`,\n    );\n  }\n\n  const entries = (await response.json()) as GitHubContentsEntry[];\n\n  const filePromises = entries.map(async (entry): Promise<SkillFile[]> => {\n    if (entry.type === \"file\") {\n      const filePath = relativePath\n        ? `${relativePath}/${entry.name}`\n        : entry.name;\n\n      let content: string;\n      if (entry.content && entry.encoding === \"base64\") {\n        content = Buffer.from(entry.content, \"base64\").toString(\"utf-8\");\n      } else {\n        content = await fetchFileContent(\n          owner,\n          repo,\n          `${dirPath}/${entry.name}`,\n          ref,\n          options,\n        );\n      }\n\n      return [{ path: filePath, content }];\n    }\n\n    if (entry.type === \"dir\") {\n      const subPath = relativePath\n        ? `${relativePath}/${entry.name}`\n        : entry.name;\n      return fetchDirectory(\n        owner,\n        repo,\n        `${dirPath}/${entry.name}`,\n        ref,\n        subPath,\n        options,\n      );\n    }\n\n    return [];\n  });\n\n  const results = await Promise.all(filePromises);\n  return results.flat();\n}\n\n/**\n * Fetch a single file's content from the GitHub Contents API.\n * The API returns base64-encoded content when requesting a file path directly.\n */\nasync function fetchFileContent(\n  owner: string,\n  repo: string,\n  filePath: string,\n  ref: string,\n  options?: FetchSkillFolderOptions,\n): Promise<string> {\n  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${filePath}?ref=${ref}`;\n  const response = await fetch(url, {\n    headers: githubHeaders(options),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `GitHub API error: ${response.status} ${response.statusText} for ${url}`,\n    );\n  }\n\n  const data = (await response.json()) as GitHubContentsEntry;\n  if (data.content && data.encoding === \"base64\") {\n    return Buffer.from(data.content, \"base64\").toString(\"utf-8\");\n  }\n\n  throw new Error(`No content returned for file: ${filePath}`);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/index.mjs

@@ -0,0 +1,109 @@
+// src/github-contents-client.ts
+var GITHUB_API_BASE = "https://api.github.com";
+function githubHeaders(options) {
+  const token = options?.token ?? process.env.GITHUB_TOKEN;
+  const headers = {
+    Accept: "application/vnd.github.v3+json",
+    "User-Agent": options?.userAgent ?? "EvalForge"
+  };
+  if (token) {
+    headers.Authorization = `Bearer ${token}`;
+  }
+  return headers;
+}
+async function fetchSkillFolder(source, options) {
+  const files = await fetchDirectory(
+    source.owner,
+    source.repo,
+    source.path,
+    source.ref,
+    "",
+    options
+  );
+  const hasSkillMd = files.some((f) => f.path === "SKILL.md");
+  if (!hasSkillMd) {
+    throw new Error(
+      `SKILL.md not found in ${source.owner}/${source.repo}/${source.path} at ref ${source.ref}`
+    );
+  }
+  return files;
+}
+async function fetchSkillFolderRaw(source, options) {
+  return fetchDirectory(
+    source.owner,
+    source.repo,
+    source.path,
+    source.ref,
+    "",
+    options
+  );
+}
+async function validateGitHubSource(source, options) {
+  await fetchSkillFolder(source, options);
+}
+async function fetchDirectory(owner, repo, dirPath, ref, relativePath, options) {
+  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${dirPath}?ref=${ref}`;
+  const response = await fetch(url, {
+    headers: githubHeaders(options)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `GitHub API error: ${response.status} ${response.statusText} for ${url}`
+    );
+  }
+  const entries = await response.json();
+  const filePromises = entries.map(async (entry) => {
+    if (entry.type === "file") {
+      const filePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      let content;
+      if (entry.content && entry.encoding === "base64") {
+        content = Buffer.from(entry.content, "base64").toString("utf-8");
+      } else {
+        content = await fetchFileContent(
+          owner,
+          repo,
+          `${dirPath}/${entry.name}`,
+          ref,
+          options
+        );
+      }
+      return [{ path: filePath, content }];
+    }
+    if (entry.type === "dir") {
+      const subPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      return fetchDirectory(
+        owner,
+        repo,
+        `${dirPath}/${entry.name}`,
+        ref,
+        subPath,
+        options
+      );
+    }
+    return [];
+  });
+  const results = await Promise.all(filePromises);
+  return results.flat();
+}
+async function fetchFileContent(owner, repo, filePath, ref, options) {
+  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${filePath}?ref=${ref}`;
+  const response = await fetch(url, {
+    headers: githubHeaders(options)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `GitHub API error: ${response.status} ${response.statusText} for ${url}`
+    );
+  }
+  const data = await response.json();
+  if (data.content && data.encoding === "base64") {
+    return Buffer.from(data.content, "base64").toString("utf-8");
+  }
+  throw new Error(`No content returned for file: ${filePath}`);
+}
+export {
+  fetchSkillFolder,
+  fetchSkillFolderRaw,
+  validateGitHubSource
+};
+//# sourceMappingURL=index.mjs.map

package/build/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/github-contents-client.ts"],
+  "sourcesContent": ["/**\n * GitHub Contents API client for fetching skill directories.\n *\n * Authenticates with GITHUB_TOKEN if set.\n */\n\nimport type { GitHubSource, SkillFile } from \"@wix/evalforge-types\";\n\nconst GITHUB_API_BASE = \"https://api.github.com\";\n\nexport interface FetchSkillFolderOptions {\n  /** GitHub token for authentication (increases rate limit). Read from env if not provided. */\n  token?: string;\n  /** User-Agent header value. Defaults to \"EvalForge\". */\n  userAgent?: string;\n}\n\ninterface GitHubContentsEntry {\n  name: string;\n  path: string;\n  type: \"file\" | \"dir\";\n  content?: string;\n  encoding?: string;\n}\n\nfunction githubHeaders(\n  options?: FetchSkillFolderOptions,\n): Record<string, string> {\n  const token = options?.token ?? process.env.GITHUB_TOKEN;\n  const headers: Record<string, string> = {\n    Accept: \"application/vnd.github.v3+json\",\n    \"User-Agent\": options?.userAgent ?? \"EvalForge\",\n  };\n  if (token) {\n    headers.Authorization = `Bearer ${token}`;\n  }\n  return headers;\n}\n\n/**\n * Fetches all files in a skill directory from a GitHub repo.\n * Validates that SKILL.md exists at the root of the directory.\n */\nexport async function fetchSkillFolder(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  const files = await fetchDirectory(\n    source.owner,\n    source.repo,\n    source.path,\n    source.ref,\n    \"\",\n    options,\n  );\n\n  const hasSkillMd = files.some((f) => f.path === \"SKILL.md\");\n  if (!hasSkillMd) {\n    throw new Error(\n      `SKILL.md not found in ${source.owner}/${source.repo}/${source.path} at ref ${source.ref}`,\n    );\n  }\n\n  return files;\n}\n\n/**\n * Fetches all files in a skill directory without validating SKILL.md presence.\n */\nexport async function fetchSkillFolderRaw(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  return fetchDirectory(\n    source.owner,\n    source.repo,\n    source.path,\n    source.ref,\n    \"\",\n    options,\n  );\n}\n\n/**\n * Validates that a GitHub source points to a valid skill directory\n * (i.e., the directory exists and contains SKILL.md).\n */\nexport async function validateGitHubSource(\n  source: GitHubSource,\n  options?: FetchSkillFolderOptions,\n): Promise<void> {\n  await fetchSkillFolder(source, options);\n}\n\nasync function fetchDirectory(\n  owner: string,\n  repo: string,\n  dirPath: string,\n  ref: string,\n  relativePath: string,\n  options?: FetchSkillFolderOptions,\n): Promise<SkillFile[]> {\n  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${dirPath}?ref=${ref}`;\n  const response = await fetch(url, {\n    headers: githubHeaders(options),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `GitHub API error: ${response.status} ${response.statusText} for ${url}`,\n    );\n  }\n\n  const entries = (await response.json()) as GitHubContentsEntry[];\n\n  const filePromises = entries.map(async (entry): Promise<SkillFile[]> => {\n    if (entry.type === \"file\") {\n      const filePath = relativePath\n        ? `${relativePath}/${entry.name}`\n        : entry.name;\n\n      let content: string;\n      if (entry.content && entry.encoding === \"base64\") {\n        content = Buffer.from(entry.content, \"base64\").toString(\"utf-8\");\n      } else {\n        content = await fetchFileContent(\n          owner,\n          repo,\n          `${dirPath}/${entry.name}`,\n          ref,\n          options,\n        );\n      }\n\n      return [{ path: filePath, content }];\n    }\n\n    if (entry.type === \"dir\") {\n      const subPath = relativePath\n        ? `${relativePath}/${entry.name}`\n        : entry.name;\n      return fetchDirectory(\n        owner,\n        repo,\n        `${dirPath}/${entry.name}`,\n        ref,\n        subPath,\n        options,\n      );\n    }\n\n    return [];\n  });\n\n  const results = await Promise.all(filePromises);\n  return results.flat();\n}\n\n/**\n * Fetch a single file's content from the GitHub Contents API.\n * The API returns base64-encoded content when requesting a file path directly.\n */\nasync function fetchFileContent(\n  owner: string,\n  repo: string,\n  filePath: string,\n  ref: string,\n  options?: FetchSkillFolderOptions,\n): Promise<string> {\n  const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}/contents/${filePath}?ref=${ref}`;\n  const response = await fetch(url, {\n    headers: githubHeaders(options),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `GitHub API error: ${response.status} ${response.statusText} for ${url}`,\n    );\n  }\n\n  const data = (await response.json()) as GitHubContentsEntry;\n  if (data.content && data.encoding === \"base64\") {\n    return Buffer.from(data.content, \"base64\").toString(\"utf-8\");\n  }\n\n  throw new Error(`No content returned for file: ${filePath}`);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/types/github-contents-client.d.ts

@@ -0,0 +1,26 @@
+/**
+ * GitHub Contents API client for fetching skill directories.
+ *
+ * Authenticates with GITHUB_TOKEN if set.
+ */
+import type { GitHubSource, SkillFile } from "@wix/evalforge-types";
+export interface FetchSkillFolderOptions {
+    /** GitHub token for authentication (increases rate limit). Read from env if not provided. */
+    token?: string;
+    /** User-Agent header value. Defaults to "EvalForge". */
+    userAgent?: string;
+}
+/**
+ * Fetches all files in a skill directory from a GitHub repo.
+ * Validates that SKILL.md exists at the root of the directory.
+ */
+export declare function fetchSkillFolder(source: GitHubSource, options?: FetchSkillFolderOptions): Promise<SkillFile[]>;
+/**
+ * Fetches all files in a skill directory without validating SKILL.md presence.
+ */
+export declare function fetchSkillFolderRaw(source: GitHubSource, options?: FetchSkillFolderOptions): Promise<SkillFile[]>;
+/**
+ * Validates that a GitHub source points to a valid skill directory
+ * (i.e., the directory exists and contains SKILL.md).
+ */
+export declare function validateGitHubSource(source: GitHubSource, options?: FetchSkillFolderOptions): Promise<void>;

package/build/types/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchSkillFolder, fetchSkillFolderRaw, validateGitHubSource, } from "./github-contents-client.js";
+export type { FetchSkillFolderOptions } from "./github-contents-client.js";

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@wix/evalforge-github-client",
+  "version": "0.1.0",
+  "description": "GitHub Contents API client for fetching skill directories",
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "clean": "rm -rf build",
+    "build:cjs": "esbuild src/index.ts --bundle --platform=node --outfile=build/index.js --format=cjs --sourcemap --packages=external",
+    "build:esm": "esbuild src/index.ts --bundle --platform=node --outfile=build/index.mjs --format=esm --sourcemap --packages=external",
+    "build:types": "tsc --emitDeclarationOnly --outDir ./build/types",
+    "build": "yarn run clean && yarn run build:cjs && yarn run build:esm && yarn run build:types",
+    "lint": "eslint .",
+    "test": "echo 'No tests specified' && exit 0"
+  },
+  "dependencies": {
+    "@wix/evalforge-types": "0.26.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^22.19.3",
+    "esbuild": "^0.27.2",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.51.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./build/types/index.d.ts",
+      "import": "./build/index.mjs",
+      "require": "./build/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "wix": {
+    "artifact": {
+      "groupId": "com.wixpress",
+      "artifactId": "evalforge-github-client"
+    }
+  },
+  "falconPackageHash": "a536720ec887ce7ecbd64a6eae33bd5af88beb9b852aba1249365dae"
+}