/** * `spreadsheets.get` field masks used by the Google Sheets API provider. * * Each mask selects exactly the response fields one read path needs; keeping * the masks narrow bounds response size and parse cost. GridData has no * `sheetId` of its own; the parent sheet's `sheets.properties.sheetId` * identifies the grid. Row anchors are no longer developer metadata: they * live as cell values in the User_Input tab's last system column, so no mask * requests `rowMetadata.developerMetadata` anymore. */ /** * Preflight field mask: sheet identity plus grid values and formats. * * This is the full-evidence mask. It is used for the scoped verification * read (values plus BOTH number-format sources for row-banded CAS/replay * rows and the identity-column band) and as the oversized-batch fallback; * the steady-state every-dispatch read uses the values-only base mask below. */ export declare const GOOGLE_SHEETS_API_PREFLIGHT_FIELDS: string; /** * Preflight base field mask: sheet identity plus entered values only. * * The every-dispatch full-table read requests no format evidence: headers, * the blank-row rule, the anchor index, the identity index, and * `nextAppendRow` all resolve from `userEnteredValue` alone. Cells whose * normalization can depend on a number format (a `numberValue` that could * render as a canonical date) are re-read with formats in the scoped * verification read; this mask never decides their hash alone. */ export declare const GOOGLE_SHEETS_API_PREFLIGHT_BASE_FIELDS: string; /** * Enumeration field mask: sheet identity plus the committed grid row count. * * The enumeration call requests no ranges because a ranged * `spreadsheets.get` response only carries sheets intersecting the requested * ranges (hidden tabs included only when no ranges are given); the receipt * tab can therefore never be discovered from the ranged data call alone. * `gridProperties.rowCount` is metadata-only and is the unified read * engine's AUTHORITATIVE row bound: band planning chunks all-row reads * against it so no request grows with the accumulated data. */ export declare const GOOGLE_SHEETS_API_ENUMERATION_FIELDS = "sheets.properties(sheetId,title,hidden,gridProperties(rowCount))"; /** * Provisioning enumeration mask: sheet identity plus grid dimensions. * * The grid dimensions let provisioning request the full used grid of an * existing tab (up to the sheet's actual last column) so "truly empty" is * judged against the whole tab, not just the registered range. */ export declare const GOOGLE_SHEETS_API_PROVISION_ENUMERATION_FIELDS = "sheets.properties(sheetId,title,hidden,gridProperties(rowCount,columnCount))"; /** * Provisioning data mask: values plus number formats for header checks. * * Anchors, merged ranges, and computed values are not needed to decide * whether an existing tab is empty or whether its header row matches. */ export declare const GOOGLE_SHEETS_API_PROVISION_FIELDS: string; /** * Values-only table-read mask (getValues semantics). * * Includes computed values, formatted error strings, number formats, and * data-validation rules so formula cells resolve to their computed value, * error cells to their display string, and checkbox columns to their * blank/false rule. */ export declare const GOOGLE_SHEETS_API_VALUES_FIELDS: string; /** * Row-check band mask (the polling check-column gate). * * The narrow identity + anchor + check three-band read needs neither merged * regions, data-validation rules, number formats, nor formatted display * strings: the token formula's result arrives as the computed * `effectiveValue`, its `userEnteredValue.formulaValue` (already in the * mask) proves check provenance, and identity/anchor cells normalize from * entered values. A number-format-dependent * identity (a canonical-date business key) then normalizes conservatively * (as a number) and ESCALATES to the format-evidenced whole-table pass — * the safe direction that keeps this mask (and its wire cost) minimal. */ export declare const GOOGLE_SHEETS_API_ROW_CHECK_FIELDS: string; /** * Full observation mask: values, computed values, merged ranges. * * This is the metadata-preserving read used by snapshots and anchor * assignment. Merged regions live on the SHEET object as `sheets.merges` * (GridRange entries), NOT on GridData. Row anchors are cell values in the * User_Input tab's last column, so they arrive with `rowData.values`. */ export declare const GOOGLE_SHEETS_API_OBSERVATION_FIELDS: string; /** * Lightweight observation mask: values and computed values only. * * Used by user_input polling reads, which never consult merged regions (the * lightweight branch has no merged map) or data-validation rules (the * checkbox-false blank rule comes from the checkboxHeaders config, not from * dataValidation). Keeping `sheets.merges` and `dataValidation` out of the * request makes the polling read cheaper. */ export declare const GOOGLE_SHEETS_API_LIGHTWEIGHT_OBSERVATION_FIELDS: string; //# sourceMappingURL=preflightFields.d.ts.map