@codemation/core-nodes-ocr 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @codemation/core-nodes-ocr
 
+## 0.2.5
+
+### Patch Changes
+
+- Updated dependencies [[`2fcb715`](https://github.com/MadeRelevant/codemation/commit/2fcb7153d9c732b2f846b8a8d1cc5626b4363fa6)]:
+  - @codemation/core@0.13.1
+
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies [[`c1b081f`](https://github.com/MadeRelevant/codemation/commit/c1b081ffc8b66b0c4593c94f1d57a1cdf5c41140), [`be520d2`](https://github.com/MadeRelevant/codemation/commit/be520d2755144a3709ecc109019b84e2c502337e)]:
+  - @codemation/core@0.13.0
+
 ## 0.2.3
 
 ### Patch Changes

package/dist/{analyzeInvoiceNode-uVwe3GHD.js → analyzeInvoiceNode-BqZsN8iL.js}

@@ -124,38 +124,6 @@ function resolveFieldKind(field) {
 	return field.type;
 }
 
-//#endregion
-//#region src/lib/readBinaryBody.ts
-/** Default cap on bytes read into memory. Tuned for prebuilt OCR analyzers (single document). */
-const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
-/**
-* Reads the binary body for an OCR analyzer call.
-*
-* The Azure Content Understanding SDK requires a contiguous `Uint8Array`, so the bytes must
-* land in memory at some point. To bound that:
-*  - The attachment's declared `size` is checked against `maxBytes` *before* any allocation.
-*  - A single buffer of exactly `attachment.size` is pre-allocated (no chunks array, no doubling).
-*  - The stream fills the buffer directly; a length mismatch fails fast.
-*/
-async function readBinaryBody(ctx, attachment, maxBytes = DEFAULT_MAX_BYTES) {
-	if (attachment.size > maxBytes) throw new Error(`Binary attachment size ${attachment.size} bytes exceeds maxBytes ${maxBytes}. Raise the node's maxBytes setting if this document is expected to be larger.`);
-	const stream = await ctx.binary.openReadStream(attachment);
-	if (!stream) throw new Error("Binary attachment stream is unavailable.");
-	const out = new Uint8Array(attachment.size);
-	const reader = stream.body.getReader();
-	let offset = 0;
-	while (true) {
-		const { done, value } = await reader.read();
-		if (done) break;
-		if (!value) continue;
-		if (offset + value.byteLength > out.byteLength) throw new Error(`Binary stream produced more bytes than the attachment's declared size (${attachment.size}).`);
-		out.set(value, offset);
-		offset += value.byteLength;
-	}
-	if (offset !== out.byteLength) throw new Error(`Binary stream produced ${offset} bytes but attachment declared size ${attachment.size}.`);
-	return out;
-}
-
 //#endregion
 //#region src/nodes/analyzeDocumentNode.ts
 /** Default Azure Content Understanding prebuilt general document analyzer ID. */
@@ -204,7 +172,7 @@ const analyzeDocumentNode = defineNode({
 		return analyzeWithAzure({
 			session,
 			analyzerId,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -258,7 +226,7 @@ const analyzeImageNode = defineNode({
 		return analyzeWithAzure({
 			session,
 			analyzerId,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -310,7 +278,7 @@ const analyzeInvoiceNode = defineNode({
 		return analyzeWithAzure({
 			session,
 			analyzerId: PREBUILT_INVOICE_ANALYZER_ID,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -318,4 +286,4 @@ const analyzeInvoiceNode = defineNode({
 
 //#endregion
 export { mapAnalysisResult as a, analyzeWithAzure as i, analyzeImageNode as n, azureContentUnderstandingCredentialType as o, analyzeDocumentNode as r, analyzeInvoiceNode as t };
-//# sourceMappingURL=analyzeInvoiceNode-uVwe3GHD.js.map
+//# sourceMappingURL=analyzeInvoiceNode-BqZsN8iL.js.map

package/dist/analyzeInvoiceNode-BqZsN8iL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeInvoiceNode-BqZsN8iL.js","names":["markdownParts: string[]","out: Record<string, unknown>"],"sources":["../src/credentials/azureContentUnderstandingCredential.ts","../src/lib/analyzeWithAzure.ts","../src/nodes/analyzeDocumentNode.ts","../src/nodes/analyzeImageNode.ts","../src/nodes/analyzeInvoiceNode.ts"],"sourcesContent":["import { ContentUnderstandingClient } from \"@azure/ai-content-understanding\";\nimport { AzureKeyCredential } from \"@azure/core-auth\";\nimport { defineCredential } from \"@codemation/core\";\n\nexport type AzureContentUnderstandingSession = Readonly<{\n  endpoint: string;\n  apiKey: string;\n}>;\n\nfunction normalizeEndpoint(raw: string): string {\n  return raw.trim().replace(/\\/+$/, \"\");\n}\n\nfunction buildSession(args: {\n  readonly publicConfig: Readonly<Record<string, unknown>>;\n  readonly material: Readonly<Record<string, unknown>>;\n}): AzureContentUnderstandingSession {\n  const endpoint = normalizeEndpoint(String(args.publicConfig[\"endpoint\"] ?? \"\"));\n  const apiKey = String(args.material[\"apiKey\"] ?? \"\").trim();\n  if (!endpoint) {\n    throw new Error(\"Azure Content Understanding credential is incomplete: endpoint is required.\");\n  }\n  if (!apiKey) {\n    throw new Error(\"Azure Content Understanding credential is incomplete: API key is required.\");\n  }\n  return { endpoint, apiKey };\n}\n\nexport const azureContentUnderstandingCredentialType = defineCredential({\n  key: \"azure.contentUnderstanding\",\n  label: \"Azure Content Understanding\",\n  description: \"Azure AI Content Understanding (endpoint + key) for prebuilt document, invoice, and image analyzers.\",\n  public: {\n    endpoint: {\n      key: \"endpoint\",\n      label: \"Endpoint\",\n      type: \"string\" as const,\n      required: true,\n      placeholder: \"https://your-resource.cognitiveservices.azure.com/\",\n      helpText: \"Content Understanding resource endpoint URL (no trailing slash).\",\n      order: 0,\n    },\n  },\n  secret: {\n    apiKey: {\n      key: \"apiKey\",\n      label: \"API key\",\n      type: \"password\" as const,\n      required: true,\n      order: 1,\n    },\n  },\n  async createSession(args) {\n    return buildSession(args);\n  },\n  async test(args) {\n    try {\n      const session = buildSession(args);\n      const client = new ContentUnderstandingClient(session.endpoint, new AzureKeyCredential(session.apiKey));\n      const iter = client.listAnalyzers();\n      await iter.next();\n      return {\n        status: \"healthy\",\n        message: \"Listed analyzers successfully.\",\n        testedAt: new Date().toISOString(),\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return {\n        status: \"failing\",\n        message: message || \"Azure Content Understanding connection failed.\",\n        testedAt: new Date().toISOString(),\n      };\n    }\n  },\n});\n","import type {\n  AnalysisResult,\n  ArrayField,\n  BooleanField,\n  ContentField,\n  ContentFieldUnion,\n  DateField,\n  IntegerField,\n  JsonField,\n  NumberField,\n  ObjectField,\n  StringField,\n  TimeField,\n} from \"@azure/ai-content-understanding\";\nimport { ContentUnderstandingClient } from \"@azure/ai-content-understanding\";\nimport { AzureKeyCredential } from \"@azure/core-auth\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\n\n/** Structured analyzer fields: scalars at leaves; nested objects and arrays preserved. */\nexport type OcrStructuredFields = Readonly<Record<string, unknown>>;\n\n/** The output shape returned by all OCR analyzer nodes. */\nexport type OcrAnalysisOutput = Readonly<{\n  /** Markdown representation of the document content. */\n  content: string;\n  /** Structured fields extracted by the prebuilt analyzer. */\n  fields: OcrStructuredFields;\n}>;\n\n/**\n * Analyzes a binary document using an Azure Content Understanding prebuilt analyzer.\n * Retries on transient failures are handled by the engine via the node's `retryPolicy`.\n */\nexport async function analyzeWithAzure(\n  args: Readonly<{\n    session: AzureContentUnderstandingSession;\n    analyzerId: string;\n    body: Uint8Array;\n    contentType: string;\n  }>,\n): Promise<OcrAnalysisOutput> {\n  const client = new ContentUnderstandingClient(args.session.endpoint, new AzureKeyCredential(args.session.apiKey));\n  const poller = client.analyzeBinary(args.analyzerId, args.body, args.contentType);\n  const result = await poller.pollUntilDone();\n  return mapAnalysisResult(result);\n}\n\n/** @internal Exported for testing — maps a raw AnalysisResult to the node output shape. */\nexport function mapAnalysisResult(result: AnalysisResult): OcrAnalysisOutput {\n  const contents = result.contents ?? [];\n  const markdownParts: string[] = [];\n  for (const c of contents) {\n    if (typeof c.markdown === \"string\" && c.markdown.length > 0) {\n      markdownParts.push(c.markdown);\n    }\n  }\n  const content = markdownParts.join(\"\\n\\n\");\n  if (contents.length === 0) {\n    return { content: \"\", fields: {} };\n  }\n  if (contents.length === 1) {\n    const c = contents[0]!;\n    return {\n      content,\n      fields: c.fields ? fieldsToStructuredMap(c.fields) : {},\n    };\n  }\n  return {\n    content,\n    fields: {\n      segments: contents.map((c, index) => ({\n        index,\n        markdown: typeof c.markdown === \"string\" && c.markdown.trim().length > 0 ? c.markdown : undefined,\n        fields: c.fields ? fieldsToStructuredMap(c.fields) : {},\n      })),\n    },\n  };\n}\n\nfunction fieldsToStructuredMap(fields: Readonly<Record<string, ContentFieldUnion>>): OcrStructuredFields {\n  const out: Record<string, unknown> = {};\n  for (const [name, field] of Object.entries(fields)) {\n    out[name] = fieldToStructuredValue(field);\n  }\n  return out;\n}\n\nfunction fieldToStructuredValue(field: ContentFieldUnion): unknown {\n  const kind = resolveFieldKind(field);\n  switch (kind) {\n    case \"string\":\n      return (field as StringField).value ?? null;\n    case \"date\": {\n      const d = (field as DateField).value;\n      return d ? d.toISOString() : null;\n    }\n    case \"time\":\n      return (field as TimeField).value ?? null;\n    case \"number\":\n      return (field as NumberField).value ?? null;\n    case \"integer\":\n      return (field as IntegerField).value ?? null;\n    case \"boolean\":\n      return (field as BooleanField).value ?? null;\n    case \"array\": {\n      const values = (field as ArrayField).value ?? [];\n      return values.map((element) => fieldToStructuredValue(element));\n    }\n    case \"object\": {\n      const properties = (field as ObjectField).value ?? {};\n      return fieldsToStructuredMap(properties);\n    }\n    case \"json\":\n      return (field as JsonField).value ?? null;\n    default: {\n      const base = field as ContentField;\n      if (base.value === undefined || base.value === null) {\n        return null;\n      }\n      return typeof base.value === \"object\" ? base.value : String(base.value);\n    }\n  }\n}\n\nfunction resolveFieldKind(field: ContentFieldUnion): string {\n  if (\"fieldType\" in field && typeof field.fieldType === \"string\") {\n    return field.fieldType;\n  }\n  return (field as ContentField).type;\n}\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Default Azure Content Understanding prebuilt general document analyzer ID. */\nconst DEFAULT_DOCUMENT_ANALYZER_ID = \"prebuilt-document\";\n\nexport type AnalyzeDocumentConfig = Readonly<{\n  /** Key on `item.binary` that holds the document bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /**\n   * Azure Content Understanding analyzer ID to use.\n   * Defaults to `\"prebuilt-document\"`. Set this to a custom analyzer ID when you have\n   * a trained model or need a different prebuilt variant.\n   */\n  analyzerId?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeDocumentNode = defineNode({\n  key: \"azure-ocr.analyze-document\",\n  title: \"Analyze Document\",\n  description:\n    \"Runs an Azure Content Understanding document analyzer on a binary attachment and returns markdown text plus structured fields. Defaults to the prebuilt general document analyzer.\",\n  icon: \"lucide:scan-text\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    analyzerId: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeDocumentConfig;\n    const analyzerId = cfg.analyzerId ?? DEFAULT_DOCUMENT_ANALYZER_ID;\n    const rows = [{ label: \"Analyzer\", value: analyzerId }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeDocumentConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Document: no binary attachment at key \"${binaryField}\".`);\n    }\n    const analyzerId = config.analyzerId ?? DEFAULT_DOCUMENT_ANALYZER_ID;\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId, body, contentType });\n  },\n});\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Default Azure Content Understanding prebuilt image analyzer ID. */\nconst DEFAULT_IMAGE_ANALYZER_ID = \"prebuilt-imageAnalyzer\";\n\nexport type AnalyzeImageConfig = Readonly<{\n  /** Key on `item.binary` that holds the image bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /**\n   * Azure Content Understanding analyzer ID to use.\n   * Defaults to `\"prebuilt-imageAnalyzer\"`. Set this to a custom analyzer ID when you have\n   * a trained model or need a different prebuilt variant.\n   */\n  analyzerId?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeImageNode = defineNode({\n  key: \"azure-ocr.analyze-image\",\n  title: \"Analyze Image\",\n  description:\n    \"Runs an Azure Content Understanding image analyzer on a binary attachment and returns markdown text plus structured fields. Defaults to the prebuilt image analyzer.\",\n  icon: \"lucide:image-search\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    analyzerId: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeImageConfig;\n    const analyzerId = cfg.analyzerId ?? DEFAULT_IMAGE_ANALYZER_ID;\n    const rows = [{ label: \"Analyzer\", value: analyzerId }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeImageConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Image: no binary attachment at key \"${binaryField}\".`);\n    }\n    const analyzerId = config.analyzerId ?? DEFAULT_IMAGE_ANALYZER_ID;\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId, body, contentType });\n  },\n});\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Azure Content Understanding prebuilt invoice analyzer ID. */\nconst PREBUILT_INVOICE_ANALYZER_ID = \"prebuilt-invoice\";\n\nexport type AnalyzeInvoiceConfig = Readonly<{\n  /** Key on `item.binary` that holds the document bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeInvoiceNode = defineNode({\n  key: \"azure-ocr.analyze-invoice\",\n  title: \"Analyze Invoice\",\n  description:\n    \"Runs the Azure Content Understanding prebuilt invoice analyzer on a binary attachment and returns markdown text plus structured fields.\",\n  icon: \"lucide:receipt\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeInvoiceConfig;\n    const rows = [{ label: \"Analyzer\", value: \"Invoice (prebuilt)\" }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeInvoiceConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Invoice: no binary attachment at key \"${binaryField}\".`);\n    }\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId: PREBUILT_INVOICE_ANALYZER_ID, body, contentType });\n  },\n});\n"],"mappings":"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"}

package/dist/{analyzeInvoiceNode-BIw8j_Zb.cjs → analyzeInvoiceNode-CmMsifbw.cjs}

@@ -128,38 +128,6 @@ function resolveFieldKind(field) {
 	return field.type;
 }
 
-//#endregion
-//#region src/lib/readBinaryBody.ts
-/** Default cap on bytes read into memory. Tuned for prebuilt OCR analyzers (single document). */
-const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
-/**
-* Reads the binary body for an OCR analyzer call.
-*
-* The Azure Content Understanding SDK requires a contiguous `Uint8Array`, so the bytes must
-* land in memory at some point. To bound that:
-*  - The attachment's declared `size` is checked against `maxBytes` *before* any allocation.
-*  - A single buffer of exactly `attachment.size` is pre-allocated (no chunks array, no doubling).
-*  - The stream fills the buffer directly; a length mismatch fails fast.
-*/
-async function readBinaryBody(ctx, attachment, maxBytes = DEFAULT_MAX_BYTES) {
-	if (attachment.size > maxBytes) throw new Error(`Binary attachment size ${attachment.size} bytes exceeds maxBytes ${maxBytes}. Raise the node's maxBytes setting if this document is expected to be larger.`);
-	const stream = await ctx.binary.openReadStream(attachment);
-	if (!stream) throw new Error("Binary attachment stream is unavailable.");
-	const out = new Uint8Array(attachment.size);
-	const reader = stream.body.getReader();
-	let offset = 0;
-	while (true) {
-		const { done, value } = await reader.read();
-		if (done) break;
-		if (!value) continue;
-		if (offset + value.byteLength > out.byteLength) throw new Error(`Binary stream produced more bytes than the attachment's declared size (${attachment.size}).`);
-		out.set(value, offset);
-		offset += value.byteLength;
-	}
-	if (offset !== out.byteLength) throw new Error(`Binary stream produced ${offset} bytes but attachment declared size ${attachment.size}.`);
-	return out;
-}
-
 //#endregion
 //#region src/nodes/analyzeDocumentNode.ts
 /** Default Azure Content Understanding prebuilt general document analyzer ID. */
@@ -208,7 +176,7 @@ const analyzeDocumentNode = (0, __codemation_core.defineNode)({
 		return analyzeWithAzure({
 			session,
 			analyzerId,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -262,7 +230,7 @@ const analyzeImageNode = (0, __codemation_core.defineNode)({
 		return analyzeWithAzure({
 			session,
 			analyzerId,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -314,7 +282,7 @@ const analyzeInvoiceNode = (0, __codemation_core.defineNode)({
 		return analyzeWithAzure({
 			session,
 			analyzerId: PREBUILT_INVOICE_ANALYZER_ID,
-			body: await readBinaryBody(ctx, attachment, config.maxBytes),
+			body: await ctx.binary.getBytes(attachment, config.maxBytes),
 			contentType
 		});
 	}
@@ -357,4 +325,4 @@ Object.defineProperty(exports, 'mapAnalysisResult', {
     return mapAnalysisResult;
   }
 });
-//# sourceMappingURL=analyzeInvoiceNode-BIw8j_Zb.cjs.map
+//# sourceMappingURL=analyzeInvoiceNode-CmMsifbw.cjs.map

package/dist/analyzeInvoiceNode-CmMsifbw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeInvoiceNode-CmMsifbw.cjs","names":["ContentUnderstandingClient","AzureKeyCredential","ContentUnderstandingClient","AzureKeyCredential","markdownParts: string[]","out: Record<string, unknown>"],"sources":["../src/credentials/azureContentUnderstandingCredential.ts","../src/lib/analyzeWithAzure.ts","../src/nodes/analyzeDocumentNode.ts","../src/nodes/analyzeImageNode.ts","../src/nodes/analyzeInvoiceNode.ts"],"sourcesContent":["import { ContentUnderstandingClient } from \"@azure/ai-content-understanding\";\nimport { AzureKeyCredential } from \"@azure/core-auth\";\nimport { defineCredential } from \"@codemation/core\";\n\nexport type AzureContentUnderstandingSession = Readonly<{\n  endpoint: string;\n  apiKey: string;\n}>;\n\nfunction normalizeEndpoint(raw: string): string {\n  return raw.trim().replace(/\\/+$/, \"\");\n}\n\nfunction buildSession(args: {\n  readonly publicConfig: Readonly<Record<string, unknown>>;\n  readonly material: Readonly<Record<string, unknown>>;\n}): AzureContentUnderstandingSession {\n  const endpoint = normalizeEndpoint(String(args.publicConfig[\"endpoint\"] ?? \"\"));\n  const apiKey = String(args.material[\"apiKey\"] ?? \"\").trim();\n  if (!endpoint) {\n    throw new Error(\"Azure Content Understanding credential is incomplete: endpoint is required.\");\n  }\n  if (!apiKey) {\n    throw new Error(\"Azure Content Understanding credential is incomplete: API key is required.\");\n  }\n  return { endpoint, apiKey };\n}\n\nexport const azureContentUnderstandingCredentialType = defineCredential({\n  key: \"azure.contentUnderstanding\",\n  label: \"Azure Content Understanding\",\n  description: \"Azure AI Content Understanding (endpoint + key) for prebuilt document, invoice, and image analyzers.\",\n  public: {\n    endpoint: {\n      key: \"endpoint\",\n      label: \"Endpoint\",\n      type: \"string\" as const,\n      required: true,\n      placeholder: \"https://your-resource.cognitiveservices.azure.com/\",\n      helpText: \"Content Understanding resource endpoint URL (no trailing slash).\",\n      order: 0,\n    },\n  },\n  secret: {\n    apiKey: {\n      key: \"apiKey\",\n      label: \"API key\",\n      type: \"password\" as const,\n      required: true,\n      order: 1,\n    },\n  },\n  async createSession(args) {\n    return buildSession(args);\n  },\n  async test(args) {\n    try {\n      const session = buildSession(args);\n      const client = new ContentUnderstandingClient(session.endpoint, new AzureKeyCredential(session.apiKey));\n      const iter = client.listAnalyzers();\n      await iter.next();\n      return {\n        status: \"healthy\",\n        message: \"Listed analyzers successfully.\",\n        testedAt: new Date().toISOString(),\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return {\n        status: \"failing\",\n        message: message || \"Azure Content Understanding connection failed.\",\n        testedAt: new Date().toISOString(),\n      };\n    }\n  },\n});\n","import type {\n  AnalysisResult,\n  ArrayField,\n  BooleanField,\n  ContentField,\n  ContentFieldUnion,\n  DateField,\n  IntegerField,\n  JsonField,\n  NumberField,\n  ObjectField,\n  StringField,\n  TimeField,\n} from \"@azure/ai-content-understanding\";\nimport { ContentUnderstandingClient } from \"@azure/ai-content-understanding\";\nimport { AzureKeyCredential } from \"@azure/core-auth\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\n\n/** Structured analyzer fields: scalars at leaves; nested objects and arrays preserved. */\nexport type OcrStructuredFields = Readonly<Record<string, unknown>>;\n\n/** The output shape returned by all OCR analyzer nodes. */\nexport type OcrAnalysisOutput = Readonly<{\n  /** Markdown representation of the document content. */\n  content: string;\n  /** Structured fields extracted by the prebuilt analyzer. */\n  fields: OcrStructuredFields;\n}>;\n\n/**\n * Analyzes a binary document using an Azure Content Understanding prebuilt analyzer.\n * Retries on transient failures are handled by the engine via the node's `retryPolicy`.\n */\nexport async function analyzeWithAzure(\n  args: Readonly<{\n    session: AzureContentUnderstandingSession;\n    analyzerId: string;\n    body: Uint8Array;\n    contentType: string;\n  }>,\n): Promise<OcrAnalysisOutput> {\n  const client = new ContentUnderstandingClient(args.session.endpoint, new AzureKeyCredential(args.session.apiKey));\n  const poller = client.analyzeBinary(args.analyzerId, args.body, args.contentType);\n  const result = await poller.pollUntilDone();\n  return mapAnalysisResult(result);\n}\n\n/** @internal Exported for testing — maps a raw AnalysisResult to the node output shape. */\nexport function mapAnalysisResult(result: AnalysisResult): OcrAnalysisOutput {\n  const contents = result.contents ?? [];\n  const markdownParts: string[] = [];\n  for (const c of contents) {\n    if (typeof c.markdown === \"string\" && c.markdown.length > 0) {\n      markdownParts.push(c.markdown);\n    }\n  }\n  const content = markdownParts.join(\"\\n\\n\");\n  if (contents.length === 0) {\n    return { content: \"\", fields: {} };\n  }\n  if (contents.length === 1) {\n    const c = contents[0]!;\n    return {\n      content,\n      fields: c.fields ? fieldsToStructuredMap(c.fields) : {},\n    };\n  }\n  return {\n    content,\n    fields: {\n      segments: contents.map((c, index) => ({\n        index,\n        markdown: typeof c.markdown === \"string\" && c.markdown.trim().length > 0 ? c.markdown : undefined,\n        fields: c.fields ? fieldsToStructuredMap(c.fields) : {},\n      })),\n    },\n  };\n}\n\nfunction fieldsToStructuredMap(fields: Readonly<Record<string, ContentFieldUnion>>): OcrStructuredFields {\n  const out: Record<string, unknown> = {};\n  for (const [name, field] of Object.entries(fields)) {\n    out[name] = fieldToStructuredValue(field);\n  }\n  return out;\n}\n\nfunction fieldToStructuredValue(field: ContentFieldUnion): unknown {\n  const kind = resolveFieldKind(field);\n  switch (kind) {\n    case \"string\":\n      return (field as StringField).value ?? null;\n    case \"date\": {\n      const d = (field as DateField).value;\n      return d ? d.toISOString() : null;\n    }\n    case \"time\":\n      return (field as TimeField).value ?? null;\n    case \"number\":\n      return (field as NumberField).value ?? null;\n    case \"integer\":\n      return (field as IntegerField).value ?? null;\n    case \"boolean\":\n      return (field as BooleanField).value ?? null;\n    case \"array\": {\n      const values = (field as ArrayField).value ?? [];\n      return values.map((element) => fieldToStructuredValue(element));\n    }\n    case \"object\": {\n      const properties = (field as ObjectField).value ?? {};\n      return fieldsToStructuredMap(properties);\n    }\n    case \"json\":\n      return (field as JsonField).value ?? null;\n    default: {\n      const base = field as ContentField;\n      if (base.value === undefined || base.value === null) {\n        return null;\n      }\n      return typeof base.value === \"object\" ? base.value : String(base.value);\n    }\n  }\n}\n\nfunction resolveFieldKind(field: ContentFieldUnion): string {\n  if (\"fieldType\" in field && typeof field.fieldType === \"string\") {\n    return field.fieldType;\n  }\n  return (field as ContentField).type;\n}\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Default Azure Content Understanding prebuilt general document analyzer ID. */\nconst DEFAULT_DOCUMENT_ANALYZER_ID = \"prebuilt-document\";\n\nexport type AnalyzeDocumentConfig = Readonly<{\n  /** Key on `item.binary` that holds the document bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /**\n   * Azure Content Understanding analyzer ID to use.\n   * Defaults to `\"prebuilt-document\"`. Set this to a custom analyzer ID when you have\n   * a trained model or need a different prebuilt variant.\n   */\n  analyzerId?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeDocumentNode = defineNode({\n  key: \"azure-ocr.analyze-document\",\n  title: \"Analyze Document\",\n  description:\n    \"Runs an Azure Content Understanding document analyzer on a binary attachment and returns markdown text plus structured fields. Defaults to the prebuilt general document analyzer.\",\n  icon: \"lucide:scan-text\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    analyzerId: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeDocumentConfig;\n    const analyzerId = cfg.analyzerId ?? DEFAULT_DOCUMENT_ANALYZER_ID;\n    const rows = [{ label: \"Analyzer\", value: analyzerId }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeDocumentConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Document: no binary attachment at key \"${binaryField}\".`);\n    }\n    const analyzerId = config.analyzerId ?? DEFAULT_DOCUMENT_ANALYZER_ID;\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId, body, contentType });\n  },\n});\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Default Azure Content Understanding prebuilt image analyzer ID. */\nconst DEFAULT_IMAGE_ANALYZER_ID = \"prebuilt-imageAnalyzer\";\n\nexport type AnalyzeImageConfig = Readonly<{\n  /** Key on `item.binary` that holds the image bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /**\n   * Azure Content Understanding analyzer ID to use.\n   * Defaults to `\"prebuilt-imageAnalyzer\"`. Set this to a custom analyzer ID when you have\n   * a trained model or need a different prebuilt variant.\n   */\n  analyzerId?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeImageNode = defineNode({\n  key: \"azure-ocr.analyze-image\",\n  title: \"Analyze Image\",\n  description:\n    \"Runs an Azure Content Understanding image analyzer on a binary attachment and returns markdown text plus structured fields. Defaults to the prebuilt image analyzer.\",\n  icon: \"lucide:image-search\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    analyzerId: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeImageConfig;\n    const analyzerId = cfg.analyzerId ?? DEFAULT_IMAGE_ANALYZER_ID;\n    const rows = [{ label: \"Analyzer\", value: analyzerId }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeImageConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Image: no binary attachment at key \"${binaryField}\".`);\n    }\n    const analyzerId = config.analyzerId ?? DEFAULT_IMAGE_ANALYZER_ID;\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId, body, contentType });\n  },\n});\n","import { defineNode } from \"@codemation/core\";\nimport type { AzureContentUnderstandingSession } from \"../credentials/azureContentUnderstandingCredential\";\nimport { azureContentUnderstandingCredentialType } from \"../credentials/azureContentUnderstandingCredential\";\nimport { analyzeWithAzure } from \"../lib/analyzeWithAzure\";\n\n/** Azure Content Understanding prebuilt invoice analyzer ID. */\nconst PREBUILT_INVOICE_ANALYZER_ID = \"prebuilt-invoice\";\n\nexport type AnalyzeInvoiceConfig = Readonly<{\n  /** Key on `item.binary` that holds the document bytes. Default: `\"data\"`. */\n  binaryField?: string;\n  /** MIME type override sent to the analyzer. Falls back to attachment `mimeType` when not set. */\n  contentType?: string;\n  /** Max bytes the attachment may have before reading. Defaults to 50 MiB. */\n  maxBytes?: number;\n}>;\n\nexport const analyzeInvoiceNode = defineNode({\n  key: \"azure-ocr.analyze-invoice\",\n  title: \"Analyze Invoice\",\n  description:\n    \"Runs the Azure Content Understanding prebuilt invoice analyzer on a binary attachment and returns markdown text plus structured fields.\",\n  icon: \"lucide:receipt\",\n  input: {\n    binaryField: \"data\",\n    contentType: undefined as string | undefined,\n    maxBytes: undefined as number | undefined,\n  },\n  credentials: {\n    contentUnderstanding: {\n      type: azureContentUnderstandingCredentialType as import(\"@codemation/core\").AnyCredentialType,\n      label: \"Azure Content Understanding\",\n      helpText: \"Bind an Azure Content Understanding credential (endpoint + key).\",\n    },\n  },\n  inspectorSummary({ config }) {\n    const cfg = config as unknown as AnalyzeInvoiceConfig;\n    const rows = [{ label: \"Analyzer\", value: \"Invoice (prebuilt)\" }];\n    const binaryField = cfg.binaryField ?? \"data\";\n    if (binaryField !== \"data\") {\n      rows.push({ label: \"Binary field\", value: binaryField });\n    }\n    if (cfg.contentType) {\n      rows.push({ label: \"Content type\", value: cfg.contentType });\n    }\n    return rows;\n  },\n  async execute({ item, ctx }, { config: rawConfig, credentials }) {\n    const config = rawConfig as unknown as AnalyzeInvoiceConfig;\n    const session = (await credentials.contentUnderstanding()) as AzureContentUnderstandingSession;\n    const binaryField = config.binaryField ?? \"data\";\n    const attachment = item.binary?.[binaryField];\n    if (!attachment) {\n      throw new Error(`Analyze Invoice: no binary attachment at key \"${binaryField}\".`);\n    }\n    const contentType = config.contentType ?? attachment.mimeType ?? \"application/octet-stream\";\n    const body = await ctx.binary.getBytes(attachment, config.maxBytes);\n    return analyzeWithAzure({ session, analyzerId: PREBUILT_INVOICE_ANALYZER_ID, body, contentType });\n  },\n});\n"],"mappings":";;;;;;;;;AASA,SAAS,kBAAkB,KAAqB;AAC9C,QAAO,IAAI,MAAM,CAAC,QAAQ,QAAQ,GAAG;;AAGvC,SAAS,aAAa,MAGe;CACnC,MAAM,WAAW,kBAAkB,OAAO,KAAK,aAAa,eAAe,GAAG,CAAC;CAC/E,MAAM,SAAS,OAAO,KAAK,SAAS,aAAa,GAAG,CAAC,MAAM;AAC3D,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,8EAA8E;AAEhG,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,6EAA6E;AAE/F,QAAO;EAAE;EAAU;EAAQ;;AAG7B,MAAa,kFAA2D;CACtE,KAAK;CACL,OAAO;CACP,aAAa;CACb,QAAQ,EACN,UAAU;EACR,KAAK;EACL,OAAO;EACP,MAAM;EACN,UAAU;EACV,aAAa;EACb,UAAU;EACV,OAAO;EACR,EACF;CACD,QAAQ,EACN,QAAQ;EACN,KAAK;EACL,OAAO;EACP,MAAM;EACN,UAAU;EACV,OAAO;EACR,EACF;CACD,MAAM,cAAc,MAAM;AACxB,SAAO,aAAa,KAAK;;CAE3B,MAAM,KAAK,MAAM;AACf,MAAI;GACF,MAAM,UAAU,aAAa,KAAK;AAGlC,SAFe,IAAIA,4DAA2B,QAAQ,UAAU,IAAIC,qCAAmB,QAAQ,OAAO,CAAC,CACnF,eAAe,CACxB,MAAM;AACjB,UAAO;IACL,QAAQ;IACR,SAAS;IACT,2BAAU,IAAI,MAAM,EAAC,aAAa;IACnC;WACM,OAAO;AAEd,UAAO;IACL,QAAQ;IACR,UAHc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,KAGhD;IACpB,2BAAU,IAAI,MAAM,EAAC,aAAa;IACnC;;;CAGN,CAAC;;;;;;;;AC1CF,eAAsB,iBACpB,MAM4B;AAI5B,QAAO,kBADQ,MAFA,IAAIC,4DAA2B,KAAK,QAAQ,UAAU,IAAIC,qCAAmB,KAAK,QAAQ,OAAO,CAAC,CAC3F,cAAc,KAAK,YAAY,KAAK,MAAM,KAAK,YAAY,CACrD,eAAe,CACX;;;AAIlC,SAAgB,kBAAkB,QAA2C;CAC3E,MAAM,WAAW,OAAO,YAAY,EAAE;CACtC,MAAMC,gBAA0B,EAAE;AAClC,MAAK,MAAM,KAAK,SACd,KAAI,OAAO,EAAE,aAAa,YAAY,EAAE,SAAS,SAAS,EACxD,eAAc,KAAK,EAAE,SAAS;CAGlC,MAAM,UAAU,cAAc,KAAK,OAAO;AAC1C,KAAI,SAAS,WAAW,EACtB,QAAO;EAAE,SAAS;EAAI,QAAQ,EAAE;EAAE;AAEpC,KAAI,SAAS,WAAW,GAAG;EACzB,MAAM,IAAI,SAAS;AACnB,SAAO;GACL;GACA,QAAQ,EAAE,SAAS,sBAAsB,EAAE,OAAO,GAAG,EAAE;GACxD;;AAEH,QAAO;EACL;EACA,QAAQ,EACN,UAAU,SAAS,KAAK,GAAG,WAAW;GACpC;GACA,UAAU,OAAO,EAAE,aAAa,YAAY,EAAE,SAAS,MAAM,CAAC,SAAS,IAAI,EAAE,WAAW;GACxF,QAAQ,EAAE,SAAS,sBAAsB,EAAE,OAAO,GAAG,EAAE;GACxD,EAAE,EACJ;EACF;;AAGH,SAAS,sBAAsB,QAA0E;CACvG,MAAMC,MAA+B,EAAE;AACvC,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,CAChD,KAAI,QAAQ,uBAAuB,MAAM;AAE3C,QAAO;;AAGT,SAAS,uBAAuB,OAAmC;AAEjE,SADa,iBAAiB,MAAM,EACpC;EACE,KAAK,SACH,QAAQ,MAAsB,SAAS;EACzC,KAAK,QAAQ;GACX,MAAM,IAAK,MAAoB;AAC/B,UAAO,IAAI,EAAE,aAAa,GAAG;;EAE/B,KAAK,OACH,QAAQ,MAAoB,SAAS;EACvC,KAAK,SACH,QAAQ,MAAsB,SAAS;EACzC,KAAK,UACH,QAAQ,MAAuB,SAAS;EAC1C,KAAK,UACH,QAAQ,MAAuB,SAAS;EAC1C,KAAK,QAEH,SADgB,MAAqB,SAAS,EAAE,EAClC,KAAK,YAAY,uBAAuB,QAAQ,CAAC;EAEjE,KAAK,SAEH,QAAO,sBADa,MAAsB,SAAS,EAAE,CACb;EAE1C,KAAK,OACH,QAAQ,MAAoB,SAAS;EACvC,SAAS;GACP,MAAM,OAAO;AACb,OAAI,KAAK,UAAU,UAAa,KAAK,UAAU,KAC7C,QAAO;AAET,UAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,OAAO,KAAK,MAAM;;;;AAK7E,SAAS,iBAAiB,OAAkC;AAC1D,KAAI,eAAe,SAAS,OAAO,MAAM,cAAc,SACrD,QAAO,MAAM;AAEf,QAAQ,MAAuB;;;;;;AC1HjC,MAAM,+BAA+B;AAiBrC,MAAa,wDAAiC;CAC5C,KAAK;CACL,OAAO;CACP,aACE;CACF,MAAM;CACN,OAAO;EACL,aAAa;EACb,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD,aAAa,EACX,sBAAsB;EACpB,MAAM;EACN,OAAO;EACP,UAAU;EACX,EACF;CACD,iBAAiB,EAAE,UAAU;EAC3B,MAAM,MAAM;EAEZ,MAAM,OAAO,CAAC;GAAE,OAAO;GAAY,OADhB,IAAI,cAAc;GACiB,CAAC;EACvD,MAAM,cAAc,IAAI,eAAe;AACvC,MAAI,gBAAgB,OAClB,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO;GAAa,CAAC;AAE1D,MAAI,IAAI,YACN,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO,IAAI;GAAa,CAAC;AAE9D,SAAO;;CAET,MAAM,QAAQ,EAAE,MAAM,OAAO,EAAE,QAAQ,WAAW,eAAe;EAC/D,MAAM,SAAS;EACf,MAAM,UAAW,MAAM,YAAY,sBAAsB;EACzD,MAAM,cAAc,OAAO,eAAe;EAC1C,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,kDAAkD,YAAY,IAAI;EAEpF,MAAM,aAAa,OAAO,cAAc;EACxC,MAAM,cAAc,OAAO,eAAe,WAAW,YAAY;AAEjE,SAAO,iBAAiB;GAAE;GAAS;GAAY,MADlC,MAAM,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS;GACd;GAAa,CAAC;;CAEtE,CAAC;;;;;AC9DF,MAAM,4BAA4B;AAiBlC,MAAa,qDAA8B;CACzC,KAAK;CACL,OAAO;CACP,aACE;CACF,MAAM;CACN,OAAO;EACL,aAAa;EACb,aAAa;EACb,YAAY;EACZ,UAAU;EACX;CACD,aAAa,EACX,sBAAsB;EACpB,MAAM;EACN,OAAO;EACP,UAAU;EACX,EACF;CACD,iBAAiB,EAAE,UAAU;EAC3B,MAAM,MAAM;EAEZ,MAAM,OAAO,CAAC;GAAE,OAAO;GAAY,OADhB,IAAI,cAAc;GACiB,CAAC;EACvD,MAAM,cAAc,IAAI,eAAe;AACvC,MAAI,gBAAgB,OAClB,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO;GAAa,CAAC;AAE1D,MAAI,IAAI,YACN,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO,IAAI;GAAa,CAAC;AAE9D,SAAO;;CAET,MAAM,QAAQ,EAAE,MAAM,OAAO,EAAE,QAAQ,WAAW,eAAe;EAC/D,MAAM,SAAS;EACf,MAAM,UAAW,MAAM,YAAY,sBAAsB;EACzD,MAAM,cAAc,OAAO,eAAe;EAC1C,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,+CAA+C,YAAY,IAAI;EAEjF,MAAM,aAAa,OAAO,cAAc;EACxC,MAAM,cAAc,OAAO,eAAe,WAAW,YAAY;AAEjE,SAAO,iBAAiB;GAAE;GAAS;GAAY,MADlC,MAAM,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS;GACd;GAAa,CAAC;;CAEtE,CAAC;;;;;AC9DF,MAAM,+BAA+B;AAWrC,MAAa,uDAAgC;CAC3C,KAAK;CACL,OAAO;CACP,aACE;CACF,MAAM;CACN,OAAO;EACL,aAAa;EACb,aAAa;EACb,UAAU;EACX;CACD,aAAa,EACX,sBAAsB;EACpB,MAAM;EACN,OAAO;EACP,UAAU;EACX,EACF;CACD,iBAAiB,EAAE,UAAU;EAC3B,MAAM,MAAM;EACZ,MAAM,OAAO,CAAC;GAAE,OAAO;GAAY,OAAO;GAAsB,CAAC;EACjE,MAAM,cAAc,IAAI,eAAe;AACvC,MAAI,gBAAgB,OAClB,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO;GAAa,CAAC;AAE1D,MAAI,IAAI,YACN,MAAK,KAAK;GAAE,OAAO;GAAgB,OAAO,IAAI;GAAa,CAAC;AAE9D,SAAO;;CAET,MAAM,QAAQ,EAAE,MAAM,OAAO,EAAE,QAAQ,WAAW,eAAe;EAC/D,MAAM,SAAS;EACf,MAAM,UAAW,MAAM,YAAY,sBAAsB;EACzD,MAAM,cAAc,OAAO,eAAe;EAC1C,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,iDAAiD,YAAY,IAAI;EAEnF,MAAM,cAAc,OAAO,eAAe,WAAW,YAAY;AAEjE,SAAO,iBAAiB;GAAE;GAAS,YAAY;GAA8B,MADhE,MAAM,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS;GACgB;GAAa,CAAC;;CAEpG,CAAC"}

package/dist/codemation.plugin.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-BaqVhFee.cjs');
-const require_analyzeInvoiceNode = require('./analyzeInvoiceNode-BIw8j_Zb.cjs');
+const require_analyzeInvoiceNode = require('./analyzeInvoiceNode-CmMsifbw.cjs');
 const require_token_util$1 = require('./token-util-B2kSJtEV.cjs');
 let __codemation_core = require("@codemation/core");
 __codemation_core = require_chunk.__toESM(__codemation_core);
@@ -8289,6 +8289,59 @@ var OpenAiChatModelPresets = class {
 };
 const openAiChatModelPresets = new OpenAiChatModelPresets();
 
+//#endregion
+//#region ../core-nodes/src/chatModels/ManagedHmacSignerFactory.types.ts
+/**
+* Creates an HMAC-signing fetch wrapper that authenticates requests to
+* Codemation managed services (LLM broker, doc-scanner) with the
+* Codemation-Hmac v=1 scheme.
+*
+* Mirrors HmacRequestSigner from @codemation/host/pairing without importing
+* that package (which would create a circular dependency since @codemation/host
+* depends on @codemation/core-nodes).
+*
+* @param workspaceId   - Workspace identifier injected by the CP provisioner.
+* @param pairingSecret - Base64-encoded 32-byte HMAC key injected by the provisioner.
+* @param options       - Optional behaviour flags and test seams.
+*/
+function managedHmacFetchFactory(workspaceId, pairingSecret, options) {
+	const signBody = options?.signBody ?? true;
+	return async (input, init) => {
+		const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+		const method = init?.method ?? "POST";
+		let bodyForSigning = "";
+		if (signBody && init?.body !== void 0 && init.body !== null) bodyForSigning = typeof init.body === "string" ? init.body : await new Response(init.body).text();
+		const authHeader = buildHmacAuthHeader(workspaceId, pairingSecret, method, url, bodyForSigning, options);
+		const headers = new Headers(init?.headers);
+		headers.set("Authorization", authHeader);
+		const outgoingBody = signBody ? bodyForSigning || init?.body : init?.body;
+		return fetch(input, {
+			...init,
+			body: outgoingBody,
+			headers
+		});
+	};
+}
+/**
+* Produces a Codemation-Hmac v=1 Authorization header value.
+* Algorithm must match HmacVerifier.computeSignature() in the control-plane.
+*/
+function buildHmacAuthHeader(workspaceId, pairingSecret, method, url, body, overrides) {
+	const ts = overrides?.now ? overrides.now() : Math.floor(Date.now() / 1e3);
+	const nonce = overrides?.nonce ? overrides.nonce() : (0, node_crypto.randomBytes)(16).toString("base64");
+	const parsed = new URL(url);
+	const path = (parsed.pathname + parsed.search).toLowerCase();
+	const bodyHash = (0, node_crypto.createHash)("sha256").update(body, "utf8").digest("hex");
+	const baseString = [
+		method.toUpperCase(),
+		path,
+		ts,
+		nonce,
+		bodyHash
+	].join("\n");
+	return `Codemation-Hmac v=1,workspaceId=${workspaceId},ts=${ts},nonce=${nonce},sig=${(0, node_crypto.createHmac)("sha256", Buffer.from(pairingSecret, "base64")).update(baseString, "utf8").digest("base64")}`;
+}
+
 //#endregion
 //#region ../core-nodes/src/chatModels/CodemationChatModelFactory.ts
 let CodemationChatModelFactory = class CodemationChatModelFactory$1 {
@@ -8298,7 +8351,7 @@ let CodemationChatModelFactory = class CodemationChatModelFactory$1 {
 		const workspaceId = process.env["WORKSPACE_ID"];
 		const pairingSecret = process.env["WORKSPACE_PAIRING_SECRET"];
 		if (!workspaceId || !pairingSecret) throw new Error("Codemation managed AI not available in this environment (workspace pairing is not configured).");
-		const hmacFetch = this.buildHmacSignedFetch(workspaceId, pairingSecret);
+		const hmacFetch = managedHmacFetchFactory(workspaceId, pairingSecret);
 		const languageModel = createOpenAI({
 			baseURL: `${gatewayUrl}/v1`,
 			apiKey: "codemation-managed",
@@ -8314,52 +8367,6 @@ let CodemationChatModelFactory = class CodemationChatModelFactory$1 {
 			}
 		});
 	}
-	/**
-	* Creates an HMAC-signed fetch wrapper for use with AI SDK's createOpenAI.
-	* Each call signs the request body with the workspace pairing secret so the
-	* LLM broker can authenticate the workspace without a user-managed API key.
-	*
-	* Mirrors HmacRequestSigner from @codemation/host/pairing without importing
-	* that package (which would create a circular dependency since @codemation/host
-	* depends on @codemation/core-nodes).
-	*/
-	buildHmacSignedFetch(workspaceId, pairingSecret) {
-		return async (input, init) => {
-			const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
-			const method = init?.method ?? "POST";
-			let bodyString = "";
-			if (init?.body !== void 0 && init.body !== null) if (typeof init.body === "string") bodyString = init.body;
-			else bodyString = await new Response(init.body).text();
-			const authHeader = this.buildHmacAuthHeader(workspaceId, pairingSecret, method, url, bodyString);
-			const headers = new Headers(init?.headers);
-			headers.set("Authorization", authHeader);
-			const effectiveBody = bodyString || init?.body;
-			return fetch(input, {
-				...init,
-				body: effectiveBody,
-				headers
-			});
-		};
-	}
-	/**
-	* Produces a Codemation-Hmac v1 Authorization header value.
-	* The algorithm must match HmacVerifier.computeSignature() in the control-plane.
-	*/
-	buildHmacAuthHeader(workspaceId, pairingSecret, method, url, body) {
-		const ts = Math.floor(Date.now() / 1e3);
-		const nonce = (0, node_crypto.randomBytes)(16).toString("base64");
-		const parsed = new URL(url);
-		const path = (parsed.pathname + parsed.search).toLowerCase();
-		const bodyHash = (0, node_crypto.createHash)("sha256").update(body, "utf8").digest("hex");
-		const baseString = [
-			method.toUpperCase(),
-			path,
-			ts,
-			nonce,
-			bodyHash
-		].join("\n");
-		return `Codemation-Hmac v=1,workspaceId=${workspaceId},ts=${ts},nonce=${nonce},sig=${(0, node_crypto.createHmac)("sha256", Buffer.from(pairingSecret, "base64")).update(baseString, "utf8").digest("base64")}`;
-	}
 };
 CodemationChatModelFactory = __decorate([(0, __codemation_core.chatModel)({ packageName: "@codemation/core-nodes" })], CodemationChatModelFactory);
 
@@ -15997,7 +16004,11 @@ let AIAgentNode = class AIAgentNode$1 {
 		});
 		try {
 			const callOptions = this.resolveCallOptions(model, guardrails.modelInvocationOptions);
-			const outputSchema$1 = structuredOptions?.strict && !this.isZodSchema(schema) ? output_exports.object({ schema: jsonSchema(schema) }) : output_exports.object({ schema });
+			const schemaRecord = this.isZodSchema(schema) ? this.executionHelpers.createJsonSchemaRecord(schema, {
+				schemaName: structuredOptions?.schemaName ?? "structured_output",
+				requireObjectRoot: true
+			}) : schema;
+			const outputSchema$1 = output_exports.object({ schema: jsonSchema(schemaRecord) });
 			const result = await generateText({
 				model: model.languageModel,
 				messages: [...messages],
@@ -18008,6 +18019,86 @@ const inboxApproval = (0, __codemation_core.defineHumanApprovalNode)({
 	}
 });
 
+//#endregion
+//#region ../core-nodes/src/nodes/codemationDocumentScannerNode.ts
+const ANALYZER_TYPES = [
+	"document",
+	"invoice",
+	"image",
+	"auto"
+];
+const codemationDocumentScannerNode = (0, __codemation_core.defineNode)({
+	key: "codemation.document-scanner",
+	title: "Codemation Document Scanner",
+	description: "Analyzes a binary attachment (document or image) via the managed Codemation document-scanning service and returns markdown text plus structured fields. No Azure credential required — auth uses the workspace pairing secret. Enable includeConfidence to get per-field confidence scores (0–1).",
+	icon: "lucide:scan-text",
+	input: {
+		binaryField: "data",
+		analyzerType: "auto",
+		contentType: void 0,
+		includeConfidence: false,
+		maxBytes: void 0
+	},
+	configSchema: zod.z.object({
+		binaryField: zod.z.string().optional(),
+		analyzerType: zod.z.enum(ANALYZER_TYPES).optional(),
+		contentType: zod.z.string().optional(),
+		includeConfidence: zod.z.boolean().optional(),
+		maxBytes: zod.z.number().int().positive().optional()
+	}),
+	inspectorSummary({ config }) {
+		const cfg = config;
+		const rows = [{
+			label: "Analyzer type",
+			value: cfg.analyzerType ?? "auto"
+		}];
+		const binaryField = cfg.binaryField ?? "data";
+		if (binaryField !== "data") rows.push({
+			label: "Binary field",
+			value: binaryField
+		});
+		if (cfg.includeConfidence) rows.push({
+			label: "Confidence",
+			value: "enabled"
+		});
+		if (cfg.contentType) rows.push({
+			label: "Content type",
+			value: cfg.contentType
+		});
+		return rows;
+	},
+	async execute({ item, ctx }, { config: rawConfig }) {
+		const config = rawConfig;
+		const gatewayUrl = process.env["DOC_SCANNER_GATEWAY_URL"];
+		if (!gatewayUrl) throw new Error("Codemation Document Scanner not available in this environment (DOC_SCANNER_GATEWAY_URL is not set).");
+		const workspaceId = process.env["WORKSPACE_ID"];
+		const pairingSecret = process.env["WORKSPACE_PAIRING_SECRET"];
+		if (!workspaceId || !pairingSecret) throw new Error("Codemation Document Scanner not available (workspace pairing is not configured).");
+		const binaryField = config.binaryField ?? "data";
+		const attachment = item.binary?.[binaryField];
+		if (!attachment) throw new Error(`Codemation Document Scanner: no binary attachment at key "${binaryField}".`);
+		const body = await ctx.binary.getBytes(attachment, config.maxBytes);
+		const contentType = config.contentType ?? attachment.mimeType ?? "application/octet-stream";
+		const analyzerType = config.analyzerType ?? "auto";
+		const confidenceSuffix = config.includeConfidence ?? false ? "&confidence=true" : "";
+		const url = `${gatewayUrl}/analyze?type=${encodeURIComponent(analyzerType)}${confidenceSuffix}`;
+		const response = await managedHmacFetchFactory(workspaceId, pairingSecret, { signBody: false })(url, {
+			method: "POST",
+			body: body.buffer,
+			headers: {
+				"Content-Type": contentType,
+				"Content-Length": String(body.byteLength),
+				"X-Codemation-Caller": "workflow-node"
+			}
+		});
+		if (!response.ok) {
+			const text$1 = await response.text().catch(() => "(unreadable)");
+			throw new Error(`Codemation Document Scanner: service responded ${response.status} ${response.statusText} — ${text$1}`);
+		}
+		return await response.json();
+	}
+});
+
 //#endregion
 //#region ../host/src/presentation/config/CodemationAuthoring.types.ts
 var CodemationAuthoringConfigFactory = class {