gdrivekit 3.2.0

package/dist/drivers/functions/archive/convertFilesAndFoldersToZip.d.ts

@@ -0,0 +1,16 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function convertFilesAndFoldersToZip(oauth2: OAuth2Client, options: {
+    folderId?: string;
+    fileIds?: string[];
+    zipName: string;
+    uploadToFolderId?: string;
+    password?: string;
+}): Promise<{
+    success: boolean;
+    data?: {
+        id: string;
+        name: string;
+        webViewLink: string;
+    };
+    error?: string;
+}>;

package/dist/drivers/functions/conversion/ConversionFunction.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function ConversionFunction(oauth2: OAuth2Client, fileId: string, targetMimeType: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/encryption/decryptText.d.ts

@@ -0,0 +1,2 @@
+import { ApiResponse } from "../../../types";
+export declare function decryptText(encryptedBase64: string, password: string, salt: string): Promise<ApiResponse<string>>;

package/dist/drivers/functions/encryption/encryptText.d.ts

@@ -0,0 +1,2 @@
+import { ApiResponse } from "../../../types";
+export declare function encryptText(plainText: string, password: string, salt: string): Promise<ApiResponse<string>>;

package/dist/drivers/functions/files/createStream.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function createStream(oauth2: OAuth2Client, fileId: string, targetMimeType?: string): Promise<NodeJS.ReadableStream | null>;

package/dist/drivers/functions/files/createStreamfilesandFolder.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function createStreamfilesandFolder(oauth2: OAuth2Client, fileId: string): Promise<NodeJS.ReadableStream | null>;

package/dist/drivers/functions/files/deleteFile.d.ts

@@ -0,0 +1,8 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse } from "../../../types/index";
+/**
+ * Delete file from Google Drive
+ */
+export declare function deleteFile(client: OAuth2Client, fileId: string): Promise<ApiResponse<{
+    message: string;
+}>>;

package/dist/drivers/functions/files/downloadFile.d.ts

@@ -0,0 +1,8 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse } from "../../../types/index";
+/**
+ * Download file to local storage
+ */
+export declare function downloadFile(client: OAuth2Client, fileId: string, destPath: string): Promise<ApiResponse<{
+    path: string;
+}>>;

package/dist/drivers/functions/files/getAllFilesInParent.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function getAllFilesInParent(oauth2: OAuth2Client, parentId: string): Promise<Array<{
+    name: string;
+    id: string;
+    mimeType: string;
+}>>;

package/dist/drivers/functions/files/getFile.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types/index";
+/**
+ * Get File
+ */
+export declare function getFile(client: OAuth2Client, fileId: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/files/listFiles.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, ListFilesParams, ListFilesResponse } from "../../../types/index";
+/**
+ * List files in Google Drive
+ */
+export declare function listFiles(client: OAuth2Client, params?: ListFilesParams): Promise<ApiResponse<ListFilesResponse>>;

package/dist/drivers/functions/files/moveFile.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function moveFile(oauth2: OAuth2Client, fileId: string, newFolderId: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/files/readFileData.d.ts

@@ -0,0 +1,4 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse } from "../../../types";
+import { Buffer } from "buffer";
+export declare function readFileData(oauth2: OAuth2Client, fileId: string, asText?: boolean): Promise<ApiResponse<string | Buffer>>;

package/dist/drivers/functions/files/updateFileContent.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function updateFileContent(oauth2: OAuth2Client, fileId: string, content: string, mimeType: string): Promise<any>;

package/dist/drivers/functions/files/uploadFile.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata, UploadFileMetadata } from "../../../types/index";
+/**
+ * Upload file to Google Drive (multipart upload)
+ */
+export declare function uploadFile(client: OAuth2Client, filePath: string, metadata?: UploadFileMetadata): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/folders/createFolder.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types/index";
+/**
+ * Create folder in Google Drive
+ */
+export declare function createFolder(client: OAuth2Client, folderName: string, parentFolderId?: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/json/addJsonContent.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function addJsonContent(oauth2: OAuth2Client, fileId: string, key: string, value: any): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/json/createJsonFile.d.ts

@@ -0,0 +1,11 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { FileMetadata } from "../../../types";
+export declare function createJsonFile(oauth2: OAuth2Client, jsonContent: string, name: string): Promise<{
+    success: boolean;
+    data: FileMetadata;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    data?: undefined;
+}>;

package/dist/drivers/functions/json/pushJsonObjectToArray.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function pushJsonObjectToArray(oauth2: OAuth2Client, fileId: string, arrayPath: string, newObject: any): Promise<any>;

package/dist/drivers/functions/json/selectJsonContent.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function selectJsonContent(oauth2: OAuth2Client, fileId: string): Promise<any>;

package/dist/drivers/functions/json/updateJsonContent.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function updateJsonContent(oauth2: OAuth2Client, fileId: string, jsonData: Record<string, any>): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/metadata/getCompleteFileMetadata.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function getCompleteFileMetadata(oauth2: OAuth2Client, fileId: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/metadata/getFileMetadata.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function getFileMetadata(oauth2: OAuth2Client, fileId: string): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/metadata/getFileTypeBreakdown.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function getFileTypeBreakdown(oauth2: OAuth2Client, parentId?: string): Promise<Record<string, number>>;

package/dist/drivers/functions/metadata/getImageMetadata.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, ImageMediaMetadata } from "../../../types";
+export declare function getImageMetadata(oauth2: OAuth2Client, fileId: string): Promise<ApiResponse<ImageMediaMetadata>>;

package/dist/drivers/functions/metadata/getVideoMetadata.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, VideoMediaMetadata } from "../../../types";
+export declare function getVideoMetadata(oauth2: OAuth2Client, fileId: string): Promise<ApiResponse<VideoMediaMetadata>>;

package/dist/drivers/functions/metadata/updateFileMetadata.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, FileMetadata } from "../../../types";
+export declare function updateFileMetadata(oauth2: OAuth2Client, fileId: string, metadata: Partial<FileMetadata>): Promise<ApiResponse<FileMetadata>>;

package/dist/drivers/functions/permissions/shareFile.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse } from "../../../types";
+export declare function shareFile(oauth2: OAuth2Client, fileId: string, emailAddress: string, role?: string): Promise<ApiResponse<void>>;

package/dist/drivers/functions/scripts/DeployScript.d.ts

@@ -0,0 +1,13 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function DeployScript(oauth2: OAuth2Client, scriptId: string): Promise<{
+    success: boolean;
+    data: {
+        deploymentId: any;
+        webAppUrl: any;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    data?: undefined;
+}>;

package/dist/drivers/functions/scripts/createScriptProject.d.ts

@@ -0,0 +1,13 @@
+import { OAuth2Client } from "../../oauth2-client";
+export type ScriptProjectType = "HTML" | "API" | "FUNCTION";
+export declare function createScriptProject(oauth2: OAuth2Client, title: string, code: string, projectType?: ScriptProjectType): Promise<{
+    success: boolean;
+    data: {
+        scriptId: any;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    data?: undefined;
+}>;

package/dist/drivers/functions/scripts/deleteScriptProject.d.ts

@@ -0,0 +1,10 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function deleteScriptProject(oauth2: OAuth2Client, scriptId: string): Promise<{
+    success: boolean;
+    data: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    data?: undefined;
+}>;

package/dist/drivers/functions/scripts/manageTrigger.d.ts

@@ -0,0 +1,26 @@
+import { OAuth2Client } from "../../oauth2-client";
+export type TriggerSchedule = "none" | "minutely" | "hourly" | "daily" | "weekly";
+/**
+ * Create or update a time-based trigger for a script
+ * Note: Triggers are created by calling a setup function in the script itself
+ */
+export declare function manageTrigger(oauth2: OAuth2Client, scriptId: string, schedule: TriggerSchedule): Promise<{
+    success: boolean;
+    needsAuth: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: any;
+    needsAuth?: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    needsAuth?: undefined;
+    data?: undefined;
+}>;
+/**
+ * Generate the trigger setup code to be included in the script
+ */
+export declare function generateTriggerSetupCode(): string;

package/dist/drivers/functions/scripts/runScriptProject.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ScriptProjectType } from "./createScriptProject";
+/**
+ * Call a Google Apps Script Web App URL with parameters
+ */
+export declare function runScriptProject(oauth2: OAuth2Client, url: string, functionName?: string, parameters?: Record<string, any>, projectType?: ScriptProjectType): Promise<any>;

package/dist/drivers/functions/scripts/updateScriptProject.d.ts

@@ -0,0 +1,10 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function updateScriptProject(oauth2: OAuth2Client, scriptId: string, files: any[]): Promise<{
+    success: boolean;
+    data: any;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+    data?: undefined;
+}>;

package/dist/drivers/functions/search/findDuplicate.d.ts

@@ -0,0 +1,2 @@
+import { OAuth2Client } from "../../oauth2-client";
+export declare function findDuplicate(oauth2: OAuth2Client): Promise<void>;

package/dist/drivers/functions/search/searchFiles.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, ListFilesResponse } from "../../../types";
+export declare function searchFiles(oauth2: OAuth2Client, searchQuery: string, pageSize?: number): Promise<ApiResponse<ListFilesResponse>>;

package/dist/drivers/functions/storage/getStorageQuota.d.ts

@@ -0,0 +1,3 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { ApiResponse, StorageQuota } from "../../../types";
+export declare function getStorageQuota(oauth2: OAuth2Client): Promise<ApiResponse<StorageQuota>>;

package/dist/drivers/functions/utils.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../oauth2-client";
+import { type HttpResponse } from "../Client";
+/**
+ * Helper method to make authenticated requests using native fetch
+ */
+export declare function fetchWithAuth(oauthClient: OAuth2Client, url: string, options?: RequestInit): Promise<HttpResponse>;

package/dist/drivers/functions/watcher/watchFolder.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { FileMetadata } from "../../../types";
+export declare function watchFolder(oauth2: OAuth2Client, folderId: string, intervalMs: number | undefined, callback: (event: {
+    type: "added" | "modified" | "deleted";
+    file: FileMetadata;
+}) => void): Promise<void>;

package/dist/drivers/functions/watcher/watchFolderDeep.d.ts

@@ -0,0 +1,6 @@
+import { OAuth2Client } from "../../oauth2-client";
+import { FileMetadata } from "../../../types";
+export declare function watchFolderDeep(oauth2: OAuth2Client, folderId: string, intervalMs: number | undefined, callback: (event: {
+    type: "added" | "modified" | "deleted";
+    file: FileMetadata;
+}) => void): Promise<void>;

package/dist/drivers/oauth2-client.d.ts

@@ -0,0 +1,204 @@
+import type { TokenData, GoogleCredentials } from "../types/index";
+export interface OAuth2ClientOptions {
+    /** Path to tokens file (default: ./tokens.json) */
+    tokensPath?: string;
+    /** Whether to auto-save tokens to file (default: true) */
+    autoSaveToFile?: boolean;
+    /** Callback when tokens are refreshed - use this for custom persistence */
+    onTokensRefresh?: (tokens: TokenData) => void;
+}
+/**
+ * Lightweight OAuth2 client using Bun's native fetch
+ * Handles token storage, refresh, and authorization headers
+ *
+ * Token refresh happens automatically when:
+ * - A token is within 5 minutes of expiry
+ * - An API call is made via getAccessToken() or getAuthHeader()
+ */
+export declare class OAuth2Client {
+    get(url: string, arg1: {
+        headers: {
+            length: number;
+            toString(): string;
+            toLocaleString(): string;
+            toLocaleString(locales: string | string[], options?: Intl.NumberFormatOptions & Intl.DateTimeFormatOptions): string;
+            pop(): [string, string] | undefined;
+            push(...items: [string, string][]): number;
+            concat(...items: ConcatArray<[string, string]>[]): [string, string][];
+            concat(...items: ([string, string] | ConcatArray<[string, string]>)[]): [string, string][];
+            join(separator?: string): string;
+            reverse(): [string, string][];
+            shift(): [string, string] | undefined;
+            slice(start?: number, end?: number): [string, string][];
+            sort(compareFn?: ((a: [string, string], b: [string, string]) => number) | undefined): [string, string][];
+            splice(start: number, deleteCount?: number): [string, string][];
+            splice(start: number, deleteCount: number, ...items: [string, string][]): [string, string][];
+            unshift(...items: [string, string][]): number;
+            indexOf(searchElement: [string, string], fromIndex?: number): number;
+            lastIndexOf(searchElement: [string, string], fromIndex?: number): number;
+            every<S extends [string, string]>(predicate: (value: [string, string], index: number, array: [string, string][]) => value is S, thisArg?: any): this is S[];
+            every(predicate: (value: [string, string], index: number, array: [string, string][]) => unknown, thisArg?: any): boolean;
+            some(predicate: (value: [string, string], index: number, array: [string, string][]) => unknown, thisArg?: any): boolean;
+            forEach(callbackfn: (value: [string, string], index: number, array: [string, string][]) => void, thisArg?: any): void;
+            map<U>(callbackfn: (value: [string, string], index: number, array: [string, string][]) => U, thisArg?: any): U[];
+            filter<S extends [string, string]>(predicate: (value: [string, string], index: number, array: [string, string][]) => value is S, thisArg?: any): S[];
+            filter(predicate: (value: [string, string], index: number, array: [string, string][]) => unknown, thisArg?: any): [string, string][];
+            reduce(callbackfn: (previousValue: [string, string], currentValue: [string, string], currentIndex: number, array: [string, string][]) => [string, string]): [string, string];
+            reduce(callbackfn: (previousValue: [string, string], currentValue: [string, string], currentIndex: number, array: [string, string][]) => [string, string], initialValue: [string, string]): [string, string];
+            reduce<U>(callbackfn: (previousValue: U, currentValue: [string, string], currentIndex: number, array: [string, string][]) => U, initialValue: U): U;
+            reduceRight(callbackfn: (previousValue: [string, string], currentValue: [string, string], currentIndex: number, array: [string, string][]) => [string, string]): [string, string];
+            reduceRight(callbackfn: (previousValue: [string, string], currentValue: [string, string], currentIndex: number, array: [string, string][]) => [string, string], initialValue: [string, string]): [string, string];
+            reduceRight<U>(callbackfn: (previousValue: U, currentValue: [string, string], currentIndex: number, array: [string, string][]) => U, initialValue: U): U;
+            find<S extends [string, string]>(predicate: (value: [string, string], index: number, obj: [string, string][]) => value is S, thisArg?: any): S | undefined;
+            find(predicate: (value: [string, string], index: number, obj: [string, string][]) => unknown, thisArg?: any): [string, string] | undefined;
+            findIndex(predicate: (value: [string, string], index: number, obj: [string, string][]) => unknown, thisArg?: any): number;
+            fill(value: [string, string], start?: number, end?: number): [string, string][];
+            copyWithin(target: number, start: number, end?: number): [string, string][];
+            entries(): ArrayIterator<[number, [string, string]]>;
+            keys(): ArrayIterator<number>;
+            values(): ArrayIterator<[string, string]>;
+            includes(searchElement: [string, string], fromIndex?: number): boolean;
+            flatMap<U, This = undefined>(callback: (this: This, value: [string, string], index: number, array: [string, string][]) => U | readonly U[], thisArg?: This | undefined): U[];
+            flat<A, D extends number = 1>(this: A, depth?: D | undefined): FlatArray<A, D>[];
+            at(index: number): [string, string] | undefined;
+            findLast<S extends [string, string]>(predicate: (value: [string, string], index: number, array: [string, string][]) => value is S, thisArg?: any): S | undefined;
+            findLast(predicate: (value: [string, string], index: number, array: [string, string][]) => unknown, thisArg?: any): [string, string] | undefined;
+            findLastIndex(predicate: (value: [string, string], index: number, array: [string, string][]) => unknown, thisArg?: any): number;
+            toReversed(): [string, string][];
+            toSorted(compareFn?: ((a: [string, string], b: [string, string]) => number) | undefined): [string, string][];
+            toSpliced(start: number, deleteCount: number, ...items: [string, string][]): [string, string][];
+            toSpliced(start: number, deleteCount?: number): [string, string][];
+            with(index: number, value: [string, string]): [string, string][];
+            [Symbol.iterator](): ArrayIterator<[string, string]>;
+            [Symbol.unscopables]: {
+                [x: number]: boolean | undefined;
+                length?: boolean | undefined;
+                toString?: boolean | undefined;
+                toLocaleString?: boolean | undefined;
+                pop?: boolean | undefined;
+                push?: boolean | undefined;
+                concat?: boolean | undefined;
+                join?: boolean | undefined;
+                reverse?: boolean | undefined;
+                shift?: boolean | undefined;
+                slice?: boolean | undefined;
+                sort?: boolean | undefined;
+                splice?: boolean | undefined;
+                unshift?: boolean | undefined;
+                indexOf?: boolean | undefined;
+                lastIndexOf?: boolean | undefined;
+                every?: boolean | undefined;
+                some?: boolean | undefined;
+                forEach?: boolean | undefined;
+                map?: boolean | undefined;
+                filter?: boolean | undefined;
+                reduce?: boolean | undefined;
+                reduceRight?: boolean | undefined;
+                find?: boolean | undefined;
+                findIndex?: boolean | undefined;
+                fill?: boolean | undefined;
+                copyWithin?: boolean | undefined;
+                entries?: boolean | undefined;
+                keys?: boolean | undefined;
+                values?: boolean | undefined;
+                includes?: boolean | undefined;
+                flatMap?: boolean | undefined;
+                flat?: boolean | undefined;
+                at?: boolean | undefined;
+                findLast?: boolean | undefined;
+                findLastIndex?: boolean | undefined;
+                toReversed?: boolean | undefined;
+                toSorted?: boolean | undefined;
+                toSpliced?: boolean | undefined;
+                with?: boolean | undefined;
+                [Symbol.iterator]?: boolean | undefined;
+                readonly [Symbol.unscopables]?: boolean | undefined;
+            };
+            Authorization: string;
+        } | {
+            Authorization: string;
+        } | {
+            append(name: string, value: string): void;
+            delete(name: string): void;
+            get(name: string): string | null;
+            getSetCookie(): string[];
+            has(name: string): boolean;
+            set(name: string, value: string): void;
+            forEach(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any): void;
+            entries(): HeadersIterator<[string, string]>;
+            keys(): HeadersIterator<string>;
+            values(): HeadersIterator<string>;
+            [Symbol.iterator](): HeadersIterator<[string, string]>;
+            Authorization: string;
+        };
+        body?: BodyInit | null;
+        cache?: RequestCache;
+        credentials?: RequestCredentials;
+        integrity?: string;
+        keepalive?: boolean;
+        method?: string;
+        mode?: RequestMode;
+        priority?: RequestPriority;
+        redirect?: RequestRedirect;
+        referrer?: string;
+        referrerPolicy?: ReferrerPolicy;
+        signal?: AbortSignal | null;
+        window?: null;
+    }): void;
+    private accessToken;
+    private refreshToken;
+    private clientId;
+    private clientSecret;
+    private redirectUri;
+    private expiryDate;
+    private tokensPath;
+    private autoSaveToFile;
+    private onTokensRefresh?;
+    private isRefreshing;
+    private refreshPromise;
+    constructor(credentials: GoogleCredentials, options?: OAuth2ClientOptions | string);
+    /**
+     * Set tokens and optionally enable auto-save on refresh
+     */
+    setCredentials(tokens: TokenData): void;
+    /**
+     * Set callback for when tokens are refreshed
+     */
+    onTokensRefreshed(callback: (tokens: TokenData) => void): void;
+    /**
+     * Get a valid access token, refreshing if expired
+     * Automatically refreshes the token if it's within 5 minutes of expiry
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Check if the current token is expired or about to expire
+     */
+    isTokenExpired(bufferMinutes?: number): boolean;
+    /**
+     * Get current tokens (useful for persistence)
+     */
+    getTokens(): TokenData;
+    /**
+     * Refresh the access token using the refresh token
+     */
+    refreshAccessToken(): Promise<void>;
+    /**
+     * Get authorization header for API requests
+     */
+    getAuthHeader(): Promise<{
+        Authorization: string;
+    }>;
+    /**
+     * Exchange authorization code for tokens
+     */
+    getToken(code: string): Promise<TokenData>;
+    /**
+     * Generate OAuth2 authorization URL
+     */
+    generateAuthUrl(options: {
+        access_type?: string;
+        prompt?: string;
+        scope: string[];
+        include_granted_scopes?: boolean;
+    }): string;
+}

package/dist/drivers/services.d.ts

@@ -0,0 +1,37 @@
+import type { GoogleCredentials, TokenData } from "../types/index";
+import { GoogleDriveService, DriveServiceOptions } from "./GoogleDriveService";
+declare let driveService: GoogleDriveService;
+export interface InitDriveServiceOptions extends DriveServiceOptions {
+    /** Google credentials (will read from ./credentials.json if not provided) */
+    credentials?: GoogleCredentials;
+    /** Token data (will read from ./tokens.json if not provided) */
+    tokens?: TokenData;
+}
+/**
+ * Initialize the Google Drive service with automatic token refresh
+ *
+ * @example Basic usage (reads from files)
+ * ```ts
+ * const service = initDriveService();
+ * ```
+ *
+ * @example With custom token refresh callback (for SSR/serverless)
+ * ```ts
+ * const service = initDriveService({
+ *   credentials: myCredentials,
+ *   tokens: myTokens,
+ *   autoSaveToFile: false, // Disable file writes in serverless
+ *   onTokensRefresh: async (tokens) => {
+ *     // Save tokens to your database or session
+ *     await saveTokensToDatabase(tokens);
+ *   }
+ * });
+ * ```
+ */
+export declare function initDriveService(options?: InitDriveServiceOptions): GoogleDriveService;
+export declare function initDriveService(creds?: GoogleCredentials, tokens?: TokenData): GoogleDriveService;
+/**
+ * Reset the drive service instance (useful for testing or re-initialization)
+ */
+export declare function resetDriveService(): void;
+export { driveService };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import * as operations from "./operations";
+import { generateCredentialsAndTokens } from "./auth";
+import { initDriveService, resetDriveService, type InitDriveServiceOptions } from "./drivers/services";
+import { DriveServiceOptions, GoogleDriveService } from "./drivers/GoogleDriveService";
+import { OAuth2Client, OAuth2ClientOptions } from "./drivers/oauth2-client";
+export { generateCredentialsAndTokens, operations, initDriveService, resetDriveService, GoogleDriveService, OAuth2Client, type InitDriveServiceOptions, type DriveServiceOptions, type OAuth2ClientOptions, };