@braidhq/source-loader-gdrive 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mroops0111
+
+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/dist/GoogleDriveLoader.d.ts

@@ -0,0 +1,80 @@
+import type { IngestReport, SourceLoader, SourceLoaderContext, SyncReport } from '@braidhq/core';
+import type { AbsolutePath, LoaderKind, PluginId } from '@braidhq/schema';
+import { z } from 'zod';
+import { type FetchFn } from './driveClient.js';
+export declare const GoogleDriveLoaderConfig: z.ZodObject<{
+    /**
+     * Drive folder id (the long alphanumeric in the URL). Reject the alias
+     * `root` outright: it expands to the user's entire My Drive and would
+     * mirror every file they own, which is almost never what someone wants
+     * from an "intent docs" source and easily costs gigabytes + minutes.
+     * Make people pick a specific subfolder.
+     */
+    folderId: z.ZodEffects<z.ZodString, string, string>;
+    /**
+     * Whether to follow subfolders recursively. Default true. Disable for
+     * flat folder mirrors where nested folders should be skipped.
+     */
+    recursive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    folderId: string;
+    recursive: boolean;
+}, {
+    folderId: string;
+    recursive?: boolean | undefined;
+}>;
+export type GoogleDriveLoaderConfig = z.infer<typeof GoogleDriveLoaderConfig>;
+export interface GoogleDriveLoaderDeps {
+    /**
+     * Resolve a fresh access token for a given `(workspaceId, sourceId)`.
+     * The composition root implements this against its OAuth refresh-token
+     * store; tests can return a static token regardless of context.
+     */
+    resolveAccessToken: (context: SourceLoaderContext) => Promise<string>;
+    /** Inject for tests. Real callers use globalThis.fetch. */
+    fetchFn?: FetchFn;
+}
+/**
+ * Google Drive source loader. Walks a Drive folder, exports Google-native
+ * docs to text/markdown/csv/pdf depending on type, downloads binaries
+ * (images, PDFs) as-is, and mirrors the folder layout under `destination/`.
+ *
+ * Loader owns destination contents: it `rm -rf`'s `destination` on each
+ * `ingest` so previously-fetched files don't linger. `sync` re-walks and
+ * compares modifiedTime per file; reports `changed = true` if any file
+ * was added / updated / removed.
+ */
+export declare class GoogleDriveLoader implements SourceLoader {
+    private readonly deps;
+    readonly id: PluginId;
+    readonly type: "source-loader";
+    readonly kind: LoaderKind;
+    readonly configSchema: z.ZodObject<{
+        /**
+         * Drive folder id (the long alphanumeric in the URL). Reject the alias
+         * `root` outright: it expands to the user's entire My Drive and would
+         * mirror every file they own, which is almost never what someone wants
+         * from an "intent docs" source and easily costs gigabytes + minutes.
+         * Make people pick a specific subfolder.
+         */
+        folderId: z.ZodEffects<z.ZodString, string, string>;
+        /**
+         * Whether to follow subfolders recursively. Default true. Disable for
+         * flat folder mirrors where nested folders should be skipped.
+         */
+        recursive: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        folderId: string;
+        recursive: boolean;
+    }, {
+        folderId: string;
+        recursive?: boolean | undefined;
+    }>;
+    constructor(deps: GoogleDriveLoaderDeps);
+    ingest(rawConfig: unknown, destination: AbsolutePath, context: SourceLoaderContext): Promise<IngestReport>;
+    sync(rawConfig: unknown, destination: AbsolutePath, context: SourceLoaderContext): Promise<SyncReport>;
+    private client;
+    private walk;
+    private writeOneFile;
+}
+//# sourceMappingURL=GoogleDriveLoader.d.ts.map

package/dist/GoogleDriveLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDriveLoader.d.ts","sourceRoot":"","sources":["../src/GoogleDriveLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAiBpF,eAAO,MAAM,uBAAuB;IAClC;;;;;;OAMG;;IAMH;;;OAGG;;;;;;;;EAEH,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACrE,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAMxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,QAAQ,CAAC,EAAE,EAA6B,QAAQ,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,IAAI,EAAe,UAAU,CAAA;IACtC,QAAQ,CAAC,YAAY;QA7CrB;;;;;;WAMG;;QAMH;;;WAGG;;;;;;;;OA8B4C;gBAElB,IAAI,EAAE,qBAAqB;IAElD,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAa1G,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;YAa9F,MAAM;YAKN,IAAI;YAyBJ,YAAY;CAoB3B"}

package/dist/GoogleDriveLoader.js

@@ -0,0 +1,125 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { DriveClient } from './driveClient.js';
+const FOLDER_MIME = 'application/vnd.google-apps.folder';
+/**
+ * Map of Google-native mime types to (Drive export format, filename
+ * extension we write to disk). Skip everything else: only Drive
+ * "applications" need exporting. Regular binaries (images, PDFs, etc.)
+ * go through `downloadFile`.
+ */
+const GOOGLE_NATIVE_EXPORT = {
+    'application/vnd.google-apps.document': { mimeType: 'text/markdown', extension: '.md' },
+    'application/vnd.google-apps.spreadsheet': { mimeType: 'text/csv', extension: '.csv' },
+    'application/vnd.google-apps.presentation': { mimeType: 'application/pdf', extension: '.pdf' },
+    'application/vnd.google-apps.drawing': { mimeType: 'image/png', extension: '.png' },
+};
+export const GoogleDriveLoaderConfig = z.object({
+    /**
+     * Drive folder id (the long alphanumeric in the URL). Reject the alias
+     * `root` outright: it expands to the user's entire My Drive and would
+     * mirror every file they own, which is almost never what someone wants
+     * from an "intent docs" source and easily costs gigabytes + minutes.
+     * Make people pick a specific subfolder.
+     */
+    folderId: z.string()
+        .min(1)
+        .refine(value => value !== 'root', {
+        message: 'folderId "root" refers to the entire My Drive and is rejected. Create a dedicated subfolder and use its id instead.',
+    }),
+    /**
+     * Whether to follow subfolders recursively. Default true. Disable for
+     * flat folder mirrors where nested folders should be skipped.
+     */
+    recursive: z.boolean().default(true),
+});
+/**
+ * Google Drive source loader. Walks a Drive folder, exports Google-native
+ * docs to text/markdown/csv/pdf depending on type, downloads binaries
+ * (images, PDFs) as-is, and mirrors the folder layout under `destination/`.
+ *
+ * Loader owns destination contents: it `rm -rf`'s `destination` on each
+ * `ingest` so previously-fetched files don't linger. `sync` re-walks and
+ * compares modifiedTime per file; reports `changed = true` if any file
+ * was added / updated / removed.
+ */
+export class GoogleDriveLoader {
+    deps;
+    id = 'source-loader-gdrive';
+    type = 'source-loader';
+    kind = 'gdrive';
+    configSchema = GoogleDriveLoaderConfig;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async ingest(rawConfig, destination, context) {
+        const config = GoogleDriveLoaderConfig.parse(rawConfig);
+        await rm(destination, { recursive: true, force: true });
+        await mkdir(destination, { recursive: true });
+        const client = await this.client(context);
+        const result = await this.walk(client, config.folderId, destination, { recursive: config.recursive });
+        return {
+            localPath: destination,
+            metadata: { folderId: config.folderId, fileCount: result.fileCount },
+            fetchedAt: new Date().toISOString(),
+        };
+    }
+    async sync(rawConfig, destination, context) {
+        // v0.1: incremental sync needs per-file mtime cache. Until we add
+        // that, sync is "blow away + re-ingest". Always safe, just slow.
+        const config = GoogleDriveLoaderConfig.parse(rawConfig);
+        const before = Date.now();
+        await this.ingest(config, destination, context);
+        return {
+            changed: true,
+            metadata: { folderId: config.folderId, syncedAt: new Date(before).toISOString() },
+            fetchedAt: new Date().toISOString(),
+        };
+    }
+    async client(context) {
+        const token = await this.deps.resolveAccessToken(context);
+        return new DriveClient(token, this.deps.fetchFn);
+    }
+    async walk(client, folderId, destination, options) {
+        let fileCount = 0;
+        const children = await client.listChildren(folderId);
+        for (const child of children) {
+            if (child.mimeType === FOLDER_MIME) {
+                if (!options.recursive)
+                    continue;
+                const subDest = join(destination, sanitiseName(child.name));
+                await mkdir(subDest, { recursive: true });
+                const nested = await this.walk(client, child.id, subDest, options);
+                fileCount += nested.fileCount;
+                continue;
+            }
+            const written = await this.writeOneFile(client, child, destination);
+            if (written)
+                fileCount++;
+        }
+        return { fileCount };
+    }
+    async writeOneFile(client, file, destination) {
+        const exportSpec = GOOGLE_NATIVE_EXPORT[file.mimeType];
+        if (exportSpec) {
+            const bytes = await client.exportDoc(file.id, exportSpec.mimeType);
+            const filename = `${sanitiseName(file.name)}${exportSpec.extension}`;
+            await writeFile(join(destination, filename), bytes);
+            return true;
+        }
+        // Skip native Drive types we don't have an export for (e.g. forms).
+        if (file.mimeType.startsWith('application/vnd.google-apps.'))
+            return false;
+        // Regular binary: download as-is, preserve the name.
+        const bytes = await client.downloadFile(file.id);
+        await writeFile(join(destination, sanitiseName(file.name)), bytes);
+        return true;
+    }
+}
+function sanitiseName(name) {
+    // Replace path separators and control chars; leave the rest alone so
+    // human-readable filenames survive ('My Doc — v3.md').
+    return name.replace(/[/\\]/g, '_');
+}
+//# sourceMappingURL=GoogleDriveLoader.js.map

package/dist/GoogleDriveLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDriveLoader.js","sourceRoot":"","sources":["../src/GoogleDriveLoader.ts"],"names":[],"mappings":"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"}

package/dist/driveClient.d.ts

@@ -0,0 +1,28 @@
+import { Buffer } from 'node:buffer';
+/**
+ * Tiny Google Drive v3 client wrapper. We only use a few endpoints and
+ * don't need the full `googleapis` package (which ships > 1 MB of types).
+ *
+ * Inject `fetchFn` for tests; real callers use globalThis.fetch.
+ */
+export type FetchFn = typeof globalThis.fetch;
+export interface DriveFileMetadata {
+    readonly id: string;
+    readonly name: string;
+    readonly mimeType: string;
+    readonly modifiedTime: string;
+    readonly parents?: readonly string[];
+}
+export declare class DriveClient {
+    private readonly accessToken;
+    private readonly fetchFn;
+    constructor(accessToken: string, fetchFn?: FetchFn);
+    /** List immediate children of a folder. Paginated. */
+    listChildren(folderId: string): Promise<readonly DriveFileMetadata[]>;
+    /** Export a Google native doc (gdoc / gsheet / gslides) to a chosen format. */
+    exportDoc(fileId: string, mimeType: string): Promise<Buffer>;
+    /** Download a binary file (image, PDF, …) as-is. */
+    downloadFile(fileId: string): Promise<Buffer>;
+    private authHeader;
+}
+//# sourceMappingURL=driveClient.d.ts.map

package/dist/driveClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driveClient.d.ts","sourceRoot":"","sources":["../src/driveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAMpC;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,UAAU,CAAC,KAAK,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAA0B;IAGtD,sDAAsD;IAChD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAsB3E,+EAA+E;IACzE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,oDAAoD;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnD,OAAO,CAAC,UAAU;CAGnB"}

package/dist/driveClient.js

@@ -0,0 +1,58 @@
+import { Buffer } from 'node:buffer';
+function globalBuffer() {
+    return Buffer;
+}
+export class DriveClient {
+    accessToken;
+    fetchFn;
+    constructor(accessToken, fetchFn = globalThis.fetch) {
+        this.accessToken = accessToken;
+        this.fetchFn = fetchFn;
+    }
+    /** List immediate children of a folder. Paginated. */
+    async listChildren(folderId) {
+        const items = [];
+        let pageToken;
+        do {
+            const params = new URLSearchParams({
+                q: `'${folderId}' in parents and trashed=false`,
+                fields: 'nextPageToken,files(id,name,mimeType,modifiedTime,parents)',
+                pageSize: '1000',
+            });
+            if (pageToken)
+                params.set('pageToken', pageToken);
+            const url = `https://www.googleapis.com/drive/v3/files?${params.toString()}`;
+            const response = await this.fetchFn(url, { headers: this.authHeader() });
+            if (!response.ok)
+                throw await driveError(response, `listChildren(${folderId})`);
+            const data = await response.json();
+            items.push(...data.files);
+            pageToken = data.nextPageToken;
+        } while (pageToken);
+        return items;
+    }
+    /** Export a Google native doc (gdoc / gsheet / gslides) to a chosen format. */
+    async exportDoc(fileId, mimeType) {
+        const url = `https://www.googleapis.com/drive/v3/files/${fileId}/export?${new URLSearchParams({ mimeType })}`;
+        const response = await this.fetchFn(url, { headers: this.authHeader() });
+        if (!response.ok)
+            throw await driveError(response, `exportDoc(${fileId},${mimeType})`);
+        return globalBuffer().from(await response.arrayBuffer());
+    }
+    /** Download a binary file (image, PDF, …) as-is. */
+    async downloadFile(fileId) {
+        const url = `https://www.googleapis.com/drive/v3/files/${fileId}?alt=media`;
+        const response = await this.fetchFn(url, { headers: this.authHeader() });
+        if (!response.ok)
+            throw await driveError(response, `downloadFile(${fileId})`);
+        return globalBuffer().from(await response.arrayBuffer());
+    }
+    authHeader() {
+        return { Authorization: `Bearer ${this.accessToken}` };
+    }
+}
+async function driveError(response, op) {
+    const text = await response.text().catch(() => '');
+    return new Error(`Drive ${op} failed: ${response.status} ${response.statusText} ${text}`);
+}
+//# sourceMappingURL=driveClient.js.map

package/dist/driveClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driveClient.js","sourceRoot":"","sources":["../src/driveClient.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './driveClient.js';
+export * from './GoogleDriveLoader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './driveClient.js';
+export * from './GoogleDriveLoader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@braidhq/source-loader-gdrive",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "Google Drive source-loader plugin: download text + images from a Drive folder into a workspace source path.",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.24.0",
+    "@braidhq/core": "0.0.1",
+    "@braidhq/schema": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo coverage"
+  }
+}