@rocketbean/genera-gdrive

@rocketbean/genera-gdrive

Google Drive driver for Genera.

A storage driver for Genera — one API for every cloud storage provider. Drive it through the same put / get / list / delete / exists contract as every other Genera driver.

Install

npm install @rocketbean/genera @rocketbean/genera-gdrive @googleapis/drive
# auth helper (if not already present):
npm install google-auth-library

@googleapis/drive is a peer dependency.

Quick start

import { createStorage } from "@rocketbean/genera";
import { GoogleDriveDriver } from "@rocketbean/genera-gdrive";
import { OAuth2Client } from "google-auth-library";

// clientId + clientSecret from your Google Cloud OAuth 2.0 client.
const auth = new OAuth2Client({
  clientId: process.env.GOOGLE_CLIENT_ID,
  clientSecret: process.env.GOOGLE_CLIENT_SECRET,
});

// A refresh token obtained once via the consent flow (access_type=offline,
// scope https://www.googleapis.com/auth/drive). The library refreshes access
// tokens from it automatically.
auth.setCredentials({ refresh_token: process.env.GOOGLE_REFRESH_TOKEN });

const storage = createStorage(new GoogleDriveDriver({ auth }));

await storage.put("docs/readme.txt", "hello");
const bytes = await storage.get("docs/readme.txt"); // Uint8Array
for await (const entry of storage.list("docs")) console.log(entry.path);
await storage.delete("docs/readme.txt");

At a glance

Drive permits same-name siblings in a folder; the onAmbiguous policy controls how that's handled. Streamed uploads pipe straight to the SDK's resumable upload. Native Google Docs/Sheets must be fetched with the driver's export(path, mimeType) method rather than get().

Configuration

Full docs — every option, the complete capability matrix, auth, and the isomorphism rules — live in the Genera README and docs/capability-matrix.md.

License

MIT rocketbean