@factify/sdk 1.1.0-rc.11 → 1.1.0-rc.13

package/src/models/components/qcrv1alphasheetchart.ts

@@ -0,0 +1,85 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaVectorImageData,
+  QcrV1alphaVectorImageData$inboundSchema,
+} from "./qcrv1alphavectorimagedata.js";
+import { Value, Value$inboundSchema } from "./value.js";
+
+/**
+ * Chart rendered as a figure plus metadata.
+ */
+export type QcrV1alphaSheetChart = {
+  anchorCol?: number | undefined;
+  anchorRow?: number | undefined;
+  /**
+   * `Struct` represents a structured data value, consisting of fields
+   *
+   * @remarks
+   *  which map to dynamically typed values. In some languages, `Struct`
+   *  might be supported by a native representation. For example, in
+   *  scripting languages like JS a struct is represented as an
+   *  object. The details of that representation are described together
+   *  with the proto support for the language.
+   *
+   *  The JSON representation for `Struct` is JSON object.
+   */
+  attributes?: { [k: string]: Value | null } | undefined;
+  /**
+   * e.g., "bar", "line", "pie"
+   */
+  chartType?: string | undefined;
+  /**
+   * VectorImageData represents a vector graphic (SVG, diagram, chart).
+   */
+  rendered?: QcrV1alphaVectorImageData | undefined;
+  /**
+   * A1-notation data ranges
+   */
+  sourceRanges?: Array<string> | undefined;
+  title?: string | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSheetChart$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSheetChart,
+  unknown
+> = z.pipe(
+  z.object({
+    anchor_col: types.optional(types.number()),
+    anchor_row: types.optional(types.number()),
+    attributes: types.optional(
+      z.record(z.string(), types.nullable(Value$inboundSchema)),
+    ),
+    chart_type: types.optional(types.string()),
+    rendered: types.optional(QcrV1alphaVectorImageData$inboundSchema),
+    source_ranges: types.optional(z.array(types.string())),
+    title: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "anchor_col": "anchorCol",
+      "anchor_row": "anchorRow",
+      "chart_type": "chartType",
+      "source_ranges": "sourceRanges",
+    });
+  }),
+);
+
+export function qcrV1alphaSheetChartFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSheetChart, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSheetChart$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSheetChart' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphasheetimage.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaRasterImageData,
+  QcrV1alphaRasterImageData$inboundSchema,
+} from "./qcrv1alpharasterimagedata.js";
+
+export type QcrV1alphaSheetImage = {
+  anchorCol?: number | undefined;
+  anchorRow?: number | undefined;
+  heightMm?: number | undefined;
+  /**
+   * RasterImageData represents a raster image (PNG, JPEG, WebP, etc.).
+   */
+  image?: QcrV1alphaRasterImageData | undefined;
+  /**
+   * horizontal offset within anchor cell
+   */
+  offsetXMm?: number | undefined;
+  /**
+   * vertical offset within anchor cell
+   */
+  offsetYMm?: number | undefined;
+  widthMm?: number | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSheetImage$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSheetImage,
+  unknown
+> = z.pipe(
+  z.object({
+    anchor_col: types.optional(types.number()),
+    anchor_row: types.optional(types.number()),
+    height_mm: types.optional(types.number()),
+    image: types.optional(QcrV1alphaRasterImageData$inboundSchema),
+    offset_x_mm: types.optional(types.number()),
+    offset_y_mm: types.optional(types.number()),
+    width_mm: types.optional(types.number()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "anchor_col": "anchorCol",
+      "anchor_row": "anchorRow",
+      "height_mm": "heightMm",
+      "offset_x_mm": "offsetXMm",
+      "offset_y_mm": "offsetYMm",
+      "width_mm": "widthMm",
+    });
+  }),
+);
+
+export function qcrV1alphaSheetImageFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSheetImage, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSheetImage$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSheetImage' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphasheetlayout.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaCellLayoutBinding,
+  QcrV1alphaCellLayoutBinding$inboundSchema,
+} from "./qcrv1alphacelllayoutbinding.js";
+import {
+  QcrV1alphaColumnFormatBinding,
+  QcrV1alphaColumnFormatBinding$inboundSchema,
+} from "./qcrv1alphacolumnformatbinding.js";
+import {
+  QcrV1alphaColumnLayout,
+  QcrV1alphaColumnLayout$inboundSchema,
+} from "./qcrv1alphacolumnlayout.js";
+import {
+  QcrV1alphaDirection,
+  QcrV1alphaDirection$inboundSchema,
+} from "./qcrv1alphadirection.js";
+import {
+  QcrV1alphaFrozenPane,
+  QcrV1alphaFrozenPane$inboundSchema,
+} from "./qcrv1alphafrozenpane.js";
+import {
+  QcrV1alphaMergedRegion,
+  QcrV1alphaMergedRegion$inboundSchema,
+} from "./qcrv1alphamergedregion.js";
+import {
+  QcrV1alphaRowLayout,
+  QcrV1alphaRowLayout$inboundSchema,
+} from "./qcrv1alpharowlayout.js";
+
+export type QcrV1alphaSheetLayout = {
+  cellBindings?: Array<QcrV1alphaCellLayoutBinding> | undefined;
+  columnFormats?: Array<QcrV1alphaColumnFormatBinding> | undefined;
+  columns?: Array<QcrV1alphaColumnLayout> | undefined;
+  /**
+   * Text direction / reading order.
+   */
+  direction?: QcrV1alphaDirection | undefined;
+  frozenPane?: QcrV1alphaFrozenPane | undefined;
+  isHidden?: boolean | undefined;
+  mergedRegions?: Array<QcrV1alphaMergedRegion> | undefined;
+  rows?: Array<QcrV1alphaRowLayout> | undefined;
+  /**
+   * references Sheet.name
+   */
+  sheetName?: string | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSheetLayout$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSheetLayout,
+  unknown
+> = z.pipe(
+  z.object({
+    cell_bindings: types.optional(
+      z.array(QcrV1alphaCellLayoutBinding$inboundSchema),
+    ),
+    column_formats: types.optional(
+      z.array(QcrV1alphaColumnFormatBinding$inboundSchema),
+    ),
+    columns: types.optional(z.array(QcrV1alphaColumnLayout$inboundSchema)),
+    direction: types.optional(QcrV1alphaDirection$inboundSchema),
+    frozen_pane: types.optional(QcrV1alphaFrozenPane$inboundSchema),
+    is_hidden: types.optional(types.boolean()),
+    merged_regions: types.optional(
+      z.array(QcrV1alphaMergedRegion$inboundSchema),
+    ),
+    rows: types.optional(z.array(QcrV1alphaRowLayout$inboundSchema)),
+    sheet_name: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "cell_bindings": "cellBindings",
+      "column_formats": "columnFormats",
+      "frozen_pane": "frozenPane",
+      "is_hidden": "isHidden",
+      "merged_regions": "mergedRegions",
+      "sheet_name": "sheetName",
+    });
+  }),
+);
+
+export function qcrV1alphaSheetLayoutFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSheetLayout, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSheetLayout$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSheetLayout' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphaspreadsheetlayout.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaSheetLayout,
+  QcrV1alphaSheetLayout$inboundSchema,
+} from "./qcrv1alphasheetlayout.js";
+import {
+  QcrV1alphaSourceReference,
+  QcrV1alphaSourceReference$inboundSchema,
+} from "./qcrv1alphasourcereference.js";
+import {
+  QcrV1alphaSpreadsheetLayoutDefaults,
+  QcrV1alphaSpreadsheetLayoutDefaults$inboundSchema,
+} from "./qcrv1alphaspreadsheetlayoutdefaults.js";
+
+export type QcrV1alphaSpreadsheetLayout = {
+  defaults?: QcrV1alphaSpreadsheetLayoutDefaults | undefined;
+  extractedAt?: Date | undefined;
+  recordId?: string | undefined;
+  sheetLayouts?: Array<QcrV1alphaSheetLayout> | undefined;
+  /**
+   * SourceReference links a record back to the source it was extracted from.
+   *
+   * @remarks
+   *
+   *  Three typed fields identify WHAT, WHERE, and WHEN. Everything else —
+   *  format, content hash, storage location, checksums, external URLs — goes
+   *  in the attributes bag, because the relevant metadata varies by source type.
+   *
+   *  Examples by source type:
+   *
+   *    File upload:
+   *      source_id  = "intg_01j8k..."                    (upload channel instance)
+   *      remote_id  = "req_01h2xcejqtf2nbrexx3vqjhp41"   (upload request ID)
+   *      attributes = {format: "pdf", location: "uploads/.../original.pdf",
+   *                    content_hash: "a1b2c3...", storage_etag: "\"abc\""}
+   *
+   *    Gmail integration:
+   *      source_id  = "intg_01k9m..."                    (Gmail connector instance)
+   *      remote_id  = "18abc123def"                       (Gmail message ID)
+   *      attributes = {format: "eml", thread_id: "...",
+   *                    external_url: "https://mail.google.com/..."}
+   *
+   *    Confluence sync:
+   *      source_id  = "intg_01p3q..."                    (Confluence connector instance)
+   *      remote_id  = "12345678"                          (Confluence page ID)
+   *      attributes = {format: "html", space_key: "ENG",
+   *                    external_url: "https://acme.atlassian.net/wiki/..."}
+   */
+  source?: QcrV1alphaSourceReference | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSpreadsheetLayout$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSpreadsheetLayout,
+  unknown
+> = z.pipe(
+  z.object({
+    defaults: types.optional(QcrV1alphaSpreadsheetLayoutDefaults$inboundSchema),
+    extracted_at: types.optional(types.date()),
+    record_id: types.optional(types.string()),
+    sheet_layouts: types.optional(z.array(QcrV1alphaSheetLayout$inboundSchema)),
+    source: types.optional(QcrV1alphaSourceReference$inboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "extracted_at": "extractedAt",
+      "record_id": "recordId",
+      "sheet_layouts": "sheetLayouts",
+    });
+  }),
+);
+
+export function qcrV1alphaSpreadsheetLayoutFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSpreadsheetLayout, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSpreadsheetLayout$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSpreadsheetLayout' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphaspreadsheetlayoutdefaults.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type QcrV1alphaSpreadsheetLayoutDefaults = {
+  columnWidthMm?: number | undefined;
+  rowHeightMm?: number | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSpreadsheetLayoutDefaults$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSpreadsheetLayoutDefaults,
+  unknown
+> = z.pipe(
+  z.object({
+    column_width_mm: types.optional(types.number()),
+    row_height_mm: types.optional(types.number()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "column_width_mm": "columnWidthMm",
+      "row_height_mm": "rowHeightMm",
+    });
+  }),
+);
+
+export function qcrV1alphaSpreadsheetLayoutDefaultsFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSpreadsheetLayoutDefaults, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      QcrV1alphaSpreadsheetLayoutDefaults$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSpreadsheetLayoutDefaults' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphaspreadsheetmetadata.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { Value, Value$inboundSchema } from "./value.js";
+
+export type QcrV1alphaSpreadsheetMetadata = {
+  /**
+   * `Struct` represents a structured data value, consisting of fields
+   *
+   * @remarks
+   *  which map to dynamically typed values. In some languages, `Struct`
+   *  might be supported by a native representation. For example, in
+   *  scripting languages like JS a struct is represented as an
+   *  object. The details of that representation are described together
+   *  with the proto support for the language.
+   *
+   *  The JSON representation for `Struct` is JSON object.
+   */
+  attributes?: { [k: string]: Value | null } | undefined;
+  extractedAt?: Date | undefined;
+  title?: string | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSpreadsheetMetadata$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSpreadsheetMetadata,
+  unknown
+> = z.pipe(
+  z.object({
+    attributes: types.optional(
+      z.record(z.string(), types.nullable(Value$inboundSchema)),
+    ),
+    extracted_at: types.optional(types.date()),
+    title: types.optional(types.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "extracted_at": "extractedAt",
+    });
+  }),
+);
+
+export function qcrV1alphaSpreadsheetMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSpreadsheetMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSpreadsheetMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSpreadsheetMetadata' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphaspreadsheetrecord.ts

@@ -0,0 +1,102 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaNamedRange,
+  QcrV1alphaNamedRange$inboundSchema,
+} from "./qcrv1alphanamedrange.js";
+import {
+  QcrV1alphaSheet,
+  QcrV1alphaSheet$inboundSchema,
+} from "./qcrv1alphasheet.js";
+import {
+  QcrV1alphaSourceReference,
+  QcrV1alphaSourceReference$inboundSchema,
+} from "./qcrv1alphasourcereference.js";
+import {
+  QcrV1alphaSpreadsheetMetadata,
+  QcrV1alphaSpreadsheetMetadata$inboundSchema,
+} from "./qcrv1alphaspreadsheetmetadata.js";
+
+/**
+ * SpreadsheetRecord is the QCR representation of an ingested spreadsheet
+ *
+ * @remarks
+ *  workbook (XLSX, CSV, Parquet). Immutable once extracted. Source-format-agnostic.
+ *
+ *  Hierarchy: SpreadsheetRecord 1:M Sheet 1:M DataTable/SheetImage/SheetChart.
+ *  The semantic core is DataTable: named, typed columns applied to ordered rows.
+ *  The extractor identifies headers and schemas so consumers don't have to.
+ */
+export type QcrV1alphaSpreadsheetRecord = {
+  id?: string | undefined;
+  metadata?: QcrV1alphaSpreadsheetMetadata | undefined;
+  namedRanges?: Array<QcrV1alphaNamedRange> | undefined;
+  sheets?: Array<QcrV1alphaSheet> | undefined;
+  /**
+   * SourceReference links a record back to the source it was extracted from.
+   *
+   * @remarks
+   *
+   *  Three typed fields identify WHAT, WHERE, and WHEN. Everything else —
+   *  format, content hash, storage location, checksums, external URLs — goes
+   *  in the attributes bag, because the relevant metadata varies by source type.
+   *
+   *  Examples by source type:
+   *
+   *    File upload:
+   *      source_id  = "intg_01j8k..."                    (upload channel instance)
+   *      remote_id  = "req_01h2xcejqtf2nbrexx3vqjhp41"   (upload request ID)
+   *      attributes = {format: "pdf", location: "uploads/.../original.pdf",
+   *                    content_hash: "a1b2c3...", storage_etag: "\"abc\""}
+   *
+   *    Gmail integration:
+   *      source_id  = "intg_01k9m..."                    (Gmail connector instance)
+   *      remote_id  = "18abc123def"                       (Gmail message ID)
+   *      attributes = {format: "eml", thread_id: "...",
+   *                    external_url: "https://mail.google.com/..."}
+   *
+   *    Confluence sync:
+   *      source_id  = "intg_01p3q..."                    (Confluence connector instance)
+   *      remote_id  = "12345678"                          (Confluence page ID)
+   *      attributes = {format: "html", space_key: "ENG",
+   *                    external_url: "https://acme.atlassian.net/wiki/..."}
+   */
+  source?: QcrV1alphaSourceReference | undefined;
+};
+
+/** @internal */
+export const QcrV1alphaSpreadsheetRecord$inboundSchema: z.ZodMiniType<
+  QcrV1alphaSpreadsheetRecord,
+  unknown
+> = z.pipe(
+  z.object({
+    id: types.optional(types.string()),
+    metadata: types.optional(QcrV1alphaSpreadsheetMetadata$inboundSchema),
+    named_ranges: types.optional(z.array(QcrV1alphaNamedRange$inboundSchema)),
+    sheets: types.optional(z.array(QcrV1alphaSheet$inboundSchema)),
+    source: types.optional(QcrV1alphaSourceReference$inboundSchema),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "named_ranges": "namedRanges",
+    });
+  }),
+);
+
+export function qcrV1alphaSpreadsheetRecordFromJSON(
+  jsonString: string,
+): SafeParseResult<QcrV1alphaSpreadsheetRecord, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QcrV1alphaSpreadsheetRecord$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QcrV1alphaSpreadsheetRecord' from JSON`,
+  );
+}

package/src/models/components/qcrv1alphaverticalalignment.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+
+export const QcrV1alphaVerticalAlignment = {
+  VerticalAlignmentUnspecified: "VERTICAL_ALIGNMENT_UNSPECIFIED",
+  VerticalAlignmentTop: "VERTICAL_ALIGNMENT_TOP",
+  VerticalAlignmentCenter: "VERTICAL_ALIGNMENT_CENTER",
+  VerticalAlignmentBottom: "VERTICAL_ALIGNMENT_BOTTOM",
+} as const;
+export type QcrV1alphaVerticalAlignment = OpenEnum<
+  typeof QcrV1alphaVerticalAlignment
+>;
+
+/** @internal */
+export const QcrV1alphaVerticalAlignment$inboundSchema: z.ZodMiniType<
+  QcrV1alphaVerticalAlignment,
+  unknown
+> = openEnums.inboundSchema(QcrV1alphaVerticalAlignment);

package/src/models/components/spreadsheetbundle.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  QcrV1alphaSpreadsheetLayout,
+  QcrV1alphaSpreadsheetLayout$inboundSchema,
+} from "./qcrv1alphaspreadsheetlayout.js";
+import {
+  QcrV1alphaSpreadsheetRecord,
+  QcrV1alphaSpreadsheetRecord$inboundSchema,
+} from "./qcrv1alphaspreadsheetrecord.js";
+
+/**
+ * SpreadsheetBundle groups a spreadsheet record with its optional grid layout.
+ */
+export type SpreadsheetBundle = {
+  layout?: QcrV1alphaSpreadsheetLayout | undefined;
+  /**
+   * SpreadsheetRecord is the QCR representation of an ingested spreadsheet
+   *
+   * @remarks
+   *  workbook (XLSX, CSV, Parquet). Immutable once extracted. Source-format-agnostic.
+   *
+   *  Hierarchy: SpreadsheetRecord 1:M Sheet 1:M DataTable/SheetImage/SheetChart.
+   *  The semantic core is DataTable: named, typed columns applied to ordered rows.
+   *  The extractor identifies headers and schemas so consumers don't have to.
+   */
+  record?: QcrV1alphaSpreadsheetRecord | undefined;
+};
+
+/** @internal */
+export const SpreadsheetBundle$inboundSchema: z.ZodMiniType<
+  SpreadsheetBundle,
+  unknown
+> = z.object({
+  layout: types.optional(QcrV1alphaSpreadsheetLayout$inboundSchema),
+  record: types.optional(QcrV1alphaSpreadsheetRecord$inboundSchema),
+});
+
+export function spreadsheetBundleFromJSON(
+  jsonString: string,
+): SafeParseResult<SpreadsheetBundle, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SpreadsheetBundle$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SpreadsheetBundle' from JSON`,
+  );
+}