@marcfargas/go-easy 0.0.1 → 0.3.0

package/dist/drive/index.js

@@ -0,0 +1,418 @@
+/**
+ * Drive module — list, search, download, upload, share, and manage files.
+ *
+ * All functions take an OAuth2Client as first argument.
+ * Use `getAuth('drive', 'account@email.com')` from the auth module.
+ */
+import { drive } from '@googleapis/drive';
+import { createReadStream } from 'node:fs';
+import { basename } from 'node:path';
+import { guardOperation } from '../safety.js';
+import { NotFoundError, QuotaError, GoEasyError } from '../errors.js';
+import { parseFile, parsePermission, FILE_FIELDS, LIST_FIELDS, exportFormatToMime, isGoogleWorkspaceFile, guessMimeType, } from './helpers.js';
+/** Get a Drive API client instance */
+function driveApi(auth) {
+    return drive({ version: 'v3', auth });
+}
+/** Wrap Google API errors into our error types */
+function handleApiError(err, context) {
+    if (err instanceof GoEasyError)
+        throw err;
+    const gErr = err;
+    if (gErr.code === 404)
+        throw new NotFoundError('file', context, err);
+    if (gErr.code === 429)
+        throw new QuotaError('drive', err);
+    throw new GoEasyError(`Drive ${context}: ${gErr.message ?? 'Unknown error'}`, 'DRIVE_ERROR', err);
+}
+/**
+ * List files in a folder or matching a query.
+ *
+ * @example
+ * ```ts
+ * // List root folder
+ * const files = await listFiles(auth);
+ *
+ * // List specific folder
+ * const files = await listFiles(auth, { folderId: 'folder-id' });
+ *
+ * // Query by metadata
+ * const files = await listFiles(auth, { query: "name contains 'report'" });
+ * ```
+ */
+export async function listFiles(auth, opts = {}) {
+    const drive = driveApi(auth);
+    const queryParts = [];
+    if (opts.folderId) {
+        queryParts.push(`'${opts.folderId}' in parents`);
+    }
+    if (opts.query) {
+        queryParts.push(opts.query);
+    }
+    if (!opts.includeTrashed) {
+        queryParts.push('trashed = false');
+    }
+    try {
+        const res = await drive.files.list({
+            q: queryParts.length > 0 ? queryParts.join(' and ') : undefined,
+            fields: LIST_FIELDS,
+            pageSize: opts.maxResults ?? 20,
+            pageToken: opts.pageToken,
+            orderBy: opts.orderBy ?? 'modifiedTime desc',
+            includeItemsFromAllDrives: true,
+            supportsAllDrives: true,
+        });
+        return {
+            items: (res.data.files ?? []).map(parseFile),
+            nextPageToken: res.data.nextPageToken ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'listFiles');
+    }
+}
+/**
+ * Full-text search inside file contents.
+ *
+ * @example
+ * ```ts
+ * const results = await searchFiles(auth, { query: 'quarterly revenue' });
+ * ```
+ */
+export async function searchFiles(auth, opts) {
+    return listFiles(auth, {
+        query: `fullText contains '${opts.query.replace(/'/g, "\\'")}'`,
+        maxResults: opts.maxResults,
+        pageToken: opts.pageToken,
+    });
+}
+/**
+ * Get a single file's metadata by ID.
+ */
+export async function getFile(auth, fileId) {
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.files.get({
+            fileId,
+            fields: FILE_FIELDS,
+            supportsAllDrives: true,
+        });
+        return parseFile(res.data);
+    }
+    catch (err) {
+        handleApiError(err, fileId);
+    }
+}
+/**
+ * Download a file's content as a Buffer.
+ * For Google Workspace files (Docs, Sheets, Slides), use `exportFile()` instead.
+ */
+export async function downloadFile(auth, fileId) {
+    const drive = driveApi(auth);
+    // Get metadata first to check type
+    const file = await getFile(auth, fileId);
+    if (isGoogleWorkspaceFile(file.mimeType)) {
+        throw new GoEasyError(`Cannot download Google Workspace file "${file.name}" (${file.mimeType}). Use exportFile() instead.`, 'DRIVE_EXPORT_REQUIRED');
+    }
+    try {
+        const res = await drive.files.get({ fileId, alt: 'media', supportsAllDrives: true }, { responseType: 'arraybuffer' });
+        return {
+            data: Buffer.from(res.data),
+            mimeType: file.mimeType,
+            name: file.name,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `download ${fileId}`);
+    }
+}
+/**
+ * Export a Google Workspace file (Doc, Sheet, Slides) to a standard format.
+ *
+ * @example
+ * ```ts
+ * const { data } = await exportFile(auth, 'doc-id', 'pdf');
+ * ```
+ */
+export async function exportFile(auth, fileId, format) {
+    const drive = driveApi(auth);
+    const file = await getFile(auth, fileId);
+    const exportMime = exportFormatToMime(format);
+    try {
+        const res = await drive.files.export({ fileId, mimeType: exportMime }, { responseType: 'arraybuffer' });
+        return {
+            data: Buffer.from(res.data),
+            mimeType: exportMime,
+            name: `${file.name}.${format}`,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `export ${fileId} as ${format}`);
+    }
+}
+/**
+ * Upload a file to Google Drive.
+ *
+ * WRITE operation — no safety gate (reversible via trash).
+ */
+export async function uploadFile(auth, localPath, opts = {}) {
+    const drive = driveApi(auth);
+    const fileName = opts.name ?? basename(localPath);
+    const mimeType = opts.mimeType ?? guessMimeType(fileName);
+    try {
+        const res = await drive.files.create({
+            requestBody: {
+                name: fileName,
+                mimeType,
+                parents: opts.folderId ? [opts.folderId] : undefined,
+            },
+            media: {
+                mimeType,
+                body: createReadStream(localPath),
+            },
+            fields: 'id, name, webViewLink',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? fileName,
+            webViewLink: res.data.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `upload ${fileName}`);
+    }
+}
+/**
+ * Create a folder in Google Drive.
+ *
+ * WRITE operation — no safety gate.
+ */
+export async function createFolder(auth, name, parentId) {
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.files.create({
+            requestBody: {
+                name,
+                mimeType: 'application/vnd.google-apps.folder',
+                parents: parentId ? [parentId] : undefined,
+            },
+            fields: 'id, name, webViewLink',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? name,
+            webViewLink: res.data.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `createFolder ${name}`);
+    }
+}
+/**
+ * Move a file to a different folder.
+ *
+ * WRITE operation — no safety gate (reversible).
+ */
+export async function moveFile(auth, fileId, newParentId) {
+    const drive = driveApi(auth);
+    // Get current parents to remove
+    const file = await getFile(auth, fileId);
+    const previousParents = (file.parents ?? []).join(',');
+    try {
+        const res = await drive.files.update({
+            fileId,
+            addParents: newParentId,
+            removeParents: previousParents,
+            fields: 'id, name, webViewLink',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? '',
+            webViewLink: res.data.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `move ${fileId}`);
+    }
+}
+/**
+ * Rename a file.
+ *
+ * WRITE operation — no safety gate.
+ */
+export async function renameFile(auth, fileId, newName) {
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.files.update({
+            fileId,
+            requestBody: { name: newName },
+            fields: 'id, name, webViewLink',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? newName,
+            webViewLink: res.data.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `rename ${fileId}`);
+    }
+}
+/**
+ * Copy a file.
+ *
+ * WRITE operation — no safety gate.
+ */
+export async function copyFile(auth, fileId, name, parentId) {
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.files.copy({
+            fileId,
+            requestBody: {
+                name,
+                parents: parentId ? [parentId] : undefined,
+            },
+            fields: 'id, name, webViewLink',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? '',
+            webViewLink: res.data.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `copy ${fileId}`);
+    }
+}
+/**
+ * Trash a file.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function trashFile(auth, fileId) {
+    const file = await getFile(auth, fileId);
+    await guardOperation({
+        name: 'drive.trash',
+        level: 'DESTRUCTIVE',
+        description: `Trash file "${file.name}" (${fileId})`,
+        details: { fileId, name: file.name, mimeType: file.mimeType },
+    });
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.files.update({
+            fileId,
+            requestBody: { trashed: true },
+            fields: 'id, name',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: res.data.name ?? '',
+        };
+    }
+    catch (err) {
+        handleApiError(err, `trash ${fileId}`);
+    }
+}
+/**
+ * List permissions on a file.
+ */
+export async function listPermissions(auth, fileId) {
+    const drive = driveApi(auth);
+    try {
+        const res = await drive.permissions.list({
+            fileId,
+            fields: 'permissions(id, type, role, emailAddress, displayName)',
+            supportsAllDrives: true,
+        });
+        return (res.data.permissions ?? []).map(parsePermission);
+    }
+    catch (err) {
+        handleApiError(err, `listPermissions ${fileId}`);
+    }
+}
+/**
+ * Share a file with a user, group, domain, or anyone.
+ *
+ * ⚠️ DESTRUCTIVE when sharing with 'anyone' — requires safety confirmation.
+ * WRITE for user/group/domain sharing.
+ */
+export async function shareFile(auth, fileId, opts) {
+    const file = await getFile(auth, fileId);
+    if (opts.type === 'anyone') {
+        await guardOperation({
+            name: 'drive.share',
+            level: 'DESTRUCTIVE',
+            description: `Share "${file.name}" publicly (anyone with link, role: ${opts.role})`,
+            details: { fileId, name: file.name, type: opts.type, role: opts.role },
+        });
+    }
+    const drive = driveApi(auth);
+    const permission = {
+        type: opts.type,
+        role: opts.role,
+    };
+    if (opts.emailAddress)
+        permission.emailAddress = opts.emailAddress;
+    if (opts.domain)
+        permission.domain = opts.domain;
+    try {
+        const res = await drive.permissions.create({
+            fileId,
+            requestBody: permission,
+            fields: 'id',
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            name: file.name,
+            webViewLink: file.webViewLink ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `share ${fileId}`);
+    }
+}
+/**
+ * Remove a sharing permission from a file.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function unshareFile(auth, fileId, permissionId) {
+    const file = await getFile(auth, fileId);
+    await guardOperation({
+        name: 'drive.unshare',
+        level: 'DESTRUCTIVE',
+        description: `Remove permission ${permissionId} from "${file.name}"`,
+        details: { fileId, name: file.name, permissionId },
+    });
+    const drive = driveApi(auth);
+    try {
+        await drive.permissions.delete({
+            fileId,
+            permissionId,
+            supportsAllDrives: true,
+        });
+        return {
+            ok: true,
+            id: permissionId,
+            name: file.name,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `unshare ${fileId}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/drive/index.js.map

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

package/dist/drive/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Drive types — agent-friendly shapes, not raw API types.
+ */
+/** A simplified file/folder */
+export interface DriveFile {
+    id: string;
+    name: string;
+    mimeType: string;
+    /** Size in bytes (not present for Google Docs/Sheets/Slides) */
+    size?: number;
+    createdTime?: string;
+    modifiedTime?: string;
+    /** Parent folder IDs */
+    parents?: string[];
+    /** Link to open in browser */
+    webViewLink?: string;
+    /** Shared Drive ID (if in a Shared Drive) */
+    driveId?: string;
+    /** Whether the file is shared */
+    shared?: boolean;
+    /** Whether the file is trashed */
+    trashed?: boolean;
+}
+/** A sharing permission */
+export interface DrivePermission {
+    id: string;
+    type: 'user' | 'group' | 'domain' | 'anyone';
+    role: 'owner' | 'organizer' | 'fileOrganizer' | 'writer' | 'commenter' | 'reader';
+    emailAddress?: string;
+    displayName?: string;
+}
+/** Supported export formats for Google Workspace files */
+export type ExportFormat = 'pdf' | 'docx' | 'xlsx' | 'pptx' | 'csv' | 'txt' | 'html';
+/** Options for listing files */
+export interface ListFilesOptions {
+    /** Folder ID to list (default: 'root') */
+    folderId?: string;
+    /** Drive API query filter (metadata search) */
+    query?: string;
+    /** Maximum results (default: 20) */
+    maxResults?: number;
+    /** Page token for pagination */
+    pageToken?: string;
+    /** Include trashed files (default: false) */
+    includeTrashed?: boolean;
+    /** Order by (e.g. 'modifiedTime desc', 'name') */
+    orderBy?: string;
+}
+/** Options for full-text search */
+export interface SearchFilesOptions {
+    /** Text to search for inside file contents */
+    query: string;
+    /** Maximum results (default: 20) */
+    maxResults?: number;
+    /** Page token for pagination */
+    pageToken?: string;
+}
+/** Options for uploading a file */
+export interface UploadOptions {
+    /** Parent folder ID (default: root) */
+    folderId?: string;
+    /** Override filename (default: basename of localPath) */
+    name?: string;
+    /** MIME type (auto-detected if not provided) */
+    mimeType?: string;
+}
+/** Options for sharing a file */
+export interface ShareOptions {
+    /** Who to share with */
+    type: 'user' | 'group' | 'domain' | 'anyone';
+    /** Permission level */
+    role: 'reader' | 'commenter' | 'writer';
+    /** Email (required for user/group), domain (required for domain) */
+    emailAddress?: string;
+    /** Domain (required for type 'domain') */
+    domain?: string;
+}
+/** Paginated list result */
+export interface ListResult<T> {
+    items: T[];
+    /** Token for next page, undefined if no more results */
+    nextPageToken?: string;
+}
+/** Result of a write operation */
+export interface WriteResult {
+    ok: true;
+    id: string;
+    name?: string;
+    webViewLink?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/drive/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/drive/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAErF,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,uBAAuB;IACvB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/drive/types.js

@@ -0,0 +1,5 @@
+/**
+ * Drive types — agent-friendly shapes, not raw API types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/drive/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/drive/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * go-easy error hierarchy.
+ *
+ * All errors extend GoEasyError so callers can catch broadly
+ * or narrowly as needed.
+ */
+export declare class GoEasyError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: string, cause?: unknown | undefined);
+    /** Structured JSON for gateway output */
+    toJSON(): {
+        cause?: string | undefined;
+        error: string;
+        message: string;
+    };
+}
+/**
+ * Auth error codes:
+ *   AUTH_NO_ACCOUNT    — Account not configured at all
+ *   AUTH_MISSING_SCOPE — Account exists but token lacks required scope
+ *   AUTH_TOKEN_REVOKED — Refresh token was revoked (Google returned invalid_grant)
+ *   AUTH_REFRESH_FAILED — Transient network error refreshing token
+ *   AUTH_STORE_CORRUPT — accounts.json unreadable
+ *   AUTH_NO_CREDENTIALS — credentials.json missing
+ *   AUTH_ERROR         — Generic (legacy fallback)
+ */
+export type AuthErrorCode = 'AUTH_NO_ACCOUNT' | 'AUTH_MISSING_SCOPE' | 'AUTH_TOKEN_REVOKED' | 'AUTH_REFRESH_FAILED' | 'AUTH_STORE_CORRUPT' | 'AUTH_NO_CREDENTIALS' | 'AUTH_ERROR';
+/** OAuth2 token expired, missing, or invalid */
+export declare class AuthError extends GoEasyError {
+    /** Exact CLI command that fixes this error */
+    readonly fix?: string;
+    constructor(message: string, cause?: unknown);
+    constructor(code: AuthErrorCode, opts: {
+        message: string;
+        fix?: string;
+        cause?: unknown;
+    });
+    toJSON(): {
+        fix?: string | undefined;
+        cause?: string | undefined;
+        error: string;
+        message: string;
+    };
+}
+/** Google API returned 404 */
+export declare class NotFoundError extends GoEasyError {
+    constructor(resource: string, id: string, cause?: unknown);
+}
+/** Google API quota exceeded (429) */
+export declare class QuotaError extends GoEasyError {
+    constructor(service: string, cause?: unknown);
+}
+/** Operation blocked by safety checks */
+export declare class SafetyError extends GoEasyError {
+    constructor(operation: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,YAAA;IAMjC,yCAAyC;IACzC,MAAM;;;;;CAOP;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,YAAY,CAAC;AAEjB,gDAAgD;AAChD,qBAAa,SAAU,SAAQ,WAAW;IACxC,8CAA8C;IAC9C,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;gBAChC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAsBhF,MAAM;;;;;;CAMhB;AAED,8BAA8B;AAC9B,qBAAa,aAAc,SAAQ,WAAW;gBAChC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI1D;AAED,sCAAsC;AACtC,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,yCAAyC;AACzC,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,SAAS,EAAE,MAAM;CAO9B"}

package/dist/errors.js

@@ -0,0 +1,73 @@
+/**
+ * go-easy error hierarchy.
+ *
+ * All errors extend GoEasyError so callers can catch broadly
+ * or narrowly as needed.
+ */
+export class GoEasyError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'GoEasyError';
+    }
+    /** Structured JSON for gateway output */
+    toJSON() {
+        return {
+            error: this.code,
+            message: this.message,
+            ...(this.cause instanceof Error ? { cause: this.cause.message } : {}),
+        };
+    }
+}
+/** OAuth2 token expired, missing, or invalid */
+export class AuthError extends GoEasyError {
+    /** Exact CLI command that fixes this error */
+    fix;
+    constructor(messageOrCode, causeOrOpts) {
+        // Disambiguate: the opts form is a plain object with a `fix` key or
+        // is NOT an Error instance. An Error passed as second arg is always the legacy cause form.
+        if (typeof causeOrOpts === 'object' &&
+            causeOrOpts !== null &&
+            !(causeOrOpts instanceof Error) &&
+            'message' in causeOrOpts) {
+            const opts = causeOrOpts;
+            super(opts.message, messageOrCode, opts.cause);
+            this.fix = opts.fix;
+        }
+        else {
+            super(messageOrCode, 'AUTH_ERROR', causeOrOpts);
+        }
+        this.name = 'AuthError';
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            ...(this.fix ? { fix: this.fix } : {}),
+        };
+    }
+}
+/** Google API returned 404 */
+export class NotFoundError extends GoEasyError {
+    constructor(resource, id, cause) {
+        super(`${resource} not found: ${id}`, 'NOT_FOUND', cause);
+        this.name = 'NotFoundError';
+    }
+}
+/** Google API quota exceeded (429) */
+export class QuotaError extends GoEasyError {
+    constructor(service, cause) {
+        super(`Quota exceeded for ${service}`, 'QUOTA_EXCEEDED', cause);
+        this.name = 'QuotaError';
+    }
+}
+/** Operation blocked by safety checks */
+export class SafetyError extends GoEasyError {
+    constructor(operation) {
+        super(`Destructive operation "${operation}" blocked — no confirmation provided`, 'SAFETY_BLOCKED');
+        this.name = 'SafetyError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED,yCAAyC;IACzC,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;CACF;AAqBD,gDAAgD;AAChD,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC,8CAA8C;IAC9B,GAAG,CAAU;IAI7B,YACE,aAAqB,EACrB,WAAqB;QAErB,oEAAoE;QACpE,2FAA2F;QAC3F,IACE,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI;YACpB,CAAC,CAAC,WAAW,YAAY,KAAK,CAAC;YAC/B,SAAS,IAAI,WAAW,EACxB,CAAC;YACD,MAAM,IAAI,GAAG,WAAiE,CAAC;YAC/E,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;IAEQ,MAAM;QACb,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,CAAC;IACJ,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,QAAgB,EAAE,EAAU,EAAE,KAAe;QACvD,KAAK,CAAC,GAAG,QAAQ,eAAe,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,sCAAsC;AACtC,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,sBAAsB,OAAO,EAAE,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,SAAiB;QAC3B,KAAK,CACH,0BAA0B,SAAS,sCAAsC,EACzE,gBAAgB,CACjB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}