veryfront 0.0.49 → 0.0.50

package/dist/integrations/docs-google/files/lib/docs-client.ts

@@ -0,0 +1,582 @@
+/**
+ * Google Docs API Client
+ *
+ * Provides a type-safe interface to Google Docs API operations.
+ */
+
+import { tokenStore as _tokenStore } from "./token-store.ts";
+import { getValidToken } from "./oauth.ts";
+
+// Helper for Cross-Platform environment access
+function getEnv(key: string): string | undefined {
+  // @ts-ignore - Deno global
+  if (typeof Deno !== "undefined") {
+    // @ts-ignore - Deno global
+    return Deno.env.get(key);
+  } // @ts-ignore - process global
+  else if (typeof process !== "undefined" && process.env) {
+    // @ts-ignore - process global
+    return process.env[key];
+  }
+  return undefined;
+}
+
+const DOCS_API_BASE = "https://docs.googleapis.com/v1";
+const DRIVE_API_BASE = "https://www.googleapis.com/drive/v3";
+
+export interface Document {
+  documentId: string;
+  title: string;
+  body: {
+    content: StructuralElement[];
+  };
+  revisionId: string;
+  suggestionsViewMode: string;
+  documentStyle: DocumentStyle;
+}
+
+export interface StructuralElement {
+  startIndex: number;
+  endIndex: number;
+  paragraph?: Paragraph;
+  table?: Table;
+  sectionBreak?: SectionBreak;
+}
+
+export interface Paragraph {
+  elements: ParagraphElement[];
+  paragraphStyle?: ParagraphStyle;
+  bullet?: Bullet;
+}
+
+export interface ParagraphElement {
+  startIndex: number;
+  endIndex: number;
+  textRun?: TextRun;
+  inlineObjectElement?: InlineObjectElement;
+}
+
+export interface TextRun {
+  content: string;
+  textStyle?: TextStyle;
+}
+
+export interface TextStyle {
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  strikethrough?: boolean;
+  fontSize?: Dimension;
+  foregroundColor?: Color;
+  backgroundColor?: Color;
+  fontFamily?: string;
+  link?: Link;
+}
+
+export interface Link {
+  url?: string;
+  bookmarkId?: string;
+  headingId?: string;
+}
+
+export interface Dimension {
+  magnitude: number;
+  unit: string;
+}
+
+export interface Color {
+  rgbColor?: RgbColor;
+}
+
+export interface RgbColor {
+  red: number;
+  green: number;
+  blue: number;
+}
+
+export interface ParagraphStyle {
+  headingId?: string;
+  namedStyleType?: string;
+  alignment?: string;
+  lineSpacing?: number;
+  direction?: string;
+  spacingMode?: string;
+  spaceAbove?: Dimension;
+  spaceBelow?: Dimension;
+  indentFirstLine?: Dimension;
+  indentStart?: Dimension;
+  indentEnd?: Dimension;
+}
+
+export interface Bullet {
+  listId: string;
+  nestingLevel?: number;
+  textStyle?: TextStyle;
+}
+
+export interface Table {
+  rows: number;
+  columns: number;
+  tableRows: TableRow[];
+  tableStyle?: TableStyle;
+}
+
+export interface TableRow {
+  startIndex: number;
+  endIndex: number;
+  tableCells: TableCell[];
+}
+
+export interface TableCell {
+  startIndex: number;
+  endIndex: number;
+  content: StructuralElement[];
+  tableCellStyle?: TableCellStyle;
+}
+
+export interface TableCellStyle {
+  rowSpan?: number;
+  columnSpan?: number;
+  backgroundColor?: Color;
+  borderLeft?: TableCellBorder;
+  borderRight?: TableCellBorder;
+  borderTop?: TableCellBorder;
+  borderBottom?: TableCellBorder;
+  paddingLeft?: Dimension;
+  paddingRight?: Dimension;
+  paddingTop?: Dimension;
+  paddingBottom?: Dimension;
+}
+
+export interface TableCellBorder {
+  color?: Color;
+  width?: Dimension;
+  dashStyle?: string;
+}
+
+export interface TableStyle {
+  tableColumnProperties?: TableColumnProperties[];
+}
+
+export interface TableColumnProperties {
+  width?: Dimension;
+  widthType?: string;
+}
+
+export interface SectionBreak {
+  sectionStyle?: SectionStyle;
+}
+
+export interface SectionStyle {
+  columnSeparatorStyle?: string;
+  contentDirection?: string;
+  marginTop?: Dimension;
+  marginBottom?: Dimension;
+  marginRight?: Dimension;
+  marginLeft?: Dimension;
+  pageNumberStart?: number;
+}
+
+export interface DocumentStyle {
+  background?: Background;
+  pageNumberStart?: number;
+  marginTop?: Dimension;
+  marginBottom?: Dimension;
+  marginRight?: Dimension;
+  marginLeft?: Dimension;
+  pageSize?: Size;
+  marginHeader?: Dimension;
+  marginFooter?: Dimension;
+  useFirstPageHeaderFooter?: boolean;
+}
+
+export interface Background {
+  color?: Color;
+}
+
+export interface Size {
+  height?: Dimension;
+  width?: Dimension;
+}
+
+export interface InlineObjectElement {
+  inlineObjectId: string;
+  textStyle?: TextStyle;
+}
+
+export interface DocumentFile {
+  id: string;
+  name: string;
+  mimeType: string;
+  createdTime: string;
+  modifiedTime: string;
+  webViewLink: string;
+  iconLink?: string;
+  thumbnailLink?: string;
+}
+
+export interface CreateDocumentOptions {
+  title: string;
+}
+
+export interface BatchUpdateRequest {
+  requests: Request[];
+}
+
+export interface Request {
+  insertText?: InsertTextRequest;
+  deleteContentRange?: DeleteContentRangeRequest;
+  replaceAllText?: ReplaceAllTextRequest;
+  updateTextStyle?: UpdateTextStyleRequest;
+  updateParagraphStyle?: UpdateParagraphStyleRequest;
+  insertPageBreak?: InsertPageBreakRequest;
+  insertTable?: InsertTableRequest;
+  deleteTableRow?: DeleteTableRowRequest;
+  deleteTableColumn?: DeleteTableColumnRequest;
+  createParagraphBullets?: CreateParagraphBulletsRequest;
+  deleteParagraphBullets?: DeleteParagraphBulletsRequest;
+}
+
+export interface InsertTextRequest {
+  text: string;
+  location: Location;
+}
+
+export interface DeleteContentRangeRequest {
+  range: Range;
+}
+
+export interface ReplaceAllTextRequest {
+  containsText: ContainsText;
+  replaceText: string;
+}
+
+export interface UpdateTextStyleRequest {
+  range: Range;
+  textStyle: TextStyle;
+  fields: string;
+}
+
+export interface UpdateParagraphStyleRequest {
+  range: Range;
+  paragraphStyle: ParagraphStyle;
+  fields: string;
+}
+
+export interface InsertPageBreakRequest {
+  location: Location;
+}
+
+export interface InsertTableRequest {
+  rows: number;
+  columns: number;
+  location: Location;
+}
+
+export interface DeleteTableRowRequest {
+  tableCellLocation: TableCellLocation;
+}
+
+export interface DeleteTableColumnRequest {
+  tableCellLocation: TableCellLocation;
+}
+
+export interface CreateParagraphBulletsRequest {
+  range: Range;
+  bulletPreset: string;
+}
+
+export interface DeleteParagraphBulletsRequest {
+  range: Range;
+}
+
+export interface Location {
+  index: number;
+  segmentId?: string;
+}
+
+export interface Range {
+  startIndex: number;
+  endIndex: number;
+  segmentId?: string;
+}
+
+export interface ContainsText {
+  text: string;
+  matchCase: boolean;
+}
+
+export interface TableCellLocation {
+  tableStartLocation: Location;
+  rowIndex: number;
+  columnIndex: number;
+}
+
+export interface BatchUpdateResponse {
+  documentId: string;
+  replies: Reply[];
+  writeControl?: WriteControl;
+}
+
+export interface Reply {
+  [key: string]: unknown;
+}
+
+export interface WriteControl {
+  requiredRevisionId: string;
+  targetRevisionId: string;
+}
+
+/**
+ * Google Docs OAuth provider configuration
+ */
+export const docsOAuthProvider = {
+  name: "docs-google",
+  authorizationUrl: "https://accounts.google.com/o/oauth2/v2/auth",
+  tokenUrl: "https://oauth2.googleapis.com/token",
+  clientId: getEnv("GOOGLE_CLIENT_ID") || "",
+  clientSecret: getEnv("GOOGLE_CLIENT_SECRET") || "",
+  scopes: [
+    "https://www.googleapis.com/auth/documents.readonly",
+    "https://www.googleapis.com/auth/documents",
+    "https://www.googleapis.com/auth/drive.readonly",
+  ],
+  callbackPath: "/api/auth/docs-google/callback",
+};
+
+/**
+ * Create a Docs client for a specific user
+ */
+export function createDocsClient(userId: string) {
+  async function getAccessToken(): Promise<string> {
+    const token = await getValidToken(docsOAuthProvider, userId, "docs-google");
+    if (!token) {
+      throw new Error("Google Docs not connected. Please connect your Google account first.");
+    }
+    return token;
+  }
+
+  async function docsApiRequest<T>(
+    endpoint: string,
+    options: RequestInit = {},
+  ): Promise<T> {
+    const accessToken = await getAccessToken();
+
+    const response = await fetch(`${DOCS_API_BASE}${endpoint}`, {
+      ...options,
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+        "Content-Type": "application/json",
+        ...options.headers,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Docs API error: ${response.status} - ${error}`);
+    }
+
+    return response.json();
+  }
+
+  async function driveApiRequest<T>(
+    endpoint: string,
+    options: RequestInit = {},
+  ): Promise<T> {
+    const accessToken = await getAccessToken();
+
+    const response = await fetch(`${DRIVE_API_BASE}${endpoint}`, {
+      ...options,
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+        "Content-Type": "application/json",
+        ...options.headers,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Drive API error: ${response.status} - ${error}`);
+    }
+
+    return response.json();
+  }
+
+  return {
+    /**
+     * List documents from Google Drive
+     */
+    async listDocuments(options: {
+      maxResults?: number;
+      orderBy?: "createdTime" | "modifiedTime" | "name";
+    } = {}): Promise<DocumentFile[]> {
+      const params = new URLSearchParams({
+        q: "mimeType='application/vnd.google-apps.document' and trashed=false",
+        fields: "files(id,name,mimeType,createdTime,modifiedTime,webViewLink,iconLink,thumbnailLink)",
+        pageSize: String(options.maxResults || 20),
+        orderBy: `${options.orderBy || "modifiedTime"} desc`,
+      });
+
+      const result = await driveApiRequest<{ files: DocumentFile[] }>(
+        `/files?${params.toString()}`,
+      );
+
+      return result.files || [];
+    },
+
+    /**
+     * Get document content and metadata
+     */
+    getDocument(documentId: string): Promise<Document> {
+      return docsApiRequest<Document>(`/documents/${documentId}`);
+    },
+
+    /**
+     * Create a new document
+     */
+    createDocument(options: CreateDocumentOptions): Promise<Document> {
+      return docsApiRequest<Document>("/documents", {
+        method: "POST",
+        body: JSON.stringify({
+          title: options.title,
+        }),
+      });
+    },
+
+    /**
+     * Update document using batch requests
+     */
+    async updateDocument(
+      documentId: string,
+      requests: Request[],
+    ): Promise<BatchUpdateResponse> {
+      return docsApiRequest<BatchUpdateResponse>(
+        `/documents/${documentId}:batchUpdate`,
+        {
+          method: "POST",
+          body: JSON.stringify({ requests }),
+        },
+      );
+    },
+
+    /**
+     * Insert text at a specific location
+     */
+    async insertText(
+      documentId: string,
+      text: string,
+      index: number,
+    ): Promise<BatchUpdateResponse> {
+      return this.updateDocument(documentId, [
+        {
+          insertText: {
+            text,
+            location: { index },
+          },
+        },
+      ]);
+    },
+
+    /**
+     * Delete content in a range
+     */
+    async deleteContent(
+      documentId: string,
+      startIndex: number,
+      endIndex: number,
+    ): Promise<BatchUpdateResponse> {
+      return this.updateDocument(documentId, [
+        {
+          deleteContentRange: {
+            range: { startIndex, endIndex },
+          },
+        },
+      ]);
+    },
+
+    /**
+     * Replace all occurrences of text
+     */
+    async replaceAllText(
+      documentId: string,
+      searchText: string,
+      replaceText: string,
+      matchCase = false,
+    ): Promise<BatchUpdateResponse> {
+      return this.updateDocument(documentId, [
+        {
+          replaceAllText: {
+            containsText: {
+              text: searchText,
+              matchCase,
+            },
+            replaceText,
+          },
+        },
+      ]);
+    },
+
+    /**
+     * Search documents by query
+     */
+    async searchDocuments(query: string, maxResults = 20): Promise<DocumentFile[]> {
+      const params = new URLSearchParams({
+        q: `mimeType='application/vnd.google-apps.document' and trashed=false and fullText contains '${query}'`,
+        fields: "files(id,name,mimeType,createdTime,modifiedTime,webViewLink,iconLink,thumbnailLink)",
+        pageSize: String(maxResults),
+        orderBy: "modifiedTime desc",
+      });
+
+      const result = await driveApiRequest<{ files: DocumentFile[] }>(
+        `/files?${params.toString()}`,
+      );
+
+      return result.files || [];
+    },
+
+    /**
+     * Extract plain text from document body
+     */
+    extractText(document: Document): string {
+      const textParts: string[] = [];
+
+      function processElement(element: StructuralElement) {
+        if (element.paragraph) {
+          element.paragraph.elements.forEach((el) => {
+            if (el.textRun) {
+              textParts.push(el.textRun.content);
+            }
+          });
+        } else if (element.table) {
+          element.table.tableRows.forEach((row) => {
+            row.tableCells.forEach((cell) => {
+              cell.content.forEach(processElement);
+            });
+          });
+        }
+      }
+
+      document.body.content.forEach(processElement);
+      return textParts.join("");
+    },
+
+    /**
+     * Create a document with initial content
+     */
+    async createDocumentWithContent(
+      title: string,
+      content: string,
+    ): Promise<Document> {
+      // Create the document
+      const doc = await this.createDocument({ title });
+
+      // Insert content at index 1 (after the title)
+      await this.insertText(doc.documentId, content, 1);
+
+      // Fetch and return the updated document
+      return this.getDocument(doc.documentId);
+    },
+  };
+}
+
+export type DocsClient = ReturnType<typeof createDocsClient>;

package/dist/integrations/docs-google/files/lib/token-store.ts

@@ -0,0 +1,5 @@
+/**
+ * Google Docs Token Store
+ */
+
+export { memoryTokenStore as tokenStore, type OAuthTokens, type TokenStore } from "veryfront/oauth";

package/dist/integrations/drive/connector.json

@@ -0,0 +1,134 @@
+{
+  "name": "drive",
+  "displayName": "Google Drive",
+  "icon": "drive.svg",
+  "description": "Access, search, and manage files and folders in Google Drive",
+  "auth": {
+    "type": "oauth2",
+    "provider": "google",
+    "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+    "tokenUrl": "https://oauth2.googleapis.com/token",
+    "scopes": [
+      "https://www.googleapis.com/auth/drive.readonly",
+      "https://www.googleapis.com/auth/drive.file"
+    ],
+    "callbackPath": "/api/auth/drive/callback",
+    "requiredApis": [
+      {
+        "name": "Google Drive API",
+        "enableUrl": "https://console.cloud.google.com/apis/library/drive.googleapis.com"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "GOOGLE_CLIENT_ID",
+      "description": "Google OAuth Client ID",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://console.cloud.google.com/apis/credentials"
+    },
+    {
+      "name": "GOOGLE_CLIENT_SECRET",
+      "description": "Google OAuth Client Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://console.cloud.google.com/apis/credentials"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-files",
+      "name": "List Files",
+      "description": "List files and folders in a Google Drive folder or root",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-file",
+      "name": "Get File",
+      "description": "Get metadata and details about a specific file or folder",
+      "requiresWrite": false
+    },
+    {
+      "id": "search-files",
+      "name": "Search Files",
+      "description": "Search for files and folders using queries",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-folder",
+      "name": "Create Folder",
+      "description": "Create a new folder in Google Drive",
+      "requiresWrite": true
+    },
+    {
+      "id": "upload-file",
+      "name": "Upload File",
+      "description": "Upload or create a file in Google Drive",
+      "requiresWrite": true
+    }
+  ],
+  "prompts": [
+    {
+      "id": "organize-files",
+      "title": "Organize Drive files",
+      "prompt": "Help me organize files in Google Drive by creating folders and moving files based on file types or names.",
+      "category": "productivity",
+      "icon": "folder"
+    },
+    {
+      "id": "find-document",
+      "title": "Find a document",
+      "prompt": "Search Google Drive for a specific file or document by name, type, or content.",
+      "category": "productivity",
+      "icon": "search"
+    },
+    {
+      "id": "backup-files",
+      "title": "Create backup structure",
+      "prompt": "Create a backup folder structure in Google Drive and organize important files.",
+      "category": "productivity",
+      "icon": "upload"
+    }
+  ],
+  "suggestedWith": ["gmail", "calendar", "sheets"],
+  "setupGuide": {
+    "title": "Google Drive Integration Setup",
+    "steps": [
+      {
+        "title": "Create a Google Cloud Project",
+        "description": "Go to the Google Cloud Console and create a new project",
+        "url": "https://console.cloud.google.com/projectcreate"
+      },
+      {
+        "title": "Enable the Google Drive API",
+        "description": "Navigate to APIs & Services > Library and enable the Google Drive API",
+        "url": "https://console.cloud.google.com/apis/library/drive.googleapis.com"
+      },
+      {
+        "title": "Configure OAuth Consent Screen",
+        "description": "Go to APIs & Services > OAuth consent screen. Set up your app name, user support email, and developer contact. Add scopes: drive.readonly and drive.file",
+        "url": "https://console.cloud.google.com/apis/credentials/consent"
+      },
+      {
+        "title": "Create OAuth 2.0 Client ID",
+        "description": "Go to APIs & Services > Credentials. Click 'Create Credentials' > 'OAuth client ID'. Choose 'Web application'. Add authorized redirect URI: http://localhost:3000/api/auth/drive/callback (adjust port/domain for production)",
+        "url": "https://console.cloud.google.com/apis/credentials"
+      },
+      {
+        "title": "Copy Credentials to .env",
+        "description": "Copy the Client ID and Client Secret to your .env file as GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET"
+      },
+      {
+        "title": "Test the Integration",
+        "description": "Start your application and navigate to /api/auth/drive to initiate the OAuth flow"
+      }
+    ],
+    "notes": [
+      "The same Google OAuth credentials work for all Google services (Gmail, Calendar, Sheets, Drive)",
+      "In production, make sure to add your production callback URL to authorized redirect URIs",
+      "The drive.file scope only grants access to files created by your app, use drive for full access",
+      "You may need to verify your app if you plan to distribute it publicly"
+    ]
+  }
+}