@braidhq/source-loader-gdrive 0.0.1 → 0.2.0

package/README.md

@@ -0,0 +1,42 @@
+# @braidhq/source-loader-gdrive
+
+Braid keeps a product's intent and its code aligned in one knowledge graph, and lets plugins feed that graph from outside sources. `@braidhq/source-loader-gdrive` is the plugin that exports Google Docs from a Drive folder as markdown, so a team's design docs become a Braid source.
+
+## Role
+
+The drive loader walks a Drive folder, exports every Google Doc it finds as markdown, and keeps a manifest so later syncs touch only what changed.
+
+- **The Export**: Each doc is exported to `<destination>/<sanitised-title>/index.md`, and its inlined base64 images are decoded into sibling files, so the markdown stays readable for humans and models.
+- **The Manifest**: A `.braid-gdrive-manifest.json` records each doc's id, title, and modified time, so sync can add, update, rename, or remove docs against the prior state instead of re-downloading everything.
+- **The Auth**: A fresh OAuth access token is resolved per workspace and source through an injected callback, so credentials stay in the composition root, never in config.
+
+## Structure
+
+```
+src/
+├── GoogleDriveSourceLoaderPlugin.ts   the gdrive loader, config, walk, export, manifest-diff sync
+├── DriveClient.ts                     the Drive REST client, list children and export a doc
+├── Manifest.ts                        the on-disk sync-state manifest, read and write
+└── index.ts                           re-exports the factory and its config type
+```
+
+- **GoogleDriveSourceLoaderPlugin**: The `createGoogleDriveLoader` factory. It walks the folder, filters by title, exports each doc, extracts inline images, and diffs against the manifest on sync.
+- **DriveClient**: The thin Drive REST wrapper, listing folder children and exporting a doc to a given mime type.
+- **Manifest**: The read and write of `.braid-gdrive-manifest.json`, the record sync diffs against.
+
+## Export and Layout
+
+Drive folder hierarchy is flattened. Every matched doc lands in its own directory directly under the destination, named from the sanitised Drive title, so two docs that sanitise to the same name collide and one must be renamed in Drive. Auto-created `Copy of` duplicates are skipped, and title `include` and `exclude` regexes narrow what is exported while subfolders are still traversed when `recursive` is set.
+
+Only Google Docs are in scope. Sheets, Slides, Drawings, and Forms are left for a different plugin. The `folderId` alias `root` is rejected outright, since it would mirror an entire My Drive.
+
+## Boundaries
+
+- **Owns Its Directory**: The destination and its manifest are the loader's to write. Provision wipes and rebuilds it, sync reconciles it against Drive.
+- **No Credentials On Disk**: The access token is resolved at run time through the injected callback. Only exported markdown and images land in the destination.
+- **A Plugin, Not A Service**: It implements core's `SourceLoader` port through the sdk factory, and depends on the host to supply OAuth token resolution.
+
+## Dependencies
+
+- **Depends On**: `@braidhq/core` for the port, `@braidhq/schema` for shared types, `@braidhq/sdk` for the factory, and `zod`.
+- **Consumed By**: The server composition root, where `composeFsApp` registers the gdrive loader and wires `resolveAccessToken` to its OAuth store.

package/dist/{driveClient.d.ts → DriveClient.d.ts}

@@ -3,7 +3,7 @@ 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.
+ * Inject `fetchFn` for tests. Real callers use globalThis.fetch.
  */
 export type FetchFn = typeof globalThis.fetch;
 export interface DriveFileMetadata {
@@ -21,8 +21,8 @@ export declare class DriveClient {
     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. */
+    /** Download a binary file (image, PDF, and so on) as-is. */
     downloadFile(fileId: string): Promise<Buffer>;
     private authHeader;
 }
-//# sourceMappingURL=driveClient.d.ts.map
+//# sourceMappingURL=DriveClient.d.ts.map

package/dist/{driveClient.d.ts.map → DriveClient.d.ts.map}

@@ -1 +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"}
+{"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,4DAA4D;IACtD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnD,OAAO,CAAC,UAAU;CAGnB"}

package/dist/{driveClient.js → DriveClient.js}

@@ -39,7 +39,7 @@ export class DriveClient {
             throw await driveError(response, `exportDoc(${fileId},${mimeType})`);
         return globalBuffer().from(await response.arrayBuffer());
     }
-    /** Download a binary file (image, PDF, …) as-is. */
+    /** Download a binary file (image, PDF, and so on) 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() });
@@ -55,4 +55,4 @@ 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
+//# sourceMappingURL=DriveClient.js.map

package/dist/{driveClient.js.map → DriveClient.js.map}

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

package/dist/GoogleDriveSourceLoaderPlugin.d.ts

@@ -0,0 +1,46 @@
+import type { SourceLoaderContext, SourceLoaderPlugin } from '@braidhq/core';
+import { z } from 'zod';
+import { type DriveFileMetadata, type FetchFn } from './DriveClient.js';
+export declare const GoogleDriveLoaderConfig: z.ZodObject<{
+    folderId: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    include: z.ZodOptional<z.ZodString>;
+    exclude: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+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;
+}
+/**
+ * Build a Google Drive source loader. Walks a Drive folder, exports every
+ * Google Doc inside as markdown, extracts inlined base64 images into
+ * sibling files, and lays everything out as:
+ *
+ *   <destination>/
+ *     <sanitised-doc-title>/
+ *       index.md
+ *       <image-label>.png       (one per inlined image)
+ *     <sanitised-doc-title-2>/
+ *       index.md
+ *     .braid-gdrive-manifest.json      (sync state)
+ *
+ * Drive folder hierarchy is not preserved on disk.
+ * Every matched doc is flattened into a sibling directory under `destination/`.
+ * Two docs with the same sanitised title will collide,
+ * so rename one in Drive to disambiguate.
+ *
+ * Out of scope (intentional): Google Sheets, Slides, Drawings, Forms, and standalone binaries.
+ * Mirrors redoc's PRD-focused workflow.
+ * When you need spreadsheets or slide decks, provision them through a different source-loader plugin.
+ */
+export declare function createGoogleDriveLoader(deps: GoogleDriveLoaderDeps): SourceLoaderPlugin;
+/** Note: the helper used by DriveClient.exportDoc returns Buffer. */
+export type { DriveFileMetadata, FetchFn };
+//# sourceMappingURL=GoogleDriveSourceLoaderPlugin.d.ts.map

package/dist/GoogleDriveSourceLoaderPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDriveSourceLoaderPlugin.d.ts","sourceRoot":"","sources":["../src/GoogleDriveSourceLoaderPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAK5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AA4BpF,eAAO,MAAM,uBAAuB;;;;;iBAiClC,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;AAaD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CAgHvF;AA+GD,qEAAqE;AACrE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAA"}

package/dist/GoogleDriveSourceLoaderPlugin.js

@@ -0,0 +1,289 @@
+import { Buffer } from 'node:buffer';
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineSourceLoaderPlugin } from '@braidhq/sdk';
+import { z } from 'zod';
+import { DriveClient } from './DriveClient.js';
+import { readManifest, writeManifest } from './Manifest.js';
+const FOLDER_MIME = 'application/vnd.google-apps.folder';
+const DOC_MIME = 'application/vnd.google-apps.document';
+/**
+ * Drive auto-creates duplicates named "Copy of" (English) or ending in "的副本" (Chinese),
+ * when users use the Make a Copy menu.
+ * They almost always carry stale content that would conflict with the canonical doc,
+ * so we skip them silently. Same rule as redoc.
+ */
+const COPY_PATTERNS = [/^Copy of /, /的副本$/];
+/**
+ * Drive's `text/markdown` export inlines images as base64 data URIs,
+ * in reference-style link form:
+ *
+ *   [image0]: <data:image/png;base64,iVBORw0KG...>
+ *
+ * Leaving those base64 blobs in the markdown bloats the file by ~33 % per image,
+ * and is unreadable for both humans and LLMs.
+ * This regex matches one such reference line,
+ * so we can extract the image to its own file and rewrite the link to a relative path.
+ * Same approach as redoc.
+ */
+const INLINE_IMAGE_RE = /^\[([^\]]+)\]:\s*<data:image\/([\w+]+);base64,([^>]+)>$/gm;
+export const GoogleDriveLoaderConfig = z.object({
+    /**
+     * Drive folder id (the long alphanumeric in the URL).
+     * Reject the alias `root` outright,
+     * since 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 and 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 traverse subfolders. Default true.
+     * Subfolder hierarchy is not preserved on disk.
+     * Every matching doc lives in its own dir directly under `destination/`.
+     * Disable to limit to immediate children of `folderId`.
+     */
+    recursive: z.boolean().default(true),
+    /**
+     * Optional regex (string).
+     * When set, only docs whose *Drive title* matches this pattern are downloaded.
+     * Subfolders are still traversed.
+     */
+    include: z.string().optional(),
+    /**
+     * Optional regex (string).
+     * When set, docs whose title matches are skipped.
+     * Evaluated after `include`, so exclude takes priority.
+     */
+    exclude: z.string().optional(),
+});
+/**
+ * Build a Google Drive source loader. Walks a Drive folder, exports every
+ * Google Doc inside as markdown, extracts inlined base64 images into
+ * sibling files, and lays everything out as:
+ *
+ *   <destination>/
+ *     <sanitised-doc-title>/
+ *       index.md
+ *       <image-label>.png       (one per inlined image)
+ *     <sanitised-doc-title-2>/
+ *       index.md
+ *     .braid-gdrive-manifest.json      (sync state)
+ *
+ * Drive folder hierarchy is not preserved on disk.
+ * Every matched doc is flattened into a sibling directory under `destination/`.
+ * Two docs with the same sanitised title will collide,
+ * so rename one in Drive to disambiguate.
+ *
+ * Out of scope (intentional): Google Sheets, Slides, Drawings, Forms, and standalone binaries.
+ * Mirrors redoc's PRD-focused workflow.
+ * When you need spreadsheets or slide decks, provision them through a different source-loader plugin.
+ */
+export function createGoogleDriveLoader(deps) {
+    return defineSourceLoaderPlugin({
+        kind: 'gdrive',
+        configSchema: GoogleDriveLoaderConfig,
+        provision: async (config, destination, context) => {
+            await rm(destination, { recursive: true, force: true });
+            await mkdir(destination, { recursive: true });
+            const client = await buildClient(deps, context);
+            const candidates = await walk(client, config);
+            const manifest = {
+                folderId: config.folderId,
+                include: config.include,
+                exclude: config.exclude,
+                files: {},
+            };
+            for (const doc of candidates) {
+                await downloadOne(client, doc, destination);
+                manifest.files[doc.id] = entryOf(doc);
+            }
+            await writeManifest(destination, manifest);
+            return {
+                localPath: destination,
+                metadata: { folderId: config.folderId, fileCount: candidates.length },
+                fetchedAt: new Date().toISOString(),
+            };
+        },
+        sync: async (config, destination, context) => {
+            const cached = await readManifest(destination);
+            if (!cached) {
+                // No manifest yet (first sync after upgrade or cache wiped).
+                // Fall back to a clean provision so we end up in a known-good state.
+                const client = await buildClient(deps, context);
+                await rm(destination, { recursive: true, force: true });
+                await mkdir(destination, { recursive: true });
+                const candidates = await walk(client, config);
+                const manifest = {
+                    folderId: config.folderId,
+                    include: config.include,
+                    exclude: config.exclude,
+                    files: {},
+                };
+                for (const doc of candidates) {
+                    await downloadOne(client, doc, destination);
+                    manifest.files[doc.id] = entryOf(doc);
+                }
+                await writeManifest(destination, manifest);
+                return {
+                    changed: true,
+                    added: candidates.length,
+                    updated: 0,
+                    removed: 0,
+                    unchanged: 0,
+                    metadata: { folderId: config.folderId, fileCount: candidates.length },
+                    fetchedAt: new Date().toISOString(),
+                };
+            }
+            const client = await buildClient(deps, context);
+            const candidates = await walk(client, config);
+            const seen = new Set();
+            let added = 0;
+            let updated = 0;
+            let unchanged = 0;
+            const next = {
+                folderId: config.folderId,
+                include: config.include,
+                exclude: config.exclude,
+                files: {},
+            };
+            for (const doc of candidates) {
+                seen.add(doc.id);
+                const prior = cached.files[doc.id];
+                if (!prior) {
+                    await downloadOne(client, doc, destination);
+                    added++;
+                }
+                else if (prior.localDir !== doc.localDir || prior.modifiedTime !== doc.modifiedTime) {
+                    // Either content updated or the doc was renamed in Drive.
+                    // Both cases re-download to the new dir, then rm the old dir.
+                    if (prior.localDir !== doc.localDir)
+                        await rm(join(destination, prior.localDir), { recursive: true, force: true });
+                    await downloadOne(client, doc, destination);
+                    updated++;
+                }
+                else {
+                    unchanged++;
+                }
+                next.files[doc.id] = entryOf(doc);
+            }
+            let removed = 0;
+            for (const [id, entry] of Object.entries(cached.files)) {
+                if (seen.has(id))
+                    continue;
+                await rm(join(destination, entry.localDir), { recursive: true, force: true });
+                removed++;
+            }
+            await writeManifest(destination, next);
+            return {
+                changed: added + updated + removed > 0,
+                added,
+                updated,
+                removed,
+                unchanged,
+                metadata: { folderId: config.folderId },
+                fetchedAt: new Date().toISOString(),
+            };
+        },
+    });
+}
+async function buildClient(deps, context) {
+    const token = await deps.resolveAccessToken(context);
+    return new DriveClient(token, deps.fetchFn);
+}
+async function walk(client, config) {
+    const includeRe = compileRegex(config.include, 'include');
+    const excludeRe = compileRegex(config.exclude, 'exclude');
+    const out = [];
+    const seenDirs = new Map(); // localDir -> first doc id, to detect collisions
+    const visit = async (folderId) => {
+        const children = await client.listChildren(folderId);
+        for (const child of children) {
+            if (child.mimeType === FOLDER_MIME) {
+                if (config.recursive)
+                    await visit(child.id);
+                continue;
+            }
+            if (child.mimeType !== DOC_MIME)
+                continue;
+            if (COPY_PATTERNS.some(re => re.test(child.name)))
+                continue;
+            if (includeRe && !includeRe.test(child.name))
+                continue;
+            if (excludeRe && excludeRe.test(child.name))
+                continue;
+            const localDir = sanitiseName(child.name);
+            const collides = seenDirs.get(localDir);
+            if (collides && collides !== child.id) {
+                // Two distinct Drive docs sanitise to the same dir name.
+                // Keep the first one we walked into.
+                // Skipping the second is safer than silently overwriting.
+                // User can rename in Drive.
+                continue;
+            }
+            seenDirs.set(localDir, child.id);
+            out.push({
+                id: child.id,
+                title: child.name,
+                modifiedTime: child.modifiedTime,
+                localDir,
+            });
+        }
+    };
+    await visit(config.folderId);
+    return out;
+}
+async function downloadOne(client, doc, destination) {
+    const docDir = join(destination, doc.localDir);
+    // Clean any prior content for this doc so removed images don't linger.
+    await rm(docDir, { recursive: true, force: true });
+    await mkdir(docDir, { recursive: true });
+    const bytes = await client.exportDoc(doc.id, 'text/markdown');
+    const markdown = bytes.toString('utf-8');
+    const rewritten = await extractInlineImages(markdown, docDir);
+    await writeFile(join(docDir, 'index.md'), rewritten, 'utf-8');
+}
+/**
+ * Pull every `[label]: <data:image/ext;base64,...>` reference out of the markdown,
+ * write the decoded bytes as `<label>.<ext>` in `docDir`,
+ * and rewrite the reference to point at the new local file.
+ * Returns the cleaned markdown. Matches redoc's behaviour.
+ */
+async function extractInlineImages(markdown, docDir) {
+    const writes = [];
+    const rewritten = markdown.replace(INLINE_IMAGE_RE, (_match, label, ext, data) => {
+        const filename = `${sanitiseName(label)}.${ext}`;
+        writes.push(writeFile(join(docDir, filename), Buffer.from(data, 'base64')));
+        return `[${label}]: <${filename}>`;
+    });
+    await Promise.all(writes);
+    return rewritten;
+}
+function compileRegex(pattern, field) {
+    if (!pattern)
+        return undefined;
+    try {
+        return new RegExp(pattern);
+    }
+    catch (err) {
+        throw new Error(`googleDriveLoader: ${field} is not a valid regex (${err.message})`);
+    }
+}
+function entryOf(doc) {
+    return {
+        localDir: doc.localDir,
+        modifiedTime: doc.modifiedTime,
+        title: doc.title,
+    };
+}
+function sanitiseName(name) {
+    // Replace path separators, control chars, and common shell-hostile characters with `_`.
+    // Spaces stay so human-readable titles survive,
+    // for example "Roadmap Q3 2026" stays "Roadmap Q3 2026".
+    return name.replace(/[/\\:*?"<>|]/g, '_');
+}
+//# sourceMappingURL=GoogleDriveSourceLoaderPlugin.js.map

package/dist/GoogleDriveSourceLoaderPlugin.js.map

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

package/dist/Manifest.d.ts

@@ -0,0 +1,24 @@
+/** Filename written inside `destination` to track per-file sync state. */
+export declare const MANIFEST_FILENAME = ".braid-gdrive-manifest.json";
+export interface ManifestEntry {
+    /** Posix relative dir under `destination`, the per-doc package. */
+    localDir: string;
+    modifiedTime: string;
+    /** Drive title at the time of the last sync, for debugging only. */
+    title: string;
+}
+export interface Manifest {
+    folderId: string;
+    include: string | undefined;
+    exclude: string | undefined;
+    files: Record<string, ManifestEntry>;
+}
+/**
+ * Read the manifest file from `destination`.
+ * Returns `undefined` when the file is missing or unparseable.
+ * Callers fall back to a clean provision in that case,
+ * since no manifest means no incremental state to diff against.
+ */
+export declare function readManifest(destination: string): Promise<Manifest | undefined>;
+export declare function writeManifest(destination: string, manifest: Manifest): Promise<void>;
+//# sourceMappingURL=Manifest.d.ts.map

package/dist/Manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../src/Manifest.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAE9D,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAQrF;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F"}

package/dist/Manifest.js

@@ -0,0 +1,23 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Filename written inside `destination` to track per-file sync state. */
+export const MANIFEST_FILENAME = '.braid-gdrive-manifest.json';
+/**
+ * Read the manifest file from `destination`.
+ * Returns `undefined` when the file is missing or unparseable.
+ * Callers fall back to a clean provision in that case,
+ * since no manifest means no incremental state to diff against.
+ */
+export async function readManifest(destination) {
+    try {
+        const raw = await readFile(join(destination, MANIFEST_FILENAME), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function writeManifest(destination, manifest) {
+    await writeFile(join(destination, MANIFEST_FILENAME), `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=Manifest.js.map

package/dist/Manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manifest.js","sourceRoot":"","sources":["../src/Manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAA;AAiB9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAA;QACzE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAA;IACpC,CAAC;IACD,MAAM,CAAC;QACL,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,QAAkB;IACzE,MAAM,SAAS,CACb,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,EACpC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACxC,OAAO,CACR,CAAA;AACH,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/package.json

@@ -1,37 +1,49 @@
 {
   "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.",
+  "version": "0.2.0",
+  "description": "Google Drive source-loader plugin for Braid. Export docs from Google Drive, requires OAuth on first use.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mroops0111/braid.git",
+    "directory": "packages/source-loader-gdrive"
+  },
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
+    ".": "./src/index.ts"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "files": [
     "README.md",
     "dist"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
+    "test": "vitest run --coverage",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo coverage"
+  },
   "dependencies": {
-    "zod": "^3.24.0",
-    "@braidhq/core": "0.0.1",
-    "@braidhq/schema": "0.0.1"
+    "@braidhq/core": "workspace:*",
+    "@braidhq/schema": "workspace:*",
+    "@braidhq/sdk": "workspace:*",
+    "zod": "^4.2.1"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
-    "vitest": "^2.1.0"
+    "@braidhq/test-utils": "workspace:*",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "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"
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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

@@ -1,80 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,125 +0,0 @@
-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

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