@particle-academy/google-docs-js 0.6.0 → 0.7.0

package/dist/flow.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/document-create.ts","../src/actions/text-insert.ts","../src/flow.ts"],"names":["callConnector","googleDocsDocumentKind","googleDocsTextInsertKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * The Google Docs faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Docs actually publishes, so an author can wire {{ $json.data.id\n * }} against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeDocumentCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": fake.id(\"1Doc\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled document\"),\n  };\n}\n\nfunction fakeTextInsert({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n  };\n}\n\nexport const googleDocsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"document_create\":\n      return fakeDocumentCreate(request);\n\n    case \"text_insert\":\n      return fakeTextInsert(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_docs: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs, as one service descriptor shared by every Google Docs\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Docs: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleDocsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_DOCS_BASE_URLS = {\n  \"live\": \"https://docs.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_DOCS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Docs's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleDocsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Docs service, for the TypeScript runtime. */\nexport const GOOGLE_DOCS: ServiceDescriptor = {\n  service: \"google_docs\",\n  title: \"Google Docs\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_DOCS_BASE_URLS },\n  requires: [...GOOGLE_DOCS_REQUIRES],\n  authorize: googleDocsAuthorize,\n  faker: googleDocsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Create a blank Google Docs document.\n *\n * POST /v1/documents —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const DOCUMENT_CREATE_OPERATION = \"document_create\";\n\nexport type DocumentCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsDocumentCreate(options: DocumentCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`document_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: DOCUMENT_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/documents\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert plain text at a position in an existing document's body.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport type TextInsertOptions = {\n  /** The node's resolved config. Keys: documentId, text, index. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextInsert(options: TextInsertOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_insert: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`text_insert: \"text\" is required (Text).`);\n  }\n\n  {\n    const n = Number(config.index);\n    if (!(Number.isInteger(n) && n >= 1)) {\n      throw new Error(\n        `text_insert: \"index\" must be a integer, got ${JSON.stringify(config.index)}.`,\n      );\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_INSERT_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.insertText.text\": String(config.text),\n        \"requests.0.insertText.location.index\": Math.trunc(Number(config.index)),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-docs-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"./service.js\";\n\nimport {\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n} from \"@particle-academy/google-docs-ui\";\n\nimport { googleDocsDocumentCreate } from \"./actions/document-create.js\";\nimport { googleDocsTextInsert } from \"./actions/text-insert.js\";\n\nexport const googleDocsDocumentExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsDocumentCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs document_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextInsertExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextInsert({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_insert ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleDocsDocumentKind, executor: googleDocsDocumentExecutor },\n  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor },\n];\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/batch-update.ts","../src/actions/document-create.ts","../src/actions/text-insert.ts","../src/actions/text-replace.ts","../src/flow.ts"],"names":["callConnector","nestFields","googleDocsBatchUpdateKind","googleDocsDocumentKind","googleDocsTextInsertKind","googleDocsTextReplaceKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * The Google Docs faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Docs actually publishes, so an author can wire {{ $json.data.id\n * }} against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeBatchUpdate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n    \"writeControl\": {\n      \"requiredRevisionId\": fake.hex(16),\n    },\n  };\n}\n\nfunction fakeDocumentCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": fake.id(\"1Doc\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled document\"),\n  };\n}\n\nfunction fakeTextInsert({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n  };\n}\n\nfunction fakeTextReplace({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {\n        \"replaceAllText\": {\n          \"occurrencesChanged\": fake.int(1, 9),\n        },\n      },\n    ],\n    \"writeControl\": {\n      \"requiredRevisionId\": fake.hex(16),\n    },\n  };\n}\n\nexport const googleDocsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"batch_update\":\n      return fakeBatchUpdate(request);\n\n    case \"document_create\":\n      return fakeDocumentCreate(request);\n\n    case \"text_insert\":\n      return fakeTextInsert(request);\n\n    case \"text_replace\":\n      return fakeTextReplace(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_docs: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs, as one service descriptor shared by every Google Docs\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Docs: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleDocsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_DOCS_BASE_URLS = {\n  \"live\": \"https://docs.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_DOCS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Docs's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleDocsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Docs service, for the TypeScript runtime. */\nexport const GOOGLE_DOCS: ServiceDescriptor = {\n  service: \"google_docs\",\n  title: \"Google Docs\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_DOCS_BASE_URLS },\n  requires: [...GOOGLE_DOCS_REQUIRES],\n  authorize: googleDocsAuthorize,\n  faker: googleDocsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/batch-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/batch-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Apply a list of Google Doc API requests to a document, all or none.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const BATCH_UPDATE_OPERATION = \"batch_update\";\n\nexport type BatchUpdateOptions = {\n  /** The node's resolved config. Keys: documentId, requests, requiredRevisionId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsBatchUpdate(options: BatchUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`batch_update: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.requests === undefined || config.requests === null || config.requests === \"\") {\n    throw new Error(`batch_update: \"requests\" is required (Requests).`);\n  }\n  if (typeof config.requests === \"string\" && config.requests !== \"\") {\n    try {\n      JSON.parse(config.requests);\n    } catch (error) {\n      throw new Error(`batch_update: \"requests\" must be JSON: ${(error as Error).message}`);\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: BATCH_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        ...(config.requests !== undefined && config.requests !== null && config.requests !== \"\" ? { \"requests\": typeof config.requests === \"string\" ? JSON.parse(config.requests) : config.requests } : {}),\n        ...(config.requiredRevisionId !== undefined && config.requiredRevisionId !== null && config.requiredRevisionId !== \"\" ? { \"writeControl.requiredRevisionId\": String(config.requiredRevisionId) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Create a blank Google Docs document.\n *\n * POST /v1/documents —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const DOCUMENT_CREATE_OPERATION = \"document_create\";\n\nexport type DocumentCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsDocumentCreate(options: DocumentCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`document_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: DOCUMENT_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/documents\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert plain text at a position in an existing document's body.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport type TextInsertOptions = {\n  /** The node's resolved config. Keys: documentId, text, index. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextInsert(options: TextInsertOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_insert: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`text_insert: \"text\" is required (Text).`);\n  }\n\n  {\n    const n = Number(config.index);\n    if (!(Number.isInteger(n) && n >= 1)) {\n      throw new Error(\n        `text_insert: \"index\" must be a integer, got ${JSON.stringify(config.index)}.`,\n      );\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_INSERT_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.insertText.text\": String(config.text),\n        \"requests.0.insertText.location.index\": Math.trunc(Number(config.index)),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-replace.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-replace.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Replace every occurrence of a string in a document.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_REPLACE_OPERATION = \"text_replace\";\n\nexport type TextReplaceOptions = {\n  /** The node's resolved config. Keys: documentId, find, replaceWith, matchCase, requiredRevisionId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextReplace(options: TextReplaceOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_replace: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.find === undefined || config.find === null || config.find === \"\") {\n    throw new Error(`text_replace: \"find\" is required (Find).`);\n  }\n\n  if (config.replaceWith === undefined || config.replaceWith === null || config.replaceWith === \"\") {\n    throw new Error(`text_replace: \"replaceWith\" is required (Replace with).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_REPLACE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.replaceAllText.containsText.text\": String(config.find),\n        \"requests.0.replaceAllText.replaceText\": String(config.replaceWith),\n        ...(config.matchCase !== undefined && config.matchCase !== null && config.matchCase !== \"\" ? { \"requests.0.replaceAllText.containsText.matchCase\": Boolean(config.matchCase) } : {}),\n        ...(config.requiredRevisionId !== undefined && config.requiredRevisionId !== null && config.requiredRevisionId !== \"\" ? { \"writeControl.requiredRevisionId\": String(config.requiredRevisionId) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-docs-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"./service.js\";\n\nimport {\n  googleDocsBatchUpdateKind,\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n  googleDocsTextReplaceKind,\n} from \"@particle-academy/google-docs-ui\";\n\nimport { googleDocsBatchUpdate } from \"./actions/batch-update.js\";\nimport { googleDocsDocumentCreate } from \"./actions/document-create.js\";\nimport { googleDocsTextInsert } from \"./actions/text-insert.js\";\nimport { googleDocsTextReplace } from \"./actions/text-replace.js\";\n\nexport const googleDocsBatchUpdateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsBatchUpdate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs batch_update ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsDocumentExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsDocumentCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs document_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextInsertExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextInsert({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_insert ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextReplaceExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextReplace({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_replace ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleDocsBatchUpdateKind, executor: googleDocsBatchUpdateExecutor },\n  { ...googleDocsDocumentKind, executor: googleDocsDocumentExecutor },\n  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor },\n  { ...googleDocsTextReplaceKind, executor: googleDocsTextReplaceExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -19,9 +19,11 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  * installs the ui package and never this one.
  */
 
+declare const googleDocsBatchUpdateExecutor: NodeExecutor;
 declare const googleDocsDocumentExecutor: NodeExecutor;
 declare const googleDocsTextInsertExecutor: NodeExecutor;
+declare const googleDocsTextReplaceExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsDocumentExecutor, googleDocsTextInsertExecutor };
+export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsBatchUpdateExecutor, googleDocsDocumentExecutor, googleDocsTextInsertExecutor, googleDocsTextReplaceExecutor };

package/dist/flow.d.ts

@@ -19,9 +19,11 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  * installs the ui package and never this one.
  */
 
+declare const googleDocsBatchUpdateExecutor: NodeExecutor;
 declare const googleDocsDocumentExecutor: NodeExecutor;
 declare const googleDocsTextInsertExecutor: NodeExecutor;
+declare const googleDocsTextReplaceExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsDocumentExecutor, googleDocsTextInsertExecutor };
+export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsBatchUpdateExecutor, googleDocsDocumentExecutor, googleDocsTextInsertExecutor, googleDocsTextReplaceExecutor };

package/dist/flow.js

@@ -1,7 +1,21 @@
-import { googleDocsDocumentCreate, googleDocsTextInsert } from './chunk-JRH65Q6F.js';
+import { googleDocsBatchUpdate, googleDocsDocumentCreate, googleDocsTextInsert, googleDocsTextReplace } from './chunk-VLBBKMA4.js';
 import '@particle-academy/fancy-connector-core';
-import { googleDocsDocumentKind, googleDocsTextInsertKind } from '@particle-academy/google-docs-ui';
+import { googleDocsBatchUpdateKind, googleDocsDocumentKind, googleDocsTextInsertKind, googleDocsTextReplaceKind } from '@particle-academy/google-docs-ui';
 
+var googleDocsBatchUpdateExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleDocsBatchUpdate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_docs batch_update ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var googleDocsDocumentExecutor = async (ctx) => {
   const config = ctx.node.data?.config ?? {};
   const result = await googleDocsDocumentCreate({
@@ -30,11 +44,27 @@ var googleDocsTextInsertExecutor = async (ctx) => {
   });
   return { __port: "out", value: result };
 };
+var googleDocsTextReplaceExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleDocsTextReplace({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_docs text_replace ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var GOOGLE_DOCS_RUNNABLE_KINDS = [
+  { ...googleDocsBatchUpdateKind, executor: googleDocsBatchUpdateExecutor },
   { ...googleDocsDocumentKind, executor: googleDocsDocumentExecutor },
-  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor }
+  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor },
+  { ...googleDocsTextReplaceKind, executor: googleDocsTextReplaceExecutor }
 ];
 
-export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsDocumentExecutor, googleDocsTextInsertExecutor };
+export { GOOGLE_DOCS_RUNNABLE_KINDS, googleDocsBatchUpdateExecutor, googleDocsDocumentExecutor, googleDocsTextInsertExecutor, googleDocsTextReplaceExecutor };
 //# sourceMappingURL=flow.js.map
 //# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAsCO,IAAM,0BAAA,GAA2C,OAAO,GAAA,KAAQ;AACrE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,wBAAA,CAAyB;AAAA,IAC5C,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,4BAAA,EAAgC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC7F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,4BAAA,GAA6C,OAAO,GAAA,KAAQ;AACvE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,oBAAA,CAAqB;AAAA,IACxC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,wBAAA,EAA4B,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACzF,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,0BAAA,GAAmD;AAAA,EAC9D,EAAE,GAAG,sBAAA,EAAwB,QAAA,EAAU,0BAAA,EAA2B;AAAA,EAClE,EAAE,GAAG,wBAAA,EAA0B,QAAA,EAAU,4BAAA;AAC3C","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-docs-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"./service.js\";\n\nimport {\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n} from \"@particle-academy/google-docs-ui\";\n\nimport { googleDocsDocumentCreate } from \"./actions/document-create.js\";\nimport { googleDocsTextInsert } from \"./actions/text-insert.js\";\n\nexport const googleDocsDocumentExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsDocumentCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs document_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextInsertExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextInsert({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_insert ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleDocsDocumentKind, executor: googleDocsDocumentExecutor },\n  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor },\n];\n"]}
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":"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","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-docs-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"./service.js\";\n\nimport {\n  googleDocsBatchUpdateKind,\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n  googleDocsTextReplaceKind,\n} from \"@particle-academy/google-docs-ui\";\n\nimport { googleDocsBatchUpdate } from \"./actions/batch-update.js\";\nimport { googleDocsDocumentCreate } from \"./actions/document-create.js\";\nimport { googleDocsTextInsert } from \"./actions/text-insert.js\";\nimport { googleDocsTextReplace } from \"./actions/text-replace.js\";\n\nexport const googleDocsBatchUpdateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsBatchUpdate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs batch_update ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsDocumentExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsDocumentCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs document_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextInsertExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextInsert({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_insert ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleDocsTextReplaceExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleDocsTextReplace({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_docs text_replace ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_DOCS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleDocsBatchUpdateKind, executor: googleDocsBatchUpdateExecutor },\n  { ...googleDocsDocumentKind, executor: googleDocsDocumentExecutor },\n  { ...googleDocsTextInsertKind, executor: googleDocsTextInsertExecutor },\n  { ...googleDocsTextReplaceKind, executor: googleDocsTextReplaceExecutor },\n];\n"]}

package/dist/index.cjs

@@ -3,6 +3,17 @@
 var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
 
 // src/faker.ts
+function fakeBatchUpdate({ config, fake }) {
+  return {
+    "documentId": config.documentId !== void 0 && config.documentId !== null && config.documentId !== "" ? String(config.documentId) : fake.id("1Doc"),
+    "replies": [
+      {}
+    ],
+    "writeControl": {
+      "requiredRevisionId": fake.hex(16)
+    }
+  };
+}
 function fakeDocumentCreate({ config, fake }) {
   return {
     "documentId": fake.id("1Doc"),
@@ -17,12 +28,31 @@ function fakeTextInsert({ config, fake }) {
     ]
   };
 }
+function fakeTextReplace({ config, fake }) {
+  return {
+    "documentId": config.documentId !== void 0 && config.documentId !== null && config.documentId !== "" ? String(config.documentId) : fake.id("1Doc"),
+    "replies": [
+      {
+        "replaceAllText": {
+          "occurrencesChanged": fake.int(1, 9)
+        }
+      }
+    ],
+    "writeControl": {
+      "requiredRevisionId": fake.hex(16)
+    }
+  };
+}
 var googleDocsFaker = (operation, request) => {
   switch (operation) {
+    case "batch_update":
+      return fakeBatchUpdate(request);
     case "document_create":
       return fakeDocumentCreate(request);
     case "text_insert":
       return fakeTextInsert(request);
+    case "text_replace":
+      return fakeTextReplace(request);
     default:
       throw new Error(
         `google_docs: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -53,6 +83,56 @@ var GOOGLE_DOCS = {
   authorize: googleDocsAuthorize,
   faker: googleDocsFaker
 };
+var BATCH_UPDATE_OPERATION = "batch_update";
+async function googleDocsBatchUpdate(options) {
+  const config = options.config ?? {};
+  if (config.documentId === void 0 || config.documentId === null || config.documentId === "") {
+    throw new Error(`batch_update: "documentId" is required (Document ID).`);
+  }
+  if (config.requests === void 0 || config.requests === null || config.requests === "") {
+    throw new Error(`batch_update: "requests" is required (Requests).`);
+  }
+  if (typeof config.requests === "string" && config.requests !== "") {
+    try {
+      JSON.parse(config.requests);
+    } catch (error) {
+      throw new Error(`batch_update: "requests" must be JSON: ${error.message}`);
+    }
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_DOCS, {
+    operation: BATCH_UPDATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,
+      json: nestFields({
+        ...config.requests !== void 0 && config.requests !== null && config.requests !== "" ? { "requests": typeof config.requests === "string" ? JSON.parse(config.requests) : config.requests } : {},
+        ...config.requiredRevisionId !== void 0 && config.requiredRevisionId !== null && config.requiredRevisionId !== "" ? { "writeControl.requiredRevisionId": String(config.requiredRevisionId) } : {}
+      })
+    }
+  });
+}
+function nestFields(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
 var DOCUMENT_CREATE_OPERATION = "document_create";
 async function googleDocsDocumentCreate(options) {
   const config = options.config ?? {};
@@ -106,14 +186,62 @@ async function googleDocsTextInsert(options) {
     request: {
       method: "POST",
       path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,
-      json: nestFields({
+      json: nestFields2({
         "requests.0.insertText.text": String(config.text),
         "requests.0.insertText.location.index": Math.trunc(Number(config.index))
       })
     }
   });
 }
-function nestFields(flat) {
+function nestFields2(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
+var TEXT_REPLACE_OPERATION = "text_replace";
+async function googleDocsTextReplace(options) {
+  const config = options.config ?? {};
+  if (config.documentId === void 0 || config.documentId === null || config.documentId === "") {
+    throw new Error(`text_replace: "documentId" is required (Document ID).`);
+  }
+  if (config.find === void 0 || config.find === null || config.find === "") {
+    throw new Error(`text_replace: "find" is required (Find).`);
+  }
+  if (config.replaceWith === void 0 || config.replaceWith === null || config.replaceWith === "") {
+    throw new Error(`text_replace: "replaceWith" is required (Replace with).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_DOCS, {
+    operation: TEXT_REPLACE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,
+      json: nestFields3({
+        "requests.0.replaceAllText.containsText.text": String(config.find),
+        "requests.0.replaceAllText.replaceText": String(config.replaceWith),
+        ...config.matchCase !== void 0 && config.matchCase !== null && config.matchCase !== "" ? { "requests.0.replaceAllText.containsText.matchCase": Boolean(config.matchCase) } : {},
+        ...config.requiredRevisionId !== void 0 && config.requiredRevisionId !== null && config.requiredRevisionId !== "" ? { "writeControl.requiredRevisionId": String(config.requiredRevisionId) } : {}
+      })
+    }
+  });
+}
+function nestFields3(flat) {
   const out = {};
   for (const [path, value] of Object.entries(flat)) {
     const parts = path.split(".");
@@ -129,15 +257,19 @@ function nestFields(flat) {
   return out;
 }
 
+exports.BATCH_UPDATE_OPERATION = BATCH_UPDATE_OPERATION;
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
 exports.DOCUMENT_CREATE_OPERATION = DOCUMENT_CREATE_OPERATION;
 exports.GOOGLE_DOCS = GOOGLE_DOCS;
 exports.GOOGLE_DOCS_BASE_URLS = GOOGLE_DOCS_BASE_URLS;
 exports.GOOGLE_DOCS_REQUIRES = GOOGLE_DOCS_REQUIRES;
 exports.TEXT_INSERT_OPERATION = TEXT_INSERT_OPERATION;
+exports.TEXT_REPLACE_OPERATION = TEXT_REPLACE_OPERATION;
 exports.googleDocsAuthorize = googleDocsAuthorize;
+exports.googleDocsBatchUpdate = googleDocsBatchUpdate;
 exports.googleDocsDocumentCreate = googleDocsDocumentCreate;
 exports.googleDocsFaker = googleDocsFaker;
 exports.googleDocsTextInsert = googleDocsTextInsert;
+exports.googleDocsTextReplace = googleDocsTextReplace;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/document-create.ts","../src/actions/text-insert.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * The Google Docs faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Docs actually publishes, so an author can wire {{ $json.data.id\n * }} against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeDocumentCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": fake.id(\"1Doc\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled document\"),\n  };\n}\n\nfunction fakeTextInsert({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n  };\n}\n\nexport const googleDocsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"document_create\":\n      return fakeDocumentCreate(request);\n\n    case \"text_insert\":\n      return fakeTextInsert(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_docs: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs, as one service descriptor shared by every Google Docs\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Docs: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleDocsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_DOCS_BASE_URLS = {\n  \"live\": \"https://docs.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_DOCS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Docs's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleDocsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Docs service, for the TypeScript runtime. */\nexport const GOOGLE_DOCS: ServiceDescriptor = {\n  service: \"google_docs\",\n  title: \"Google Docs\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_DOCS_BASE_URLS },\n  requires: [...GOOGLE_DOCS_REQUIRES],\n  authorize: googleDocsAuthorize,\n  faker: googleDocsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Create a blank Google Docs document.\n *\n * POST /v1/documents —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const DOCUMENT_CREATE_OPERATION = \"document_create\";\n\nexport type DocumentCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsDocumentCreate(options: DocumentCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`document_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: DOCUMENT_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/documents\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert plain text at a position in an existing document's body.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport type TextInsertOptions = {\n  /** The node's resolved config. Keys: documentId, text, index. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextInsert(options: TextInsertOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_insert: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`text_insert: \"text\" is required (Text).`);\n  }\n\n  {\n    const n = Number(config.index);\n    if (!(Number.isInteger(n) && n >= 1)) {\n      throw new Error(\n        `text_insert: \"index\" must be a integer, got ${JSON.stringify(config.index)}.`,\n      );\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_INSERT_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.insertText.text\": String(config.text),\n        \"requests.0.insertText.location.index\": Math.trunc(Number(config.index)),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/batch-update.ts","../src/actions/document-create.ts","../src/actions/text-insert.ts","../src/actions/text-replace.ts"],"names":["callConnector","nestFields"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * The Google Docs faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Docs actually publishes, so an author can wire {{ $json.data.id\n * }} against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeBatchUpdate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n    \"writeControl\": {\n      \"requiredRevisionId\": fake.hex(16),\n    },\n  };\n}\n\nfunction fakeDocumentCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": fake.id(\"1Doc\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled document\"),\n  };\n}\n\nfunction fakeTextInsert({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {},\n    ],\n  };\n}\n\nfunction fakeTextReplace({ config, fake }: FakeRequest): unknown {\n  return {\n    \"documentId\": (config.documentId !== undefined && config.documentId !== null && config.documentId !== \"\" ? String(config.documentId) : fake.id(\"1Doc\")),\n    \"replies\": [\n      {\n        \"replaceAllText\": {\n          \"occurrencesChanged\": fake.int(1, 9),\n        },\n      },\n    ],\n    \"writeControl\": {\n      \"requiredRevisionId\": fake.hex(16),\n    },\n  };\n}\n\nexport const googleDocsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"batch_update\":\n      return fakeBatchUpdate(request);\n\n    case \"document_create\":\n      return fakeDocumentCreate(request);\n\n    case \"text_insert\":\n      return fakeTextInsert(request);\n\n    case \"text_replace\":\n      return fakeTextReplace(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_docs: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs, as one service descriptor shared by every Google Docs\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Docs: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleDocsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_DOCS_BASE_URLS = {\n  \"live\": \"https://docs.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_DOCS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Docs's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleDocsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Docs service, for the TypeScript runtime. */\nexport const GOOGLE_DOCS: ServiceDescriptor = {\n  service: \"google_docs\",\n  title: \"Google Docs\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_DOCS_BASE_URLS },\n  requires: [...GOOGLE_DOCS_REQUIRES],\n  authorize: googleDocsAuthorize,\n  faker: googleDocsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/batch-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/batch-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Apply a list of Google Doc API requests to a document, all or none.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const BATCH_UPDATE_OPERATION = \"batch_update\";\n\nexport type BatchUpdateOptions = {\n  /** The node's resolved config. Keys: documentId, requests, requiredRevisionId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsBatchUpdate(options: BatchUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`batch_update: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.requests === undefined || config.requests === null || config.requests === \"\") {\n    throw new Error(`batch_update: \"requests\" is required (Requests).`);\n  }\n  if (typeof config.requests === \"string\" && config.requests !== \"\") {\n    try {\n      JSON.parse(config.requests);\n    } catch (error) {\n      throw new Error(`batch_update: \"requests\" must be JSON: ${(error as Error).message}`);\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: BATCH_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        ...(config.requests !== undefined && config.requests !== null && config.requests !== \"\" ? { \"requests\": typeof config.requests === \"string\" ? JSON.parse(config.requests) : config.requests } : {}),\n        ...(config.requiredRevisionId !== undefined && config.requiredRevisionId !== null && config.requiredRevisionId !== \"\" ? { \"writeControl.requiredRevisionId\": String(config.requiredRevisionId) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Create a blank Google Docs document.\n *\n * POST /v1/documents —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const DOCUMENT_CREATE_OPERATION = \"document_create\";\n\nexport type DocumentCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsDocumentCreate(options: DocumentCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`document_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: DOCUMENT_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/documents\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert plain text at a position in an existing document's body.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport type TextInsertOptions = {\n  /** The node's resolved config. Keys: documentId, text, index. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextInsert(options: TextInsertOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_insert: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`text_insert: \"text\" is required (Text).`);\n  }\n\n  {\n    const n = Number(config.index);\n    if (!(Number.isInteger(n) && n >= 1)) {\n      throw new Error(\n        `text_insert: \"index\" must be a integer, got ${JSON.stringify(config.index)}.`,\n      );\n    }\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_INSERT_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.insertText.text\": String(config.text),\n        \"requests.0.insertText.location.index\": Math.trunc(Number(config.index)),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-replace.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/text-replace.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Replace every occurrence of a string in a document.\n *\n * POST /v1/documents/{documentId}:batchUpdate —\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Docs or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_DOCS } from \"../service.js\";\n\nexport const TEXT_REPLACE_OPERATION = \"text_replace\";\n\nexport type TextReplaceOptions = {\n  /** The node's resolved config. Keys: documentId, find, replaceWith, matchCase, requiredRevisionId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleDocsTextReplace(options: TextReplaceOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.documentId === undefined || config.documentId === null || config.documentId === \"\") {\n    throw new Error(`text_replace: \"documentId\" is required (Document ID).`);\n  }\n\n  if (config.find === undefined || config.find === null || config.find === \"\") {\n    throw new Error(`text_replace: \"find\" is required (Find).`);\n  }\n\n  if (config.replaceWith === undefined || config.replaceWith === null || config.replaceWith === \"\") {\n    throw new Error(`text_replace: \"replaceWith\" is required (Replace with).`);\n  }\n\n  return callConnector(GOOGLE_DOCS, {\n    operation: TEXT_REPLACE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1/documents/${encodeURIComponent(String(config.documentId))}:batchUpdate`,\n      json: nestFields({\n        \"requests.0.replaceAllText.containsText.text\": String(config.find),\n        \"requests.0.replaceAllText.replaceText\": String(config.replaceWith),\n        ...(config.matchCase !== undefined && config.matchCase !== null && config.matchCase !== \"\" ? { \"requests.0.replaceAllText.containsText.matchCase\": Boolean(config.matchCase) } : {}),\n        ...(config.requiredRevisionId !== undefined && config.requiredRevisionId !== null && config.requiredRevisionId !== \"\" ? { \"writeControl.requiredRevisionId\": String(config.requiredRevisionId) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n"]}