@divyacon/piece-google-docs 0.0.0-stage → 0.1.1

package/dist/lib/triggers/new-document.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newDocumentTrigger = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/google-docs/src/lib/triggers/new-document.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const auth_1 = require("../auth");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const props_1 = require("../common/props");
+const output_schemas_1 = require("../output-schemas");
+const dayjs_1 = tslib_1.__importDefault(require("dayjs"));
+const drive_1 = require("@googleapis/drive");
+const polling = {
+    strategy: pieces_common_1.DedupeStrategy.TIMEBASED,
+    items(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ auth, propsValue, lastFetchEpochMS }) {
+            const folderId = propsValue.folderId;
+            const q = ["mimeType='application/vnd.google-apps.document'", 'trashed = false'];
+            if (lastFetchEpochMS) {
+                q.push(`createdTime > '${(0, dayjs_1.default)(lastFetchEpochMS).toISOString()}'`);
+            }
+            if (folderId) {
+                q.push(`'${folderId}' in parents`);
+            }
+            const authClient = yield (0, auth_1.createGoogleClient)(auth);
+            const drive = (0, drive_1.drive)({ version: 'v3', auth: authClient });
+            let nextPageToken;
+            const items = [];
+            do {
+                const response = yield drive.files.list({
+                    q: q.join(' and '),
+                    fields: '*',
+                    orderBy: 'createdTime desc',
+                    supportsAllDrives: true,
+                    includeItemsFromAllDrives: true,
+                    corpora: 'allDrives',
+                    pageToken: nextPageToken,
+                });
+                const fileList = response.data;
+                if (fileList.files) {
+                    items.push(...fileList.files);
+                }
+                if (lastFetchEpochMS === 0)
+                    break;
+                nextPageToken = response.data.nextPageToken;
+            } while (nextPageToken);
+            return items.map((item) => ({
+                epochMilliSeconds: (0, dayjs_1.default)(item.createdTime).valueOf(),
+                data: item,
+            }));
+        });
+    },
+};
+exports.newDocumentTrigger = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.googleDocsAuth,
+    name: 'new-document',
+    displayName: 'New Document',
+    description: 'Triggers when a new document is added to a specific folder(optional).',
+    aiMetadata: {
+        description: 'Fires when a new Google Docs document is created, optionally limited to a specific Drive folder. Use to react when a document first appears; it does not fire on edits to existing documents.',
+    },
+    type: pieces_framework_1.TriggerStrategy.POLLING,
+    props: {
+        folderId: props_1.folderIdProp,
+    },
+    outputSchema: output_schemas_1.newDocumentTriggerOutputSchema,
+    onEnable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield pieces_common_1.pollingHelper.onEnable(polling, {
+                auth: context.auth,
+                store: context.store,
+                propsValue: context.propsValue,
+            });
+        });
+    },
+    onDisable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield pieces_common_1.pollingHelper.onDisable(polling, {
+                auth: context.auth,
+                store: context.store,
+                propsValue: context.propsValue,
+            });
+        });
+    },
+    test(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield pieces_common_1.pollingHelper.test(polling, context);
+        });
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield pieces_common_1.pollingHelper.poll(polling, context);
+        });
+    },
+    sampleData: {
+        kind: 'drive#file',
+        mimeType: 'application/vnd.google-apps.document',
+        webViewLink: 'https://docs.google.com/document/d/1_9xjsrYFgHVvgqYwAJ8KcsDcNU/edit?usp=drivesdk',
+        id: '1_9xjsrYFgHVvgqYwAJ8KcsDcN3AzPelsux',
+        name: 'Test Document',
+    },
+});
+//# sourceMappingURL=new-document.js.map

package/dist/lib/triggers/new-document.js.map

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

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@divyacon/piece-google-docs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "DivyaCon google-docs connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-google-docs"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2",
+    "@googleapis/docs": "9.3.0",
+    "@googleapis/drive": "20.2.0",
+    "dayjs": "1.11.9",
+    "google-auth-library": "10.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.4.8"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,120 @@
+import { createPiece } from '@agnocon/pieces-framework';
+
+import { createCustomApiCallAction } from '@agnocon/pieces-common';
+import { PieceCategory } from '@agnocon/pieces-framework';
+import { createDocument } from './lib/actions/create-document';
+import { createDocumentBasedOnTemplate } from './lib/actions/create-document-based-on-template.action';
+import { readDocument } from './lib/actions/read-document.action';
+import { appendText } from './lib/actions/append-text';
+import { findDocumentAction } from './lib/actions/find-document';
+import { getDocumentPlaintext } from './lib/actions/get-document-plaintext.action';
+import { replaceAllText } from './lib/actions/replace-all-text.action';
+import { searchDocuments } from './lib/actions/search-documents.action';
+import { copyDocument } from './lib/actions/copy-document.action';
+import { getDocument } from './lib/actions/get-document.action';
+import { createTextDocument } from './lib/actions/create-text-document.action';
+import { getDocumentEndIndex } from './lib/actions/get-document-end-index.action';
+import { insertText } from './lib/actions/insert-text.action';
+import { deleteContentRange } from './lib/actions/delete-content-range.action';
+import { createDocumentFromMarkdown } from './lib/actions/create-document-from-markdown.action';
+import { createFooter } from './lib/actions/create-footer.action';
+import { createFootnote } from './lib/actions/create-footnote.action';
+import { createHeader } from './lib/actions/create-header.action';
+import { createNamedRange } from './lib/actions/create-named-range.action';
+import { createParagraphBullets } from './lib/actions/create-paragraph-bullets.action';
+import { deleteFooter } from './lib/actions/delete-footer.action';
+import { deleteHeader } from './lib/actions/delete-header.action';
+import { deleteNamedRange } from './lib/actions/delete-named-range.action';
+import { deleteParagraphBullets } from './lib/actions/delete-paragraph-bullets.action';
+import { deleteTableColumn } from './lib/actions/delete-table-column.action';
+import { deleteTableRow } from './lib/actions/delete-table-row.action';
+import { insertTable } from './lib/actions/insert-table.action';
+import { insertTableColumn } from './lib/actions/insert-table-column.action';
+import { insertTableRow } from './lib/actions/insert-table-row.action';
+import { insertTextInTableCell } from './lib/actions/insert-text-in-table-cell.action';
+import { insertImageInTableCell } from './lib/actions/insert-image-in-table-cell.action';
+import { unmergeTableCells } from './lib/actions/unmerge-table-cells.action';
+import { updateTableRowStyle } from './lib/actions/update-table-row-style.action';
+import { insertInlineImage } from './lib/actions/insert-inline-image.action';
+import { insertPageBreak } from './lib/actions/insert-page-break.action';
+import { replaceImage } from './lib/actions/replace-image.action';
+import { updateDocumentStyle } from './lib/actions/update-document-style.action';
+import { exportAsPdf } from './lib/actions/export-as-pdf.action';
+import { createAndPopulateTable } from './lib/actions/create-and-populate-table.action';
+import { replaceBodyWithMarkdown } from './lib/actions/replace-body-with-markdown.action';
+import { replaceSectionWithMarkdown } from './lib/actions/replace-section-with-markdown.action';
+import { batchUpdate } from './lib/actions/batch-update.action';
+import { newDocumentTrigger } from './lib/triggers/new-document';
+import { googleDocsAuth, getAccessToken, GoogleDocsAuthValue } from './lib/auth';
+
+export { googleDocsAuth, getAccessToken, GoogleDocsAuthValue } from './lib/auth';
+
+export const googleDocs = createPiece({
+	displayName: 'Google Docs',
+	description: 'Create and edit documents online',
+	minimumSupportedRelease: '0.86.4',
+	logoUrl: 'https://cdn.activepieces.com/pieces/google-docs.png',
+	categories: [PieceCategory.CONTENT_AND_FILES],
+	authors: [
+		'pfernandez98',
+		'kishanprmr',
+		'MoShizzle',
+		'khaledmashaly',
+		'abuaboud',
+		'AbdullahBitar',
+		'Kevinyu-alan'
+	],
+	auth: googleDocsAuth,
+	actions: [
+		createDocument,
+		createDocumentBasedOnTemplate,
+		readDocument,
+		findDocumentAction,
+		getDocumentPlaintext,
+		replaceAllText,
+		searchDocuments,
+		copyDocument,
+		getDocumentEndIndex,
+		insertText,
+		deleteContentRange,
+		createDocumentFromMarkdown,
+		getDocument,
+		createTextDocument,
+		createFooter,
+		createFootnote,
+		createHeader,
+		createNamedRange,
+		createParagraphBullets,
+		deleteFooter,
+		deleteHeader,
+		deleteNamedRange,
+		deleteParagraphBullets,
+		deleteTableColumn,
+		deleteTableRow,
+		insertTable,
+		insertTableColumn,
+		insertTableRow,
+		insertTextInTableCell,
+		insertImageInTableCell,
+		unmergeTableCells,
+		updateTableRowStyle,
+		insertInlineImage,
+		insertPageBreak,
+		replaceImage,
+		updateDocumentStyle,
+		exportAsPdf,
+		createAndPopulateTable,
+		replaceBodyWithMarkdown,
+		replaceSectionWithMarkdown,
+		batchUpdate,
+		createCustomApiCallAction({
+			baseUrl: () => 'https://docs.googleapis.com/v1',
+			auth: googleDocsAuth,
+			authMapping: async (auth) => ({
+				Authorization: `Bearer ${await getAccessToken(auth as GoogleDocsAuthValue)}`,
+			}),
+		}),
+		appendText,
+	],
+	triggers: [newDocumentTrigger],
+});

package/src/lib/actions/append-text.ts

@@ -0,0 +1,37 @@
+import { docsCommon } from '../common';
+import { googleDocsAuth, getAccessToken } from '../auth';
+import { Property, createAction } from "@agnocon/pieces-framework";
+import { appendTextActionOutputSchema } from '../output-schemas';
+
+export const appendText = createAction({
+    auth: googleDocsAuth,
+    name: 'append_text',
+    description: 'Appends text to google docs',
+    audience: 'human',
+    aiMetadata: {
+      description:
+        'Appends text to the end of an existing Google Docs document identified by its ID. Use when an agent needs to add content to a known document without altering its existing text. Requires the document ID; not idempotent, since each call inserts the text again, accumulating duplicates.',
+      idempotent: false,
+    },
+    displayName: 'Append text to google docs',
+    props: {
+      text: Property.LongText({
+        displayName: 'Text to append',
+        description: 'The text to append to the document',
+        required: true,
+      }),
+      documentId: Property.ShortText({
+        displayName: 'Document ID',
+        description: 'The ID of the document to append text to',
+        required: true,
+      })
+    },
+    outputSchema: appendTextActionOutputSchema,
+    async run(context) {
+      return await docsCommon.writeToDocument(
+        context.propsValue.documentId,
+        context.propsValue.text,
+        await getAccessToken(context.auth)
+      );
+    },
+  });

package/src/lib/actions/batch-update.action.ts

@@ -0,0 +1,58 @@
+import { googleDocsAuth, createGoogleClient } from '../auth';
+import { docsCommon } from '../common';
+import { Property, createAction } from '@agnocon/pieces-framework';
+import { docs as googleDocs, docs_v1 } from '@googleapis/docs';
+import { batchUpdateActionOutputSchema } from '../output-schemas';
+
+export const batchUpdate = createAction({
+  auth: googleDocsAuth,
+  name: 'batch_update',
+  displayName: 'Batch Update (Advanced)',
+  description: 'Send a raw Google Docs batchUpdate requests array to a document',
+  audience: 'ai',
+  aiMetadata: {
+    description:
+      'Advanced escape hatch that sends a raw array of Google Docs API batchUpdate request objects directly to documents.batchUpdate. Only for callers who know the Google Docs API and need a request kind not covered by a dedicated atomic — prefer the specific atomics (Insert Text, Create Header, Insert Table, Delete Content Range, etc.) for common operations, as they validate inputs and resolve indices for you. Each request is a Docs API Request object, e.g. {"insertText":{"text":"hi","location":{"index":1}}}; requests run in order and indices must already account for prior edits in the same call. Not idempotent in general (depends on the requests supplied).',
+    idempotent: false,
+  },
+  outputSchema: batchUpdateActionOutputSchema,
+  props: {
+    documentId: Property.ShortText({
+      displayName: 'Document ID',
+      description: 'The ID of the document to update.',
+      required: true,
+    }),
+    requests: Property.Json({
+      displayName: 'Requests',
+      description:
+        'An array of raw Google Docs batchUpdate request objects, e.g. [{"insertText":{"text":"hi","location":{"index":1}}}]. See the Google Docs API documents.batchUpdate reference for the available request kinds.',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { documentId, requests } = context.propsValue;
+
+    if (!Array.isArray(requests)) {
+      throw new Error('Requests must be an array of Google Docs batchUpdate request objects.');
+    }
+    const docsRequests = requests as docs_v1.Schema$Request[];
+
+    const authClient = await createGoogleClient(context.auth);
+    const docs = googleDocs({ version: 'v1', auth: authClient });
+
+    try {
+      const response = await docs.documents.batchUpdate({
+        documentId,
+        requestBody: { requests: docsRequests },
+      });
+      return {
+        success: true,
+        documentId,
+        appliedRequests: docsRequests.length,
+        replies: response.data.replies ?? [],
+      };
+    } catch (error) {
+      throw new Error(docsCommon.formatError(error, 'apply a batch update to'));
+    }
+  },
+});

package/src/lib/actions/copy-document.action.ts

@@ -0,0 +1,74 @@
+import { googleDocsAuth, createGoogleClient } from '../auth';
+import { Property, createAction } from '@agnocon/pieces-framework';
+import { drive as googleDrive } from '@googleapis/drive';
+import { folderIdProp } from '../common/props';
+import { copyDocumentActionOutputSchema } from '../output-schemas';
+
+export const copyDocument = createAction({
+	auth: googleDocsAuth,
+	name: 'copy_document',
+	displayName: 'Copy Document',
+	description: 'Create a copy of an existing Google Docs document.',
+	audience: 'ai',
+	aiMetadata: {
+		description:
+			'Duplicates an existing Google Docs document into a new file with the given title. Pick this to spin a working copy off a template or snapshot a version before editing; it is distinct from Edit Template File, which merges data in place. Each call creates a new file, so it is not idempotent (retries produce duplicates).',
+		idempotent: false,
+	},
+	outputSchema: copyDocumentActionOutputSchema,
+	props: {
+		fileId: Property.ShortText({
+			displayName: 'Source Document ID',
+			description:
+				"The ID of the document to copy, found in its URL: 'https://docs.google.com/document/d/<documentId>/edit'.",
+			required: true,
+		}),
+		title: Property.ShortText({
+			displayName: 'New Document Title',
+			description: 'The name to give the copied document.',
+			required: true,
+		}),
+		// Destination folder maps directly to the native Drive files.copy
+		// endpoint (the requestBody.parents field), letting the copy be placed in
+		// a chosen folder instead of defaulting to the source document's location.
+		parents: folderIdProp,
+	},
+	async run(context) {
+		const { fileId, title, parents } = context.propsValue;
+
+		const authClient = await createGoogleClient(context.auth);
+		const drive = googleDrive({ version: 'v3', auth: authClient });
+
+		try {
+			const response = await drive.files.copy({
+				fileId,
+				supportsAllDrives: true,
+				fields: 'id, name, webViewLink, parents',
+				requestBody: {
+					name: title,
+					...(parents ? { parents: [parents] } : {}),
+				},
+			});
+
+			return {
+				id: response.data.id ?? '',
+				name: response.data.name ?? '',
+				webViewLink: response.data.webViewLink ?? '',
+				parents: response.data.parents ?? [],
+			};
+		} catch (e) {
+			const error = e as { code?: number; message?: string };
+			if (error.code === 403) {
+				throw new Error(
+					'Permission denied copying the document. Ensure the connected account has access to the source document and the destination folder.'
+				);
+			}
+			if (error.code === 404) {
+				throw new Error(
+					`Source document not found for ID '${fileId}'. Verify the document ID.`
+				);
+			}
+			throw e;
+		}
+	},
+});

package/src/lib/actions/create-and-populate-table.action.ts

@@ -0,0 +1,141 @@
+import { googleDocsAuth, createGoogleClient } from '../auth';
+import { docsCommon } from '../common';
+import { Property, createAction } from '@agnocon/pieces-framework';
+import { docs as googleDocs, docs_v1 } from '@googleapis/docs';
+import { createAndPopulateTableActionOutputSchema } from '../output-schemas';
+
+export const createAndPopulateTable = createAction({
+  auth: googleDocsAuth,
+  name: 'create_and_populate_table',
+  displayName: 'Create and Populate Table',
+  description: 'Insert a table into a Google Docs document and fill its cells with text',
+  audience: 'ai',
+  aiMetadata: {
+    description:
+      'Inserts a new table at the end of a Google Docs document, sized to the supplied 2D array of strings, and writes each value into its cell in one operation — so an agent can drop a fully-populated table without computing cell indices. The column count is the width of the widest row; shorter rows leave their trailing cells empty. Not idempotent: each call adds another table.',
+    idempotent: false,
+  },
+  outputSchema: createAndPopulateTableActionOutputSchema,
+  props: {
+    documentId: Property.ShortText({
+      displayName: 'Document ID',
+      description: 'The ID of the document to insert the table into.',
+      required: true,
+    }),
+    data: Property.Json({
+      displayName: 'Table Data',
+      description:
+        'A 2D array of strings (rows of columns), e.g. [["Name","Age"],["Alice","30"]]. Each string is written into its matching cell. The table width is the widest row; shorter rows leave trailing cells empty.',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { documentId, data } = context.propsValue;
+
+    const rowsData = data as unknown;
+    if (!Array.isArray(rowsData) || rowsData.length === 0 || !rowsData.every((row) => Array.isArray(row))) {
+      throw new Error('Table Data must be a non-empty 2D array of strings (rows of columns).');
+    }
+    const tableData = rowsData as string[][];
+    const rows = tableData.length;
+    const columns = Math.max(...tableData.map((row) => row.length));
+    if (columns === 0) {
+      throw new Error('Table Data rows must contain at least one column.');
+    }
+
+    const authClient = await createGoogleClient(context.auth);
+    const docs = googleDocs({ version: 'v1', auth: authClient });
+
+    // Append at the end of the body so the new table is unambiguously the last
+    // one in the document when we read back to resolve its cell indices.
+    const insertTableRequest: docs_v1.Schema$Request = {
+      insertTable: { rows, columns, endOfSegmentLocation: {} },
+    };
+
+    try {
+      await docs.documents.batchUpdate({
+        documentId,
+        requestBody: { requests: [insertTableRequest] },
+      });
+    } catch (error) {
+      throw new Error(docsCommon.formatError(error, 'insert a table into'));
+    }
+
+    let reloaded: docs_v1.Schema$Document;
+    try {
+      const response = await docs.documents.get({ documentId });
+      reloaded = response.data;
+    } catch (error) {
+      throw new Error(docsCommon.formatError(error, 'read back the new table in'));
+    }
+
+    const content = reloaded.body?.content ?? [];
+    const tableElement = findLastTable(content);
+    if (!tableElement?.table) {
+      throw new Error('Could not locate the inserted table when reading the document back.');
+    }
+
+    const cellInserts: docs_v1.Schema$Request[] = [];
+    const tableRows = tableElement.table.tableRows ?? [];
+    for (let r = 0; r < tableRows.length; r++) {
+      const cells = tableRows[r].tableCells ?? [];
+      for (let c = 0; c < cells.length; c++) {
+        const value = tableData[r]?.[c];
+        if (value === undefined || value === null || value === '') {
+          continue;
+        }
+        const cellContent = cells[c].content ?? [];
+        const firstParagraph = cellContent[0];
+        const insertIndex = firstParagraph?.startIndex;
+        if (insertIndex === undefined || insertIndex === null) {
+          continue;
+        }
+        cellInserts.push({ insertText: { text: String(value), location: { index: insertIndex } } });
+      }
+    }
+
+    // Apply highest-index inserts first so earlier (lower) indices stay valid as
+    // text shifts the document; each insert below an applied one is unaffected.
+    cellInserts.sort((a, b) => (b.insertText?.location?.index ?? 0) - (a.insertText?.location?.index ?? 0));
+
+    if (cellInserts.length > 0) {
+      try {
+        await docs.documents.batchUpdate({
+          documentId,
+          requestBody: {
+            requests: cellInserts,
+            // Fail loudly instead of misplacing text if the document changed
+            // between the read-back above and this write.
+            writeControl: reloaded.revisionId
+              ? { requiredRevisionId: reloaded.revisionId }
+              : undefined,
+          },
+        });
+      } catch (error) {
+        throw new Error(docsCommon.formatError(error, 'populate the new table in'));
+      }
+    }
+
+    return {
+      success: true,
+      documentId,
+      rows,
+      columns,
+      cellsPopulated: cellInserts.length,
+    };
+  },
+});
+
+// The table appended at end-of-body has the greatest startIndex, so the last
+// table element in document order is unambiguously the one just inserted.
+function findLastTable(
+  content: docs_v1.Schema$StructuralElement[]
+): docs_v1.Schema$StructuralElement | undefined {
+  let match: docs_v1.Schema$StructuralElement | undefined;
+  for (const element of content) {
+    if (element.table) {
+      match = element;
+    }
+  }
+  return match;
+}