feat: preview step + functions refactor [INTEG-3348] #10356

harikakondur · 2025-12-18T21:59:37Z

Purpose

https://contentful.atlassian.net/browse/INTEG-3348

Preview Step UI

temporary ui to view entry previews
uses useModalManagement() Hook

(ui in progress!!!)

528336719-e1f834a3-fb54-48c5-ab60-e4bdc2713629.mov

Function Refactor:

Split up createEntriesfromDocument into 3 functions to avoid timeout:

analyzeContentTypes -> summarizes content types
createPreview -> processes document and and creates preview entries
createEntries -> calls cma to create entry drafts

Cleanup:

moved oauth stuff into a separate folder

…ling each agent in a separate function, + removing plan agent for now

…ment processing

wiz-inc-38d59fb8d7 · 2025-12-18T22:00:13Z

Wiz Scan Summary

Scanner	Findings
Vulnerabilities	-
Sensitive Data	-
Secrets	-
IaC Misconfigurations	-
SAST Findings	1
Software Supply Chain Findings	-

Total	1

View scan details in Wiz

To detect these findings earlier in the dev lifecycle, try using Wiz Code VS Code Extension.

harikakondur · 2025-12-18T22:12:35Z

apps/google-docs/functions/createEntriesFromDocument.ts

-  const cma = initContentfulManagementClient(context);
-  const contentTypes = await fetchContentTypes(cma, new Set<string>(contentTypeIds));
-
-  // Commented out to preserver as much time as possible due to the 30 second limit for App functions
-  // const contentTypeParserAgentResult = await analyzeContentTypes({ contentTypes, openAiApiKey });
-
-  // INTEG-3261: Pass the ai content type response to the observer for analysis
-  // createContentTypeObservationsFromLLMResponse()
-
-  const aiDocumentResponse = await analyzeDocumentWithAgent({
-    documentId,
-    oauthToken,
-    openAiApiKey,
-    contentTypes,
-  });
-


this part was split into

analyzeContentTypes

createPreview

harikakondur · 2025-12-18T22:12:52Z

apps/google-docs/functions/createEntriesFromDocument.ts

-  // INTEG-3264: Create the entries in Contentful using the entry service
-  // The aiDocumentResponse.entries is now ready to be passed to the CMA client
-  const creationResult = await createEntries(cma, aiDocumentResponse.entries, {
-    spaceId: context.spaceId,
-    environmentId: context.environmentId,
-    contentTypes,
-  });
-  console.log('Created Entries Result:', creationResult);
-
-  // INTEG-3265: Create the assets in Contentful using the asset service
-  // await createAssets()


this part went to createEntries

harikakondur · 2025-12-18T22:14:55Z

apps/google-docs/src/components/page/ViewPreviewModal.tsx

+  return (
+    <Modal onClose={handleClose} isShown={isOpen} size="fullWidth">
+      {() => (
+        <>
+          <Modal.Header title="Preview Parsed Entries" onClose={handleClose} />
+          <Modal.Content>
+            <Flex flexDirection="column" gap="spacingM">
+              <Card>
+                <Flex flexDirection="column" gap="spacingS">
+                  <Paragraph>
+                    Based off the document, the following entries are being suggested:


ui work will be in a followup ticket

harikakondur · 2025-12-18T22:16:26Z

apps/google-docs/src/hooks/useDocumentSubmission.ts

+        const analyzeContentTypesResponse = await analyzeContentTypesAction(
+          sdk,
+          contentTypeIds,
+          oauthToken
+        );
+        console.log('analyzeContentTypesResponse', analyzeContentTypesResponse);
+
+        const processDocumentResponse = await createPreviewAction(
          sdk,
          contentTypeIds,
          documentId,
          oauthToken
        );


separate app actions in action 😼

mgoudy91 · 2025-12-18T22:24:11Z

apps/google-docs/contentful-app-manifest.json

-      "description": "Function to create content blocks from App Action.",
-      "path": "functions/createEntriesFromDocument.js",
-      "entryFile": "functions/createEntriesFromDocument.ts",
+      "id": "createPreview",


not a huge deal but we should make sure functions are created and deleted as expected when changing the id

mgoudy91

I skimmed over the UI code based on your comments, but the rest of this looks good

* fix: google docs package.json scripts so that it deploys correctly in ci (#10350) * feat: preview step + functions refactor [INTEG-3348] (#10356) * wip * simplify agent * organize oauth functions * reorganizing function handlers * reorganizing function handlers (prev `createEntriesfromDocument`) calling each agent in a separate function, + removing plan agent for now * fix: function manifest * minor edit to manifest * replacing single function with 2: one for analyzing ct + one for document processing * fix: add oauth token to analyze content type function * fix: adding entries to document processor o/p * feat: new app action to create entries, preview modal * cleanup + rename preview function * cleanup * chore: delete test docs * cleanup * rename handler for consistency * feat: rename functions and files to be consistent with each other (#10358) * [INTEG-3359] feat: got google doc picker working (#10357) * feat: got google doc picker working * feat: explicitly add api key for google docs oauth connection * feat(google-docs): review entries modal [INTEG-3363] (#10359) * feat: reorganize file structure to be more compact (#10361) * refactor: modal components in google docs to be its own component (#10362) * refactor: content type analysis app action names to be consistent with other app actions (#10364) * fix: retries for oauth to be 5 instead of 10 (#10365) * [INTEG-3372] feat: google docs app works with references (#10366) * feat: ai document parser can handle references now * fix: console logs and fixed issues with creating entries and references being mapped * fix: use correct prod deploy s3 base in google docs (#10368) * fix: closing the modal from google docs picker no longer errors out (#10370) * fix: update preview entry card ui [INTEG-3341] (#10367) * fix: preview entry cards ui * fix: using displayField for entry title * pass sdk prop * chore:fix gapi path * feat: helper function to fetch entry titles * chore: using forma style tokens for entry cards * fix entry title helper functions * fix: styles * chore: rename title * fix: copy * fix: moving fetchEntryTitle logic to useGeneratePreview hook * chore: remove logs * chore: remove redundant title * fix any type for entry * replace magic number for title length * rename and move getEntryTitle util * handle zero entries better * cleanup: remove null type for preview response and unused props( summary, total entries) * cleanup * rename previewData -> previewEntries * cleanup * refactor getEntryTitle to use a new getContentType util * [INTEG-3381] refactor: preview modal changes (#10372) * fix: refactor the preview modal logic to have cleaner typings * feat: update app action typing using generics * fix: multiple entries (#10371) * fix: replacing select with multiselect for content type picker modal [INTEG-3378] (#10380) * fix: replacing select with multiselect for content type picker modal, removing `SelectedContentTypes` type * cleanup * feat: file picker upgrade [INTEG-3368] (#10379) * feat: file picker upgrade * removing suggested folders logic * feat: consolidate asset creation (#10377) * feat: loading state modal [INTEG-3382] (#10391) * feat: loading modal for google doc app * loadting state for creating entries * chore: cleanup * chore: cleanup up modal hook * chore: remove extra fragment tags * fixing ModalOrchestrator * empty commit to trigger circleci --------- Co-authored-by: ryunsong-contentful <124832189+ryunsong-contentful@users.noreply.github.com> Co-authored-by: Adrian Meyer <8539634+primeinteger@users.noreply.github.com> Co-authored-by: david-shibley-contentful <149433784+david-shibley-contentful@users.noreply.github.com> Co-authored-by: david shibley <david.shibley@contentful.com>

harikakondur added 18 commits December 17, 2025 09:37

wip

f6f420d

Merge https://github.com/contentful/apps into feat/gdoc-plan-agent

660f12a

simplify agent

278d694

organize oauth functions

516c7af

reorganizing function handlers

93c6252

reorganizing function handlers (prev createEntriesfromDocument) cal…

9c237cb

…ling each agent in a separate function, + removing plan agent for now

fix: function manifest

13b2ca3

minor edit to manifest

0299380

Merge https://github.com/contentful/apps into feat/gdoc-plan-agent

e67c844

Merge https://github.com/contentful/apps into feat/gdoc-plan-agent

718cfda

replacing single function with 2: one for analyzing ct + one for docu…

2c4f8d7

…ment processing

fix: add oauth token to analyze content type function

c97af79

fix: adding entries to document processor o/p

0e4e4d5

feat: new app action to create entries, preview modal

9c4b953

cleanup + rename preview function

a713f51

cleanup

2ab3925

chore: delete test docs

b2666c1

cleanup

557a21b

rename handler for consistency

33921a0

harikakondur commented Dec 18, 2025

View reviewed changes

harikakondur marked this pull request as ready for review December 18, 2025 22:16

harikakondur requested a review from a team as a code owner December 18, 2025 22:16

mgoudy91 reviewed Dec 18, 2025

View reviewed changes

mgoudy91 approved these changes Dec 18, 2025

View reviewed changes

ryunsong-contentful merged commit 1b7d992 into google-docs-xmas-fb Dec 18, 2025
12 of 13 checks passed

ryunsong-contentful mentioned this pull request Jan 5, 2026

feat: merge Google docs xmas feature branch [INTEG-3388] #10394

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: preview step + functions refactor [INTEG-3348] #10356

feat: preview step + functions refactor [INTEG-3348] #10356

Uh oh!

harikakondur commented Dec 18, 2025 •

edited

Loading

Uh oh!

wiz-inc-38d59fb8d7 bot commented Dec 18, 2025 •

edited

Loading

Uh oh!

harikakondur Dec 18, 2025

Uh oh!

harikakondur Dec 18, 2025

Uh oh!

harikakondur Dec 18, 2025

Uh oh!

harikakondur Dec 18, 2025

Uh oh!

mgoudy91 Dec 18, 2025

Uh oh!

mgoudy91 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

feat: preview step + functions refactor [INTEG-3348] #10356

feat: preview step + functions refactor [INTEG-3348] #10356

Uh oh!

Conversation

harikakondur commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose

Uh oh!

wiz-inc-38d59fb8d7 bot commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Wiz Scan Summary

Uh oh!

harikakondur Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

harikakondur Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

harikakondur Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

harikakondur Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

mgoudy91 Dec 18, 2025

Choose a reason for hiding this comment

Uh oh!

mgoudy91 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

harikakondur commented Dec 18, 2025 •

edited

Loading

wiz-inc-38d59fb8d7 bot commented Dec 18, 2025 •

edited

Loading