@soederpop/luca 0.1.2 → 0.2.1

package/dist/node/features/google-calendar.d.ts

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { GoogleAuth } from './google-auth.js';
+export type CalendarInfo = {
+    id: string;
+    summary: string;
+    description?: string;
+    timeZone: string;
+    primary?: boolean;
+    backgroundColor?: string;
+    accessRole: string;
+};
+export type CalendarEvent = {
+    id: string;
+    summary: string;
+    description?: string;
+    location?: string;
+    start: {
+        dateTime?: string;
+        date?: string;
+        timeZone?: string;
+    };
+    end: {
+        dateTime?: string;
+        date?: string;
+        timeZone?: string;
+    };
+    status: string;
+    htmlLink: string;
+    creator?: {
+        email?: string;
+        displayName?: string;
+    };
+    organizer?: {
+        email?: string;
+        displayName?: string;
+    };
+    attendees?: Array<{
+        email?: string;
+        displayName?: string;
+        responseStatus?: string;
+    }>;
+    recurrence?: string[];
+};
+export type CalendarEventList = {
+    events: CalendarEvent[];
+    nextPageToken?: string;
+    timeZone?: string;
+};
+export type ListEventsOptions = {
+    calendarId?: string;
+    timeMin?: string;
+    timeMax?: string;
+    maxResults?: number;
+    query?: string;
+    orderBy?: 'startTime' | 'updated';
+    pageToken?: string;
+    singleEvents?: boolean;
+};
+export declare const GoogleCalendarStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    lastCalendarId: z.ZodOptional<z.ZodString>;
+    lastEventCount: z.ZodOptional<z.ZodNumber>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GoogleCalendarState = z.infer<typeof GoogleCalendarStateSchema>;
+export declare const GoogleCalendarOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    auth: z.ZodOptional<z.ZodAny>;
+    defaultCalendarId: z.ZodOptional<z.ZodString>;
+    timeZone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GoogleCalendarOptions = z.infer<typeof GoogleCalendarOptionsSchema>;
+export declare const GoogleCalendarEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    eventsFetched: z.ZodTuple<[z.ZodNumber], null>;
+    error: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+/**
+ * Google Calendar feature for listing calendars and reading events.
+ *
+ * Depends on the googleAuth feature for authentication. Creates a Calendar v3 API
+ * client lazily. Provides convenience methods for today's events and upcoming days.
+ *
+ * @example
+ * ```typescript
+ * const calendar = container.feature('googleCalendar')
+ *
+ * // List all calendars
+ * const calendars = await calendar.listCalendars()
+ *
+ * // Get today's events
+ * const today = await calendar.getToday()
+ *
+ * // Get next 7 days of events
+ * const upcoming = await calendar.getUpcoming(7)
+ *
+ * // Search events
+ * const meetings = await calendar.searchEvents('standup')
+ *
+ * // List events in a time range
+ * const events = await calendar.listEvents({
+ *   timeMin: '2026-03-01T00:00:00Z',
+ *   timeMax: '2026-03-31T23:59:59Z',
+ * })
+ * ```
+ */
+export declare class GoogleCalendar extends Feature<GoogleCalendarState, GoogleCalendarOptions> {
+    static shortcut: "features.googleCalendar";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        lastCalendarId: z.ZodOptional<z.ZodString>;
+        lastEventCount: z.ZodOptional<z.ZodNumber>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        auth: z.ZodOptional<z.ZodAny>;
+        defaultCalendarId: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        eventsFetched: z.ZodTuple<[z.ZodNumber], null>;
+        error: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _calendar?;
+    get initialState(): GoogleCalendarState;
+    /** Access the google-auth feature lazily. */
+    get auth(): GoogleAuth;
+    /** Default calendar ID from options or 'primary'. */
+    get defaultCalendarId(): string;
+    /** Get or create the Calendar v3 API client. */
+    private getCalendar;
+    /**
+     * List all calendars accessible to the authenticated user.
+     *
+     * @returns Array of calendar info objects
+     */
+    listCalendars(): Promise<CalendarInfo[]>;
+    /**
+     * List events from a calendar within a time range.
+     *
+     * @param options - Filtering options including timeMin, timeMax, query, maxResults
+     * @returns Events array with optional nextPageToken and timeZone
+     */
+    listEvents(options?: ListEventsOptions): Promise<CalendarEventList>;
+    /**
+     * Get today's events from a calendar.
+     *
+     * @param calendarId - Calendar ID (defaults to options.defaultCalendarId or 'primary')
+     * @returns Array of today's calendar events
+     */
+    getToday(calendarId?: string): Promise<CalendarEvent[]>;
+    /**
+     * Get upcoming events for the next N days.
+     *
+     * @param days - Number of days to look ahead (default: 7)
+     * @param calendarId - Calendar ID
+     * @returns Array of upcoming calendar events
+     */
+    getUpcoming(days?: number, calendarId?: string): Promise<CalendarEvent[]>;
+    /**
+     * Get a single event by ID.
+     *
+     * @param eventId - The event ID
+     * @param calendarId - Calendar ID
+     * @returns The calendar event
+     */
+    getEvent(eventId: string, calendarId?: string): Promise<CalendarEvent>;
+    /**
+     * Search events by text query across event summaries, descriptions, and locations.
+     *
+     * @param query - Freetext search term
+     * @param options - Additional listing options (timeMin, timeMax, calendarId, etc.)
+     * @returns Array of matching calendar events
+     */
+    searchEvents(query: string, options?: ListEventsOptions): Promise<CalendarEvent[]>;
+}
+declare module '../../feature' {
+    interface AvailableFeatures {
+        googleCalendar: typeof GoogleCalendar;
+    }
+}
+export default GoogleCalendar;
+//# sourceMappingURL=google-calendar.d.ts.map

package/dist/node/features/google-calendar.d.ts.map

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

package/dist/node/features/google-docs.d.ts

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import { type docs_v1 } from 'googleapis';
+import type { GoogleAuth } from './google-auth.js';
+import type { GoogleDrive, DriveFile } from './google-drive.js';
+export declare const GoogleDocsStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    lastDocId: z.ZodOptional<z.ZodString>;
+    lastDocTitle: z.ZodOptional<z.ZodString>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GoogleDocsState = z.infer<typeof GoogleDocsStateSchema>;
+export declare const GoogleDocsOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    auth: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+export type GoogleDocsOptions = z.infer<typeof GoogleDocsOptionsSchema>;
+export declare const GoogleDocsEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    documentFetched: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+    error: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+/**
+ * Google Docs feature for reading documents and converting them to Markdown.
+ *
+ * Depends on googleAuth for authentication and optionally googleDrive for listing docs.
+ * The markdown converter handles headings, text formatting, links, lists, tables, and images.
+ *
+ * @example
+ * ```typescript
+ * const docs = container.feature('googleDocs')
+ *
+ * // Get a doc as markdown
+ * const markdown = await docs.getAsMarkdown('1abc_document_id')
+ *
+ * // Save to file
+ * await docs.saveAsMarkdown('1abc_document_id', './output/doc.md')
+ *
+ * // List all Google Docs in Drive
+ * const allDocs = await docs.listDocs()
+ *
+ * // Get raw document structure
+ * const rawDoc = await docs.getDocument('1abc_document_id')
+ *
+ * // Plain text extraction
+ * const text = await docs.getAsText('1abc_document_id')
+ * ```
+ */
+export declare class GoogleDocs extends Feature<GoogleDocsState, GoogleDocsOptions> {
+    static shortcut: "features.googleDocs";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        lastDocId: z.ZodOptional<z.ZodString>;
+        lastDocTitle: z.ZodOptional<z.ZodString>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        auth: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        documentFetched: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        error: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _docs?;
+    get initialState(): GoogleDocsState;
+    /** Access the google-auth feature lazily. */
+    get auth(): GoogleAuth;
+    /** Access the google-drive feature lazily. */
+    get drive(): GoogleDrive;
+    /** Get or create the Docs v1 API client. */
+    private getDocs;
+    /**
+     * Get the raw document structure from the Docs API.
+     *
+     * @param documentId - The Google Docs document ID
+     * @returns Full document JSON including body, lists, inlineObjects, etc.
+     */
+    getDocument(documentId: string): Promise<docs_v1.Schema$Document>;
+    /**
+     * Read a Google Doc and convert it to Markdown.
+     *
+     * Handles headings, bold/italic/strikethrough, links, code fonts, ordered/unordered
+     * lists with nesting, tables, images, and section breaks.
+     *
+     * @param documentId - The Google Docs document ID
+     * @returns Markdown string representation of the document
+     */
+    getAsMarkdown(documentId: string): Promise<string>;
+    /**
+     * Read a Google Doc as plain text (strips all formatting).
+     *
+     * @param documentId - The Google Docs document ID
+     */
+    getAsText(documentId: string): Promise<string>;
+    /**
+     * Download a Google Doc as Markdown and save to a local file.
+     *
+     * @param documentId - The Google Docs document ID
+     * @param localPath - Local file path (resolved relative to container cwd)
+     * @returns Absolute path of the saved file
+     */
+    saveAsMarkdown(documentId: string, localPath: string): Promise<string>;
+    /**
+     * List Google Docs in Drive (filters by Docs MIME type).
+     *
+     * @param query - Optional additional Drive search query
+     * @param options - Pagination options
+     * @returns Array of Google Docs as DriveFile objects
+     */
+    listDocs(query?: string, options?: {
+        pageSize?: number;
+        pageToken?: string;
+    }): Promise<DriveFile[]>;
+    /**
+     * Search for Google Docs by name or content.
+     *
+     * @param term - Search term
+     * @returns Array of matching Google Docs as DriveFile objects
+     */
+    searchDocs(term: string): Promise<DriveFile[]>;
+}
+declare module '../../feature' {
+    interface AvailableFeatures {
+        googleDocs: typeof GoogleDocs;
+    }
+}
+export default GoogleDocs;
+//# sourceMappingURL=google-docs.d.ts.map

package/dist/node/features/google-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-docs.d.ts","sourceRoot":"","sources":["../../../src/node/features/google-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;;;iBAOhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,uBAAuB;;;;;;iBAElC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,sBAAsB;;;;;iBAIjC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,UAAW,SAAQ,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC;IACzE,OAAgB,QAAQ,EAAG,qBAAqB,CAAS;IACzD,OAAgB,WAAW;;;;;sBAAwB;IACnD,OAAgB,aAAa;;;;;;sBAA0B;IACvD,OAAgB,YAAY;;;;;sBAAyB;IAGrD,OAAO,CAAC,KAAK,CAAC,CAAc;IAE5B,IAAa,YAAY,IAAI,eAAe,CAE3C;IAED,6CAA6C;IAC7C,IAAI,IAAI,IAAI,UAAU,CAMrB;IAED,8CAA8C;IAC9C,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,4CAA4C;YAC9B,OAAO;IAOrB;;;;;OAKG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;IAmBvE;;;;;;;;OAQG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxD;;;;OAIG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpD;;;;;;OAMG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E;;;;;;OAMG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOzG;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAMrD;AAkOD,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,iBAAiB;QACzB,UAAU,EAAE,OAAO,UAAU,CAAA;KAC9B;CACF;AAED,eAAe,UAAU,CAAA"}

package/dist/node/features/google-drive.d.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { GoogleAuth } from './google-auth.js';
+export type DriveFile = {
+    id: string;
+    name: string;
+    mimeType: string;
+    size?: string;
+    createdTime?: string;
+    modifiedTime?: string;
+    parents?: string[];
+    webViewLink?: string;
+    iconLink?: string;
+    owners?: Array<{
+        displayName?: string | null;
+        emailAddress?: string | null;
+    }>;
+};
+export type DriveFileList = {
+    files: DriveFile[];
+    nextPageToken?: string;
+};
+export type DriveBrowseResult = {
+    folder: DriveFile;
+    files: DriveFile[];
+    folders: DriveFile[];
+    nextPageToken?: string;
+};
+export type ListFilesOptions = {
+    pageSize?: number;
+    pageToken?: string;
+    orderBy?: string;
+    fields?: string;
+    corpora?: 'user' | 'drive' | 'allDrives';
+};
+export type SearchOptions = ListFilesOptions & {
+    mimeType?: string;
+    inFolder?: string;
+};
+export type SharedDrive = {
+    id: string;
+    name: string;
+    colorRgb?: string;
+};
+export declare const GoogleDriveStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    lastQuery: z.ZodOptional<z.ZodString>;
+    lastResultCount: z.ZodOptional<z.ZodNumber>;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type GoogleDriveState = z.infer<typeof GoogleDriveStateSchema>;
+export declare const GoogleDriveOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    auth: z.ZodOptional<z.ZodAny>;
+    defaultCorpora: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        drive: "drive";
+        allDrives: "allDrives";
+    }>>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type GoogleDriveOptions = z.infer<typeof GoogleDriveOptionsSchema>;
+export declare const GoogleDriveEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    filesFetched: z.ZodTuple<[z.ZodNumber], null>;
+    fileDownloaded: z.ZodTuple<[z.ZodString], null>;
+    error: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+/**
+ * Google Drive feature for listing, searching, browsing, and downloading files.
+ *
+ * Depends on the googleAuth feature for authentication. Creates a Drive v3 API
+ * client lazily and passes the auth client from googleAuth.
+ *
+ * @example
+ * ```typescript
+ * const drive = container.feature('googleDrive')
+ *
+ * // List recent files
+ * const { files } = await drive.listFiles()
+ *
+ * // Search for documents
+ * const { files: docs } = await drive.search('quarterly report', { mimeType: 'application/pdf' })
+ *
+ * // Browse a folder
+ * const contents = await drive.browse('folder-id-here')
+ *
+ * // Download a file to disk
+ * await drive.downloadTo('file-id', './downloads/report.pdf')
+ * ```
+ */
+export declare class GoogleDrive extends Feature<GoogleDriveState, GoogleDriveOptions> {
+    static shortcut: "features.googleDrive";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        lastQuery: z.ZodOptional<z.ZodString>;
+        lastResultCount: z.ZodOptional<z.ZodNumber>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        auth: z.ZodOptional<z.ZodAny>;
+        defaultCorpora: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            drive: "drive";
+            allDrives: "allDrives";
+        }>>;
+        pageSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        filesFetched: z.ZodTuple<[z.ZodNumber], null>;
+        fileDownloaded: z.ZodTuple<[z.ZodString], null>;
+        error: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _drive?;
+    get initialState(): GoogleDriveState;
+    /** Access the google-auth feature lazily. */
+    get auth(): GoogleAuth;
+    /** Get or create the Drive v3 API client. */
+    private getDrive;
+    /**
+     * List files in the user's Drive with an optional query filter.
+     *
+     * @param query - Drive search query (e.g. "name contains 'report'", "mimeType='application/pdf'")
+     * @param options - Pagination and filtering options
+     * @returns Files array and optional nextPageToken
+     */
+    listFiles(query?: string, options?: ListFilesOptions): Promise<DriveFileList>;
+    /**
+     * List files within a specific folder.
+     *
+     * @param folderId - The Drive folder ID
+     * @param options - Pagination and filtering options
+     */
+    listFolder(folderId: string, options?: ListFilesOptions): Promise<DriveFileList>;
+    /**
+     * Browse a folder's contents, separating files from subfolders.
+     *
+     * @param folderId - Folder ID to browse (defaults to 'root')
+     * @returns Folder metadata, child files, and child folders
+     */
+    browse(folderId?: string): Promise<DriveBrowseResult>;
+    /**
+     * Search files by name, content, or MIME type.
+     *
+     * @param term - Search term to look for in file names and content
+     * @param options - Additional search options like mimeType filter or folder restriction
+     */
+    search(term: string, options?: SearchOptions): Promise<DriveFileList>;
+    /**
+     * Get file metadata by file ID.
+     *
+     * @param fileId - The Drive file ID
+     * @param fields - Specific fields to request (defaults to common fields)
+     */
+    getFile(fileId: string, fields?: string): Promise<DriveFile>;
+    /**
+     * Download a file's content as a Buffer.
+     * Uses alt=media for binary download of non-Google files.
+     *
+     * @param fileId - The Drive file ID
+     */
+    download(fileId: string): Promise<Buffer>;
+    /**
+     * Download a file and save it to a local path.
+     *
+     * @param fileId - The Drive file ID
+     * @param localPath - Local file path (resolved relative to container cwd)
+     * @returns Absolute path of the saved file
+     */
+    downloadTo(fileId: string, localPath: string): Promise<string>;
+    /**
+     * Export a Google Workspace file (Docs, Sheets, Slides) to a given MIME type.
+     * Uses the Files.export endpoint.
+     *
+     * @param fileId - The Drive file ID of a Google Workspace document
+     * @param mimeType - Target MIME type (e.g. 'text/plain', 'application/pdf', 'text/csv')
+     */
+    exportFile(fileId: string, mimeType: string): Promise<Buffer>;
+    /**
+     * List all shared drives the user has access to.
+     *
+     * @returns Array of shared drive objects
+     */
+    listDrives(): Promise<SharedDrive[]>;
+}
+declare module '../../feature' {
+    interface AvailableFeatures {
+        googleDrive: typeof GoogleDrive;
+    }
+}
+export default GoogleDrive;
+//# sourceMappingURL=google-drive.d.ts.map

package/dist/node/features/google-drive.d.ts.map

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