fix(docs): cover shared items output parsing

Author: Bill Leoutsakos

apps/docs/content/docs/en/integrations/netsuite.mdx

@@ -27,6 +27,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
 - Record fields and supported actions vary by account, enabled features, custom records, forms, role, and permissions. Use **List Record Types** and **Get Record Metadata** before constructing create, update, upsert, action, or transform bodies. Sim intentionally accepts JSON for these dynamic record shapes instead of guessing a fixed schema.
 - Paged operations return one page only. The default limit is 100, the maximum is 1,000, and the offset must be a non-negative multiple of the limit. Sim never fetches later pages automatically. NetSuite limits ordinary collection traversal to 1,000 pages and SuiteQL queries to 100,000 results.
 - Homogeneous batch operations accept 1–100 records of one record type and always run asynchronously. Preserve the returned `location` or `jobId`, use **Get Async Task Status** with **List Tasks** to collect task IDs, check each ID with **Task Status**, then use completed IDs with **Get Async Operation Result**.
+- Sim limits each materialized request body and successful SuiteTalk response to 16 MiB. Split work into smaller pages or batches when a request or response would exceed that ceiling, even if NetSuite would otherwise accept the payload.
 - When attaching a contact with a role, provide either the role's internal ID or external ID, not both. File attachments do not use a contact role.
 - **Attach/Detach**, homogeneous batch operations, **Get Record Form**, and **Get Select Options** require a NetSuite 2026.1-compatible account. Oracle introduced these SuiteTalk REST capabilities in [NetSuite 2026.1](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N3950559.html).
 - **Get Governance Limits** returns data only for roles allowed by NetSuite; Oracle documents Administrator access for that operation.

apps/sim/tools/netsuite/netsuite.test.ts

@@ -140,8 +140,9 @@ const ASYNC_RESULT_SOURCE =
   'https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/subsect_161252889998.html'
 
 /**
- * Executable Oracle source matrix. Besides documenting each contract, this table drives the
- * method/path/query/header/body/status tests below so implementation and citations cannot drift.
+ * Executable Oracle source matrix. This table centralizes the reviewed documentation links and
+ * drives the method/path/query/header/body/status tests below. The links are review evidence, not
+ * live assertions against Oracle's documentation.
  */
 const SOURCE_MATRIX: SourceMatrixEntry[] = [
   {

scripts/generate-docs.test.ts

@@ -0,0 +1,90 @@
+import { describe, expect, it } from 'vitest'
+import { parsePropertiesContent } from './generate-docs'
+
+describe('documentation output-property parsing', () => {
+  it('retains representative non-NetSuite response properties named items', () => {
+    const googleFormsProperties = parsePropertiesContent(`
+      formId: {
+        type: 'string',
+        description: 'The form identifier',
+      },
+      items: {
+        type: 'array',
+        description: 'The form items',
+        items: {
+          type: 'object',
+          properties: {
+            itemId: {
+              type: 'string',
+              description: 'The item identifier',
+            },
+          },
+        },
+      },
+    `)
+    const onePasswordProperties = parsePropertiesContent(`
+      id: {
+        type: 'string',
+        description: 'The vault identifier',
+      },
+      items: {
+        type: 'number',
+        description: 'The number of items in the vault',
+      },
+    `)
+
+    expect(googleFormsProperties.items).toMatchObject({
+      type: 'array',
+      description: 'The form items',
+      items: {
+        type: 'object',
+        properties: {
+          itemId: {
+            type: 'string',
+            description: 'The item identifier',
+          },
+        },
+      },
+    })
+    expect(onePasswordProperties.items).toEqual({
+      type: 'number',
+      description: 'The number of items in the vault',
+    })
+  })
+
+  it('does not promote nested array-schema items to response properties', () => {
+    const gongProperties = parsePropertiesContent(`
+      outline: {
+        type: 'array',
+        description: 'The call outline',
+        items: {
+          type: 'object',
+          properties: {
+            section: {
+              type: 'string',
+              description: 'The outline section',
+            },
+            items: {
+              type: 'array',
+              description: 'The section items',
+              items: {
+                type: 'string',
+                description: 'An outline item',
+              },
+            },
+          },
+        },
+      },
+    `)
+
+    expect(Object.keys(gongProperties)).toEqual(['outline'])
+    expect(gongProperties.outline.items.properties.items).toMatchObject({
+      type: 'array',
+      description: 'The section items',
+      items: {
+        type: 'string',
+        description: 'An outline item',
+      },
+    })
+  })
+})

scripts/generate-docs.ts

@@ -7,8 +7,6 @@ import { glob } from 'glob'
 import type { BlockCategory } from '../apps/sim/blocks/types'
 import { IntegrationType } from '../apps/sim/blocks/types'
 
-console.log('Starting documentation generator...')
-
 /**
  * Cache for resolved const definitions from types files.
  * Key: "toolPrefix:constName" (e.g., "calcom:SCHEDULE_DATA_OUTPUT_PROPERTIES")
@@ -2586,7 +2584,12 @@ function parseFieldContent(fieldContent: string, toolPrefix?: string): any {
   return result
 }
 
-function parsePropertiesContent(
+/**
+ * Parses the properties of an inline tool output schema.
+ *
+ * Exported so parser behavior can be tested without generating documentation.
+ */
+export function parsePropertiesContent(
   propertiesContent: string,
   toolPrefix?: string
 ): Record<string, any> {
@@ -3857,17 +3860,20 @@ function updateMetaJson() {
   console.log(`Updated meta.json with ${items.length} entries`)
 }
 
-generateAllBlockDocs()
-  .then((success) => {
-    if (success) {
-      console.log('Documentation generation completed successfully')
-      process.exit(0)
-    } else {
-      console.error('Documentation generation failed')
+if (import.meta.main) {
+  console.log('Starting documentation generator...')
+  generateAllBlockDocs()
+    .then((success) => {
+      if (success) {
+        console.log('Documentation generation completed successfully')
+        process.exit(0)
+      } else {
+        console.error('Documentation generation failed')
+        process.exit(1)
+      }
+    })
+    .catch((error) => {
+      console.error('Fatal error:', error)
       process.exit(1)
-    }
-  })
-  .catch((error) => {
-    console.error('Fatal error:', error)
-    process.exit(1)
-  })
+    })
+}