better-gdrive 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sn4tchZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# better-gdrive
+
+[![Node](https://img.shields.io/badge/node-18%20%7C%2020%20%7C%2022%20%7C%2024-339933?style=flat-square&logo=node.js)](https://nodejs.org)
+[![npm](https://img.shields.io/npm/v/better-gdrive?style=flat-square)](https://www.npmjs.com/package/better-gdrive)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](./LICENSE)
+
+Download files from **public Google Drive** without OAuth: list a folder, get a file in memory (blob/buffer), read metadata, or save directly to disk. Lightweight, no runtime dependencies, optimized (streaming, low memory).
+
+If this package is useful to you, a **⭐ [star](https://github.com/Sn4tchZ/better-gdrive)** on the repo is always appreciated.
+
+---
+
+## Installation
+
+```bash
+npm install better-gdrive
+```
+
+**Requirements:** Node ≥ 18. Files or folders must be shared with "Anyone with the link".
+
+---
+
+## API — Tutorial by function
+
+| [listFiles](#listfilesfolderid-options) | [getFile](#getfilefileid-format-options) | [getFileMetadata](#getfilemetadatafileid-options) | [downloadFile](#downloadfilefileid-path-options) | [toFileId](#tofileidinput) |
+|----------------------------------------|----------------------------------------|--------------------------------------------------|--------------------------------------------------|---------------------------|
+
+All functions that take a file accept either an **ID** (e.g. `abc123xyz`) or a **share link** (the ID is extracted automatically). Cancellation is supported via `{ signal: AbortSignal }` on every call.
+
+---
+
+### `listFiles(folderId, options?)`
+
+Lists files in a **public folder** (share link or folder ID).
+
+**Returns:** `Promise<ListFileEntry[]>` with `{ id: string, name?: string }` (name is set when Drive’s HTML provides it).
+
+```js
+import { listFiles } from "better-gdrive";
+
+const files = await listFiles("https://drive.google.com/drive/folders/1ABC...");
+// or
+const files = await listFiles("1ABC...");
+
+console.log(files);
+// [{ id: "xyz123", name: "report.pdf" }, { id: "abc456", name: "data.csv" }, ...]
+```
+
+---
+
+### `getFile(fileId, format, options?)`
+
+Gets the file **in memory** as a `Blob` (browser or Node) or `Buffer` (Node).
+
+- **format:** `"blob"` | `"buffer"`
+
+```js
+import { getFile } from "better-gdrive";
+
+// As buffer (Node)
+const buffer = await getFile("FILE_ID", "buffer");
+fs.writeFileSync("./out.pdf", buffer);
+
+// As blob (Node or browser)
+const blob = await getFile("FILE_ID", "blob");
+const url = URL.createObjectURL(blob);
+```
+
+---
+
+### `getFileMetadata(fileId, options?)`
+
+Gets **metadata** without downloading the file (HEAD / minimal Range request).
+
+**Returns:** `Promise<FileMetadata>` with `filename?`, `size?`, `mimeType?`, `lastModified?` (Date).
+
+```js
+import { getFileMetadata } from "better-gdrive";
+
+const meta = await getFileMetadata("FILE_ID");
+console.log(meta.filename);   // "document.pdf"
+console.log(meta.size);       // 1024000
+console.log(meta.lastModified); // Date
+```
+
+---
+
+### `downloadFile(fileId, path, options?)`
+
+Saves the file **directly to disk** (Node only). Uses streaming to limit memory usage.
+
+```js
+import { downloadFile } from "better-gdrive";
+
+await downloadFile("FILE_ID", "./downloads/document.pdf");
+```
+
+---
+
+### `toFileId(input)`
+
+Extracts the **Drive ID** from a share link, or returns the string as-is if it’s already an ID.
+
+```js
+import { toFileId } from "better-gdrive";
+
+const id = toFileId("https://drive.google.com/file/d/1abcXYZ/view?usp=sharing");
+// "1abcXYZ"
+```
+
+---
+
+### Errors: `GDriveDownloadError`
+
+On failure (bad HTTP status, no download link, etc.), the package throws **`GDriveDownloadError`** (subclass of `Error`) with:
+
+- **message**
+- **statusCode** (optional)
+- **fileId** (optional)
+
+```js
+import { getFile, GDriveDownloadError } from "better-gdrive";
+
+try {
+  const buffer = await getFile("BAD_ID", "buffer");
+} catch (err) {
+  if (err instanceof GDriveDownloadError) {
+    console.error(err.fileId, err.statusCode);
+  }
+  throw err;
+}
+```
+
+---
+
+### Cancellation: `signal`
+
+All functions that accept `options` support **`options.signal`** (AbortSignal) to cancel the request.
+
+```js
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5000);
+
+const files = await listFiles("FOLDER_ID", { signal: controller.signal });
+```
+
+---
+
+## Exported types
+
+- **`ListFileEntry`**: `{ id: string; name?: string }` (returned by `listFiles`)
+- **`FileMetadata`**: `{ filename?; size?; mimeType?; lastModified? }` (returned by `getFileMetadata`)
+
+---
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+interface FileMetadata {
+    filename?: string;
+    size?: number;
+    mimeType?: string;
+    lastModified?: Date;
+}
+
+interface ListFileEntry {
+    id: string;
+    name?: string;
+}
+
+/**
+ * Error thrown when a Google Drive download fails (wrong status, no link, etc.).
+ */
+declare class GDriveDownloadError extends Error {
+    readonly statusCode: number | undefined;
+    readonly fileId: string | undefined;
+    constructor(message: string, options?: {
+        cause?: unknown;
+        statusCode?: number;
+        fileId?: string;
+    });
+}
+
+/** Normalizes share link to file ID, or returns input if already an ID. */
+declare function toFileId(input: string): string;
+
+interface CommonOptions {
+    signal?: AbortSignal;
+}
+declare function listFiles(folderId: string, options?: CommonOptions): Promise<ListFileEntry[]>;
+declare function getFile(fileId: string, format: "blob" | "buffer", options?: CommonOptions): Promise<Blob | Buffer>;
+declare function getFileMetadata(fileId: string, options?: CommonOptions): Promise<FileMetadata>;
+declare function downloadFile(fileId: string, path: string, options?: CommonOptions): Promise<void>;
+
+export { type CommonOptions, type FileMetadata, GDriveDownloadError, type ListFileEntry, downloadFile, getFile, getFileMetadata, listFiles, toFileId };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+interface FileMetadata {
+    filename?: string;
+    size?: number;
+    mimeType?: string;
+    lastModified?: Date;
+}
+
+interface ListFileEntry {
+    id: string;
+    name?: string;
+}
+
+/**
+ * Error thrown when a Google Drive download fails (wrong status, no link, etc.).
+ */
+declare class GDriveDownloadError extends Error {
+    readonly statusCode: number | undefined;
+    readonly fileId: string | undefined;
+    constructor(message: string, options?: {
+        cause?: unknown;
+        statusCode?: number;
+        fileId?: string;
+    });
+}
+
+/** Normalizes share link to file ID, or returns input if already an ID. */
+declare function toFileId(input: string): string;
+
+interface CommonOptions {
+    signal?: AbortSignal;
+}
+declare function listFiles(folderId: string, options?: CommonOptions): Promise<ListFileEntry[]>;
+declare function getFile(fileId: string, format: "blob" | "buffer", options?: CommonOptions): Promise<Blob | Buffer>;
+declare function getFileMetadata(fileId: string, options?: CommonOptions): Promise<FileMetadata>;
+declare function downloadFile(fileId: string, path: string, options?: CommonOptions): Promise<void>;
+
+export { type CommonOptions, type FileMetadata, GDriveDownloadError, type ListFileEntry, downloadFile, getFile, getFileMetadata, listFiles, toFileId };

package/dist/index.js

@@ -0,0 +1,194 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  GDriveDownloadError: () => GDriveDownloadError,
+  downloadFile: () => downloadFile,
+  getFile: () => getFile,
+  getFileMetadata: () => getFileMetadata,
+  listFiles: () => listFiles2,
+  toFileId: () => toFileId
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var GDriveDownloadError = class _GDriveDownloadError extends Error {
+  statusCode;
+  fileId;
+  constructor(message, options) {
+    super(message);
+    this.name = "GDriveDownloadError";
+    this.statusCode = options?.statusCode;
+    this.fileId = options?.fileId;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    Object.setPrototypeOf(this, _GDriveDownloadError.prototype);
+  }
+};
+
+// src/resolve.ts
+var FILE_ID_REGEX = /\/d\/([a-zA-Z0-9_-]+)(?:\/|$)/;
+function toFileId(input) {
+  const m = input.match(FILE_ID_REGEX);
+  return m ? m[1] : input;
+}
+async function getDownloadUrl(fileId, signal) {
+  const id = toFileId(fileId);
+  const res = await fetch(
+    `https://drive.google.com/uc?id=${encodeURIComponent(id)}&export=download`,
+    { redirect: "manual", signal }
+  );
+  if (res.status === 303) {
+    const loc = res.headers.get("Location");
+    if (loc) return loc;
+    throw new GDriveDownloadError("303 without Location", { statusCode: 303, fileId: id });
+  }
+  if (res.status === 200) {
+    const action = (await res.text()).match(/action="([^"]+)"/)?.[1];
+    if (action) return action;
+    throw new GDriveDownloadError("200 without form action", { statusCode: 200, fileId: id });
+  }
+  throw new GDriveDownloadError(`Unexpected status ${res.status}`, { statusCode: res.status, fileId: id });
+}
+
+// src/metadata.ts
+function parseFilename(h) {
+  if (!h) return void 0;
+  const u = h.match(/filename\*=UTF-8''([^;]+)/i);
+  if (u) {
+    try {
+      return decodeURIComponent(u[1].trim());
+    } catch {
+      return void 0;
+    }
+  }
+  const q = h.match(/filename="([^"]+)"/);
+  return q ? q[1] : void 0;
+}
+function parseSize(headers) {
+  const cl = headers.get("Content-Length");
+  if (cl != null) {
+    const n = parseInt(cl, 10);
+    if (!Number.isNaN(n)) return n;
+  }
+  const cr = headers.get("Content-Range")?.match(/\/\s*(\d+)/);
+  return cr ? parseInt(cr[1], 10) : void 0;
+}
+async function getMetadataFromUrl(url, signal) {
+  const res = await fetch(url, { method: "HEAD", redirect: "follow", signal });
+  const headers = res.ok ? res.headers : res.status === 405 ? (await fetch(url, { method: "GET", redirect: "follow", signal, headers: { Range: "bytes=0-0" } })).headers : new Headers();
+  const cd = headers.get("Content-Disposition");
+  const lm = headers.get("Last-Modified");
+  const ct = headers.get("Content-Type");
+  let lastModified;
+  if (lm) {
+    const d = new Date(lm);
+    if (!Number.isNaN(d.getTime())) lastModified = d;
+  }
+  return {
+    filename: parseFilename(cd),
+    size: parseSize(headers),
+    mimeType: ct ? ct.split(";")[0].trim() || void 0 : void 0,
+    lastModified
+  };
+}
+
+// src/list.ts
+var FOLDER_URL = "https://drive.google.com/drive/folders/";
+var FOLDER_ID_REGEX = /\/folders\/([a-zA-Z0-9_-]+)/;
+var SSK_FILE_ID = /ssk='[^']*:([a-zA-Z0-9_-]+)-0-1'/g;
+var TR_ID_NAME = /<tr[^>]*\sdata-id="([a-zA-Z0-9_-]+)"[^>]*>[\s\S]*?(?:data-tooltip="([^"]+\.(?:csv|txt|pdf|zip|json))"|<strong[^>]*>([^<]+\.(?:csv|txt|pdf|zip|json))<\/strong>)/gi;
+function toFolderId(input) {
+  const m = input.match(FOLDER_ID_REGEX);
+  return m ? m[1] : input;
+}
+async function listFiles(folderLinkOrId, signal) {
+  const folderId = toFolderId(folderLinkOrId);
+  const html = await (await fetch(`${FOLDER_URL}${encodeURIComponent(folderId)}`, { signal })).text();
+  const idToName = /* @__PURE__ */ new Map();
+  let tr;
+  TR_ID_NAME.lastIndex = 0;
+  while ((tr = TR_ID_NAME.exec(html)) !== null) {
+    const id = tr[1];
+    const name = tr[2] || tr[3]?.trim();
+    if (name && !idToName.has(id)) idToName.set(id, name);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  let m;
+  SSK_FILE_ID.lastIndex = 0;
+  while ((m = SSK_FILE_ID.exec(html)) !== null) {
+    if (!seen.has(m[1])) {
+      seen.add(m[1]);
+      out.push({ id: m[1], name: idToName.get(m[1]) });
+    }
+  }
+  return out;
+}
+
+// src/index.ts
+async function listFiles2(folderId, options) {
+  return listFiles(folderId, options?.signal);
+}
+async function getFile(fileId, format, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  const res = await fetch(url, { signal: options?.signal });
+  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);
+  if (format === "buffer") return Buffer.from(await res.arrayBuffer());
+  return res.blob();
+}
+async function getFileMetadata(fileId, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  return getMetadataFromUrl(url, options?.signal);
+}
+async function downloadFile(fileId, path, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  const res = await fetch(url, { signal: options?.signal });
+  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);
+  if (res.body == null) throw new Error("Response has no body");
+  const { Readable } = await import("stream");
+  const { createWriteStream } = await import("fs");
+  const { pipeline } = await import("stream/promises");
+  const nodeReadable = Readable.fromWeb(res.body);
+  const dest = createWriteStream(path);
+  await pipeline(nodeReadable, dest);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GDriveDownloadError,
+  downloadFile,
+  getFile,
+  getFileMetadata,
+  listFiles,
+  toFileId
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resolve.ts","../src/metadata.ts","../src/list.ts"],"sourcesContent":["export { GDriveDownloadError } from \"./errors.js\";\r\nexport { toFileId } from \"./resolve.js\";\r\nexport type { FileMetadata } from \"./metadata.js\";\r\nexport type { ListFileEntry } from \"./list.js\";\r\n\r\nimport { getDownloadUrl } from \"./resolve.js\";\r\nimport { getMetadataFromUrl } from \"./metadata.js\";\r\nimport { listFiles as listFilesInFolder } from \"./list.js\";\r\n\r\nexport interface CommonOptions {\r\n  signal?: AbortSignal;\r\n}\r\n\r\nexport async function listFiles(\r\n  folderId: string,\r\n  options?: CommonOptions\r\n): Promise<import(\"./list.js\").ListFileEntry[]> {\r\n  return listFilesInFolder(folderId, options?.signal);\r\n}\r\n\r\nexport async function getFile(\r\n  fileId: string,\r\n  format: \"blob\" | \"buffer\",\r\n  options?: CommonOptions\r\n): Promise<Blob | Buffer> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  const res = await fetch(url, { signal: options?.signal });\r\n  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);\r\n  if (format === \"buffer\") return Buffer.from(await res.arrayBuffer());\r\n  return res.blob();\r\n}\r\n\r\nexport async function getFileMetadata(\r\n  fileId: string,\r\n  options?: CommonOptions\r\n): Promise<import(\"./metadata.js\").FileMetadata> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  return getMetadataFromUrl(url, options?.signal);\r\n}\r\n\r\nexport async function downloadFile(\r\n  fileId: string,\r\n  path: string,\r\n  options?: CommonOptions\r\n): Promise<void> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  const res = await fetch(url, { signal: options?.signal });\r\n  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);\r\n  if (res.body == null) throw new Error(\"Response has no body\");\r\n  const { Readable } = await import(\"node:stream\");\r\n  const { createWriteStream } = await import(\"node:fs\");\r\n  const { pipeline } = await import(\"node:stream/promises\");\r\n  const nodeReadable = Readable.fromWeb(res.body as Parameters<typeof Readable.fromWeb>[0]);\r\n  const dest = createWriteStream(path);\r\n  await pipeline(nodeReadable, dest);\r\n}\r\n","/**\r\n * Error thrown when a Google Drive download fails (wrong status, no link, etc.).\r\n */\r\nexport class GDriveDownloadError extends Error {\r\n  readonly statusCode: number | undefined;\r\n  readonly fileId: string | undefined;\r\n\r\n  constructor(\r\n    message: string,\r\n    options?: { cause?: unknown; statusCode?: number; fileId?: string }\r\n  ) {\r\n    super(message);\r\n    this.name = \"GDriveDownloadError\";\r\n    this.statusCode = options?.statusCode;\r\n    this.fileId = options?.fileId;\r\n    if (options?.cause !== undefined) {\r\n      this.cause = options.cause;\r\n    }\r\n    Object.setPrototypeOf(this, GDriveDownloadError.prototype);\r\n  }\r\n}\r\n","import { GDriveDownloadError } from \"./errors.js\";\r\n\r\nconst FILE_ID_REGEX = /\\/d\\/([a-zA-Z0-9_-]+)(?:\\/|$)/;\r\n\r\n/** Normalizes share link to file ID, or returns input if already an ID. */\r\nexport function toFileId(input: string): string {\r\n  const m = input.match(FILE_ID_REGEX);\r\n  return m ? m[1] : input;\r\n}\r\n\r\n/** Resolves direct download URL for a public file by ID. */\r\nexport async function getDownloadUrl(\r\n  fileId: string,\r\n  signal?: AbortSignal\r\n): Promise<string> {\r\n  const id = toFileId(fileId);\r\n  const res = await fetch(\r\n    `https://drive.google.com/uc?id=${encodeURIComponent(id)}&export=download`,\r\n    { redirect: \"manual\", signal }\r\n  );\r\n  if (res.status === 303) {\r\n    const loc = res.headers.get(\"Location\");\r\n    if (loc) return loc;\r\n    throw new GDriveDownloadError(\"303 without Location\", { statusCode: 303, fileId: id });\r\n  }\r\n  if (res.status === 200) {\r\n    const action = (await res.text()).match(/action=\"([^\"]+)\"/)?.[1];\r\n    if (action) return action;\r\n    throw new GDriveDownloadError(\"200 without form action\", { statusCode: 200, fileId: id });\r\n  }\r\n  throw new GDriveDownloadError(`Unexpected status ${res.status}`, { statusCode: res.status, fileId: id });\r\n}\r\n","export interface FileMetadata {\r\n  filename?: string;\r\n  size?: number;\r\n  mimeType?: string;\r\n  lastModified?: Date;\r\n}\r\n\r\nfunction parseFilename(h: string | null): string | undefined {\r\n  if (!h) return undefined;\r\n  const u = h.match(/filename\\*=UTF-8''([^;]+)/i);\r\n  if (u) {\r\n    try { return decodeURIComponent(u[1].trim()); } catch { return undefined; }\r\n  }\r\n  const q = h.match(/filename=\"([^\"]+)\"/);\r\n  return q ? q[1] : undefined;\r\n}\r\n\r\nfunction parseSize(headers: Headers): number | undefined {\r\n  const cl = headers.get(\"Content-Length\");\r\n  if (cl != null) { const n = parseInt(cl, 10); if (!Number.isNaN(n)) return n; }\r\n  const cr = headers.get(\"Content-Range\")?.match(/\\/\\s*(\\d+)/);\r\n  return cr ? parseInt(cr[1], 10) : undefined;\r\n}\r\n\r\nexport async function getMetadataFromUrl(\r\n  url: string,\r\n  signal?: AbortSignal\r\n): Promise<FileMetadata> {\r\n  const res = await fetch(url, { method: \"HEAD\", redirect: \"follow\", signal });\r\n  const headers = res.ok ? res.headers : (res.status === 405\r\n    ? (await fetch(url, { method: \"GET\", redirect: \"follow\", signal, headers: { Range: \"bytes=0-0\" } })).headers\r\n    : new Headers());\r\n  const cd = headers.get(\"Content-Disposition\");\r\n  const lm = headers.get(\"Last-Modified\");\r\n  const ct = headers.get(\"Content-Type\");\r\n  let lastModified: Date | undefined;\r\n  if (lm) { const d = new Date(lm); if (!Number.isNaN(d.getTime())) lastModified = d; }\r\n  return {\r\n    filename: parseFilename(cd),\r\n    size: parseSize(headers),\r\n    mimeType: ct ? ct.split(\";\")[0].trim() || undefined : undefined,\r\n    lastModified,\r\n  };\r\n}\r\n","const FOLDER_URL = \"https://drive.google.com/drive/folders/\";\r\nconst FOLDER_ID_REGEX = /\\/folders\\/([a-zA-Z0-9_-]+)/;\r\nconst SSK_FILE_ID = /ssk='[^']*:([a-zA-Z0-9_-]+)-0-1'/g;\r\n/** Row with data-id and filename in data-tooltip or <strong>. */\r\nconst TR_ID_NAME = /<tr[^>]*\\sdata-id=\"([a-zA-Z0-9_-]+)\"[^>]*>[\\s\\S]*?(?:data-tooltip=\"([^\"]+\\.(?:csv|txt|pdf|zip|json))\"|<strong[^>]*>([^<]+\\.(?:csv|txt|pdf|zip|json))<\\/strong>)/gi;\r\n\r\nexport interface ListFileEntry {\r\n  id: string;\r\n  name?: string;\r\n}\r\n\r\nfunction toFolderId(input: string): string {\r\n  const m = input.match(FOLDER_ID_REGEX);\r\n  return m ? m[1] : input;\r\n}\r\n\r\nexport async function listFiles(\r\n  folderLinkOrId: string,\r\n  signal?: AbortSignal\r\n): Promise<ListFileEntry[]> {\r\n  const folderId = toFolderId(folderLinkOrId);\r\n  const html = await (await fetch(`${FOLDER_URL}${encodeURIComponent(folderId)}`, { signal })).text();\r\n  const idToName = new Map<string, string>();\r\n  let tr: RegExpExecArray | null;\r\n  TR_ID_NAME.lastIndex = 0;\r\n  while ((tr = TR_ID_NAME.exec(html)) !== null) {\r\n    const id = tr[1];\r\n    const name = tr[2] || tr[3]?.trim();\r\n    if (name && !idToName.has(id)) idToName.set(id, name);\r\n  }\r\n  const seen = new Set<string>();\r\n  const out: ListFileEntry[] = [];\r\n  let m: RegExpExecArray | null;\r\n  SSK_FILE_ID.lastIndex = 0;\r\n  while ((m = SSK_FILE_ID.exec(html)) !== null) {\r\n    if (!seen.has(m[1])) {\r\n      seen.add(m[1]);\r\n      out.push({ id: m[1], name: idToName.get(m[1]) });\r\n    }\r\n  }\r\n  return out;\r\n}\r\n"],"mappings":"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","names":["listFiles","listFiles"]}

package/dist/index.mjs

@@ -0,0 +1,152 @@
+// src/errors.ts
+var GDriveDownloadError = class _GDriveDownloadError extends Error {
+  statusCode;
+  fileId;
+  constructor(message, options) {
+    super(message);
+    this.name = "GDriveDownloadError";
+    this.statusCode = options?.statusCode;
+    this.fileId = options?.fileId;
+    if (options?.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    Object.setPrototypeOf(this, _GDriveDownloadError.prototype);
+  }
+};
+
+// src/resolve.ts
+var FILE_ID_REGEX = /\/d\/([a-zA-Z0-9_-]+)(?:\/|$)/;
+function toFileId(input) {
+  const m = input.match(FILE_ID_REGEX);
+  return m ? m[1] : input;
+}
+async function getDownloadUrl(fileId, signal) {
+  const id = toFileId(fileId);
+  const res = await fetch(
+    `https://drive.google.com/uc?id=${encodeURIComponent(id)}&export=download`,
+    { redirect: "manual", signal }
+  );
+  if (res.status === 303) {
+    const loc = res.headers.get("Location");
+    if (loc) return loc;
+    throw new GDriveDownloadError("303 without Location", { statusCode: 303, fileId: id });
+  }
+  if (res.status === 200) {
+    const action = (await res.text()).match(/action="([^"]+)"/)?.[1];
+    if (action) return action;
+    throw new GDriveDownloadError("200 without form action", { statusCode: 200, fileId: id });
+  }
+  throw new GDriveDownloadError(`Unexpected status ${res.status}`, { statusCode: res.status, fileId: id });
+}
+
+// src/metadata.ts
+function parseFilename(h) {
+  if (!h) return void 0;
+  const u = h.match(/filename\*=UTF-8''([^;]+)/i);
+  if (u) {
+    try {
+      return decodeURIComponent(u[1].trim());
+    } catch {
+      return void 0;
+    }
+  }
+  const q = h.match(/filename="([^"]+)"/);
+  return q ? q[1] : void 0;
+}
+function parseSize(headers) {
+  const cl = headers.get("Content-Length");
+  if (cl != null) {
+    const n = parseInt(cl, 10);
+    if (!Number.isNaN(n)) return n;
+  }
+  const cr = headers.get("Content-Range")?.match(/\/\s*(\d+)/);
+  return cr ? parseInt(cr[1], 10) : void 0;
+}
+async function getMetadataFromUrl(url, signal) {
+  const res = await fetch(url, { method: "HEAD", redirect: "follow", signal });
+  const headers = res.ok ? res.headers : res.status === 405 ? (await fetch(url, { method: "GET", redirect: "follow", signal, headers: { Range: "bytes=0-0" } })).headers : new Headers();
+  const cd = headers.get("Content-Disposition");
+  const lm = headers.get("Last-Modified");
+  const ct = headers.get("Content-Type");
+  let lastModified;
+  if (lm) {
+    const d = new Date(lm);
+    if (!Number.isNaN(d.getTime())) lastModified = d;
+  }
+  return {
+    filename: parseFilename(cd),
+    size: parseSize(headers),
+    mimeType: ct ? ct.split(";")[0].trim() || void 0 : void 0,
+    lastModified
+  };
+}
+
+// src/list.ts
+var FOLDER_URL = "https://drive.google.com/drive/folders/";
+var FOLDER_ID_REGEX = /\/folders\/([a-zA-Z0-9_-]+)/;
+var SSK_FILE_ID = /ssk='[^']*:([a-zA-Z0-9_-]+)-0-1'/g;
+var TR_ID_NAME = /<tr[^>]*\sdata-id="([a-zA-Z0-9_-]+)"[^>]*>[\s\S]*?(?:data-tooltip="([^"]+\.(?:csv|txt|pdf|zip|json))"|<strong[^>]*>([^<]+\.(?:csv|txt|pdf|zip|json))<\/strong>)/gi;
+function toFolderId(input) {
+  const m = input.match(FOLDER_ID_REGEX);
+  return m ? m[1] : input;
+}
+async function listFiles(folderLinkOrId, signal) {
+  const folderId = toFolderId(folderLinkOrId);
+  const html = await (await fetch(`${FOLDER_URL}${encodeURIComponent(folderId)}`, { signal })).text();
+  const idToName = /* @__PURE__ */ new Map();
+  let tr;
+  TR_ID_NAME.lastIndex = 0;
+  while ((tr = TR_ID_NAME.exec(html)) !== null) {
+    const id = tr[1];
+    const name = tr[2] || tr[3]?.trim();
+    if (name && !idToName.has(id)) idToName.set(id, name);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  let m;
+  SSK_FILE_ID.lastIndex = 0;
+  while ((m = SSK_FILE_ID.exec(html)) !== null) {
+    if (!seen.has(m[1])) {
+      seen.add(m[1]);
+      out.push({ id: m[1], name: idToName.get(m[1]) });
+    }
+  }
+  return out;
+}
+
+// src/index.ts
+async function listFiles2(folderId, options) {
+  return listFiles(folderId, options?.signal);
+}
+async function getFile(fileId, format, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  const res = await fetch(url, { signal: options?.signal });
+  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);
+  if (format === "buffer") return Buffer.from(await res.arrayBuffer());
+  return res.blob();
+}
+async function getFileMetadata(fileId, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  return getMetadataFromUrl(url, options?.signal);
+}
+async function downloadFile(fileId, path, options) {
+  const url = await getDownloadUrl(fileId, options?.signal);
+  const res = await fetch(url, { signal: options?.signal });
+  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);
+  if (res.body == null) throw new Error("Response has no body");
+  const { Readable } = await import("stream");
+  const { createWriteStream } = await import("fs");
+  const { pipeline } = await import("stream/promises");
+  const nodeReadable = Readable.fromWeb(res.body);
+  const dest = createWriteStream(path);
+  await pipeline(nodeReadable, dest);
+}
+export {
+  GDriveDownloadError,
+  downloadFile,
+  getFile,
+  getFileMetadata,
+  listFiles2 as listFiles,
+  toFileId
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/resolve.ts","../src/metadata.ts","../src/list.ts","../src/index.ts"],"sourcesContent":["/**\r\n * Error thrown when a Google Drive download fails (wrong status, no link, etc.).\r\n */\r\nexport class GDriveDownloadError extends Error {\r\n  readonly statusCode: number | undefined;\r\n  readonly fileId: string | undefined;\r\n\r\n  constructor(\r\n    message: string,\r\n    options?: { cause?: unknown; statusCode?: number; fileId?: string }\r\n  ) {\r\n    super(message);\r\n    this.name = \"GDriveDownloadError\";\r\n    this.statusCode = options?.statusCode;\r\n    this.fileId = options?.fileId;\r\n    if (options?.cause !== undefined) {\r\n      this.cause = options.cause;\r\n    }\r\n    Object.setPrototypeOf(this, GDriveDownloadError.prototype);\r\n  }\r\n}\r\n","import { GDriveDownloadError } from \"./errors.js\";\r\n\r\nconst FILE_ID_REGEX = /\\/d\\/([a-zA-Z0-9_-]+)(?:\\/|$)/;\r\n\r\n/** Normalizes share link to file ID, or returns input if already an ID. */\r\nexport function toFileId(input: string): string {\r\n  const m = input.match(FILE_ID_REGEX);\r\n  return m ? m[1] : input;\r\n}\r\n\r\n/** Resolves direct download URL for a public file by ID. */\r\nexport async function getDownloadUrl(\r\n  fileId: string,\r\n  signal?: AbortSignal\r\n): Promise<string> {\r\n  const id = toFileId(fileId);\r\n  const res = await fetch(\r\n    `https://drive.google.com/uc?id=${encodeURIComponent(id)}&export=download`,\r\n    { redirect: \"manual\", signal }\r\n  );\r\n  if (res.status === 303) {\r\n    const loc = res.headers.get(\"Location\");\r\n    if (loc) return loc;\r\n    throw new GDriveDownloadError(\"303 without Location\", { statusCode: 303, fileId: id });\r\n  }\r\n  if (res.status === 200) {\r\n    const action = (await res.text()).match(/action=\"([^\"]+)\"/)?.[1];\r\n    if (action) return action;\r\n    throw new GDriveDownloadError(\"200 without form action\", { statusCode: 200, fileId: id });\r\n  }\r\n  throw new GDriveDownloadError(`Unexpected status ${res.status}`, { statusCode: res.status, fileId: id });\r\n}\r\n","export interface FileMetadata {\r\n  filename?: string;\r\n  size?: number;\r\n  mimeType?: string;\r\n  lastModified?: Date;\r\n}\r\n\r\nfunction parseFilename(h: string | null): string | undefined {\r\n  if (!h) return undefined;\r\n  const u = h.match(/filename\\*=UTF-8''([^;]+)/i);\r\n  if (u) {\r\n    try { return decodeURIComponent(u[1].trim()); } catch { return undefined; }\r\n  }\r\n  const q = h.match(/filename=\"([^\"]+)\"/);\r\n  return q ? q[1] : undefined;\r\n}\r\n\r\nfunction parseSize(headers: Headers): number | undefined {\r\n  const cl = headers.get(\"Content-Length\");\r\n  if (cl != null) { const n = parseInt(cl, 10); if (!Number.isNaN(n)) return n; }\r\n  const cr = headers.get(\"Content-Range\")?.match(/\\/\\s*(\\d+)/);\r\n  return cr ? parseInt(cr[1], 10) : undefined;\r\n}\r\n\r\nexport async function getMetadataFromUrl(\r\n  url: string,\r\n  signal?: AbortSignal\r\n): Promise<FileMetadata> {\r\n  const res = await fetch(url, { method: \"HEAD\", redirect: \"follow\", signal });\r\n  const headers = res.ok ? res.headers : (res.status === 405\r\n    ? (await fetch(url, { method: \"GET\", redirect: \"follow\", signal, headers: { Range: \"bytes=0-0\" } })).headers\r\n    : new Headers());\r\n  const cd = headers.get(\"Content-Disposition\");\r\n  const lm = headers.get(\"Last-Modified\");\r\n  const ct = headers.get(\"Content-Type\");\r\n  let lastModified: Date | undefined;\r\n  if (lm) { const d = new Date(lm); if (!Number.isNaN(d.getTime())) lastModified = d; }\r\n  return {\r\n    filename: parseFilename(cd),\r\n    size: parseSize(headers),\r\n    mimeType: ct ? ct.split(\";\")[0].trim() || undefined : undefined,\r\n    lastModified,\r\n  };\r\n}\r\n","const FOLDER_URL = \"https://drive.google.com/drive/folders/\";\r\nconst FOLDER_ID_REGEX = /\\/folders\\/([a-zA-Z0-9_-]+)/;\r\nconst SSK_FILE_ID = /ssk='[^']*:([a-zA-Z0-9_-]+)-0-1'/g;\r\n/** Row with data-id and filename in data-tooltip or <strong>. */\r\nconst TR_ID_NAME = /<tr[^>]*\\sdata-id=\"([a-zA-Z0-9_-]+)\"[^>]*>[\\s\\S]*?(?:data-tooltip=\"([^\"]+\\.(?:csv|txt|pdf|zip|json))\"|<strong[^>]*>([^<]+\\.(?:csv|txt|pdf|zip|json))<\\/strong>)/gi;\r\n\r\nexport interface ListFileEntry {\r\n  id: string;\r\n  name?: string;\r\n}\r\n\r\nfunction toFolderId(input: string): string {\r\n  const m = input.match(FOLDER_ID_REGEX);\r\n  return m ? m[1] : input;\r\n}\r\n\r\nexport async function listFiles(\r\n  folderLinkOrId: string,\r\n  signal?: AbortSignal\r\n): Promise<ListFileEntry[]> {\r\n  const folderId = toFolderId(folderLinkOrId);\r\n  const html = await (await fetch(`${FOLDER_URL}${encodeURIComponent(folderId)}`, { signal })).text();\r\n  const idToName = new Map<string, string>();\r\n  let tr: RegExpExecArray | null;\r\n  TR_ID_NAME.lastIndex = 0;\r\n  while ((tr = TR_ID_NAME.exec(html)) !== null) {\r\n    const id = tr[1];\r\n    const name = tr[2] || tr[3]?.trim();\r\n    if (name && !idToName.has(id)) idToName.set(id, name);\r\n  }\r\n  const seen = new Set<string>();\r\n  const out: ListFileEntry[] = [];\r\n  let m: RegExpExecArray | null;\r\n  SSK_FILE_ID.lastIndex = 0;\r\n  while ((m = SSK_FILE_ID.exec(html)) !== null) {\r\n    if (!seen.has(m[1])) {\r\n      seen.add(m[1]);\r\n      out.push({ id: m[1], name: idToName.get(m[1]) });\r\n    }\r\n  }\r\n  return out;\r\n}\r\n","export { GDriveDownloadError } from \"./errors.js\";\r\nexport { toFileId } from \"./resolve.js\";\r\nexport type { FileMetadata } from \"./metadata.js\";\r\nexport type { ListFileEntry } from \"./list.js\";\r\n\r\nimport { getDownloadUrl } from \"./resolve.js\";\r\nimport { getMetadataFromUrl } from \"./metadata.js\";\r\nimport { listFiles as listFilesInFolder } from \"./list.js\";\r\n\r\nexport interface CommonOptions {\r\n  signal?: AbortSignal;\r\n}\r\n\r\nexport async function listFiles(\r\n  folderId: string,\r\n  options?: CommonOptions\r\n): Promise<import(\"./list.js\").ListFileEntry[]> {\r\n  return listFilesInFolder(folderId, options?.signal);\r\n}\r\n\r\nexport async function getFile(\r\n  fileId: string,\r\n  format: \"blob\" | \"buffer\",\r\n  options?: CommonOptions\r\n): Promise<Blob | Buffer> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  const res = await fetch(url, { signal: options?.signal });\r\n  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);\r\n  if (format === \"buffer\") return Buffer.from(await res.arrayBuffer());\r\n  return res.blob();\r\n}\r\n\r\nexport async function getFileMetadata(\r\n  fileId: string,\r\n  options?: CommonOptions\r\n): Promise<import(\"./metadata.js\").FileMetadata> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  return getMetadataFromUrl(url, options?.signal);\r\n}\r\n\r\nexport async function downloadFile(\r\n  fileId: string,\r\n  path: string,\r\n  options?: CommonOptions\r\n): Promise<void> {\r\n  const url = await getDownloadUrl(fileId, options?.signal);\r\n  const res = await fetch(url, { signal: options?.signal });\r\n  if (!res.ok) throw new Error(`Fetch failed: ${res.status}`);\r\n  if (res.body == null) throw new Error(\"Response has no body\");\r\n  const { Readable } = await import(\"node:stream\");\r\n  const { createWriteStream } = await import(\"node:fs\");\r\n  const { pipeline } = await import(\"node:stream/promises\");\r\n  const nodeReadable = Readable.fromWeb(res.body as Parameters<typeof Readable.fromWeb>[0]);\r\n  const dest = createWriteStream(path);\r\n  await pipeline(nodeReadable, dest);\r\n}\r\n"],"mappings":"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","names":["listFiles"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "better-gdrive",
+  "version": "0.1.0",
+  "description": "Download files from public Google Drive. Get direct download URLs or fetch as Blob/Buffer. No OAuth required.",
+  "keywords": [
+    "google-drive",
+    "download",
+    "drive",
+    "public",
+    "file",
+    "blob",
+    "fetch",
+    "no-oauth"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sn4tchZ/better-gdrive.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Sn4tchZ/better-gdrive/issues"
+  },
+  "homepage": "https://github.com/Sn4tchZ/better-gdrive#readme",
+  "author": "Sn4tchZ",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test:behavior": "node scripts/test-gdrive-behavior.mjs",
+    "probe": "node scripts/fetch-probe.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}