@ai-matrx/records 0.99.30 → 0.99.31

package/dist/core/index.d.cts

@@ -868,4 +868,191 @@ declare function seededDataSource(index: Map<string, unknown>): {
     missed: () => boolean;
 };
 
-export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRIMED_DOOR_TTL_MS, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, type RecordsSeed, type RecordsSeedAnswer, STORE_SCHEMA, StaleWriteDetail, type StoreCaller, type StoreDoorAnswer, type StoreDoorError, type StoreDoors, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, archivedOrganizationId, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, dropPrimedDoorAnswers, exportCellText, exportCsv, exportMarkdown, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, isRecordRemoved, landingOutcomesFor, mapPgError, mapThrownError, markRecordRemoved, markRecordRestored, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, storeDoors, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+/** A database JSON column. Nothing is assumed about it; a reader narrows what it reads. */
+type Json = unknown;
+/** `public.field_data_type`. */
+type FieldDataType = "string" | "number" | "integer" | "boolean" | "date" | "datetime" | "json" | "array";
+/** A column as the grid draws it. */
+type DatasetField = {
+    id: string;
+    table_id: string;
+    field_name: string;
+    display_name: string;
+    data_type: FieldDataType;
+    field_order: number;
+    is_required: boolean;
+    is_public: boolean;
+    default_value: Json | null;
+    validation_rules: Json | null;
+    metadata: Json;
+    custom_fields: Json;
+    organization_id: string;
+    user_id: string;
+    created_at: string;
+    created_by: string | null;
+    updated_at: string;
+    updated_by: string | null;
+    deleted_at: string | null;
+    version: number;
+};
+/** A row as the grid holds it. */
+type DatasetRow = {
+    id: string;
+    table_id: string;
+    data: Json;
+    metadata: Json;
+    custom_fields: Json;
+    is_public: boolean;
+    organization_id: string;
+    user_id: string;
+    source_row_ref: string | null;
+    created_at: string;
+    created_by: string | null;
+    updated_at: string;
+    updated_by: string | null;
+    deleted_at: string | null;
+    version: number;
+};
+type BulkInsertOp = {
+    op: "insert";
+    data: Record<string, unknown>;
+};
+type BulkUpdateOp = {
+    op: "update";
+    row_id: string;
+    /** REPLACES the row's data wholesale. Keys not in `data` are dropped. */
+    data: Record<string, unknown>;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkMergeOp = {
+    op: "merge";
+    row_id: string;
+    /**
+     * Partial update — `data = existing_data || patch`. Keys in `data` overwrite
+     * the row's matching keys; keys absent from `data` are preserved. Use this
+     * when sending only changed fields.
+     */
+    data: Record<string, unknown>;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkCellOp = {
+    op: "cell";
+    row_id: string;
+    field_name: string;
+    value: unknown;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkDeleteOp = {
+    op: "delete";
+    row_id: string;
+};
+type BulkOp = BulkInsertOp | BulkUpdateOp | BulkMergeOp | BulkCellOp | BulkDeleteOp;
+/**
+ * Per-op result envelope returned inside `bulkWrite`'s `results[]`.
+ *
+ * Note: insert / update / cell / delete that succeed return the full row.
+ * Update / cell / delete against a row that is gone return `row_not_found`;
+ * update / cell / merge against a row that is in Trash return `row_in_trash`
+ * (with the server's own sentence in `message`). Both are soft failures — the
+ * rest of the batch continues. Inserts that fail RAISE and abort the batch.
+ */
+type BulkOpError = {
+    error: "row_not_found" | "row_in_trash";
+    row_id: string;
+    message?: string;
+};
+type BulkOpResult = DatasetRow | BulkOpError;
+/**
+ * Narrow a bulk-write result slot to the error variant.
+ * Successful results carry the full DatasetRow shape (no discriminator key
+ * on the success side, so consumers narrow via this guard).
+ */
+declare function isBulkOpError(r: BulkOpResult): r is BulkOpError;
+/**
+ * One plain sentence for the rows a batch could not change — the ONE wording
+ * every bulk surface uses. A row in Trash is named as such (it can be restored),
+ * never reported as "could not be found".
+ */
+declare function describeBulkFailures(failed: BulkOpError[]): string;
+type BulkWriteResponse = {
+    table_id: string;
+    count: number;
+    results: BulkOpResult[];
+};
+type ServiceOk<T> = {
+    success: true;
+    data: T;
+};
+/**
+ * THE STORE'S OWN REFUSAL, kept whole (lane FIX-15, 2026-09-23).
+ *
+ * `error` is `PostgrestError.message` and nothing else, so a refusal written as
+ * three parts — what happened, what the column is, what to do instead — reached
+ * the screen as one third of itself, and the other two thirds (DETAIL and HINT)
+ * were thrown away in this envelope. On production a name typed into a relation
+ * column was refused by the store with a perfectly good sentence
+ * and the person saw nothing usable.
+ *
+ * `refusal` carries the whole thing in the shape every Matrx screen already
+ * knows how to draw (`RefusalNotice` / `RefusalLine` from `@ai-matrx/records-ui`,
+ * which run it through `plainWords` so no machine identity is ever printed at a
+ * person). `error` stays exactly what it was for the callers that print a line.
+ */
+type ServiceErr = {
+    success: false;
+    error: string;
+    refusal?: RecordsError;
+};
+type ServiceResult<T> = ServiceOk<T> | ServiceErr;
+/**
+ * Narrow a ServiceResult to the failure variant. Use instead of `!result.success`
+ * inside generic functions where TS's narrow through `Promise<ServiceResult<T>>`
+ * sometimes fails to discriminate the union members reliably.
+ */
+declare function isServiceFailure<T>(r: ServiceResult<T>): r is ServiceErr;
+/**
+ * Infer a table column's data type for a single value. Used by both the
+ * CSV/Excel import path and the JSON-to-table path. The returned strings
+ * align with `VALID_DATA_TYPES` in `table-utils.ts`.
+ */
+declare function inferDataType(value: unknown): string;
+/**
+ * Sanitize a display name into a valid field name
+ * Converts to lowercase, replaces special chars with underscores, follows snake_case
+ *
+ * @param displayName - The user-entered display name
+ * @returns Sanitized field name in snake_case format
+ *
+ * @example
+ * sanitizeFieldName("Total Revenue") // returns "total_revenue"
+ * sanitizeFieldName("Price ($)") // returns "price"
+ * sanitizeFieldName("2024 Sales") // returns "_2024_sales"
+ */
+declare function sanitizeFieldName(displayName: string): string;
+/**
+ * Validate that a field name follows the required format
+ * Must start with lowercase letter, contain only lowercase letters, numbers, and underscores
+ *
+ * @param fieldName - The field name to validate
+ * @returns true if valid, false otherwise
+ *
+ * @example
+ * validateFieldName("total_revenue") // returns true
+ * validateFieldName("Total Revenue") // returns false
+ * validateFieldName("123_sales") // returns false
+ */
+declare function validateFieldName(fieldName: string): boolean;
+
+export { type BlockOutcome, type BulkCellOp, type BulkDeleteOp, type BulkInsertOp, type BulkMergeOp, type BulkOp, type BulkOpError, type BulkOpResult, type BulkUpdateOp, type BulkWriteResponse, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DatasetField, type DatasetRow, type DoorKey, type ExportRow, Field, type FieldDataType, type Json, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRIMED_DOOR_TTL_MS, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, type RecordsSeed, type RecordsSeedAnswer, STORE_SCHEMA, type ServiceErr, type ServiceOk, type ServiceResult, StaleWriteDetail, type StoreCaller, type StoreDoorAnswer, type StoreDoorError, type StoreDoors, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, archivedOrganizationId, asRecordsDataSource, blockLandedInStore, cellText, describeBulkFailures, doorAbsent, doorCensus, doorExists, doorReady, dropPrimedDoorAnswers, exportCellText, exportCsv, exportMarkdown, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, inferDataType, isBulkOpError, isRecordRemoved, isServiceFailure, landingOutcomesFor, mapPgError, mapThrownError, markRecordRemoved, markRecordRestored, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, sanitizeFieldName, seedIndex, seedKey, seededDataSource, staleWriteDetail, storeDoors, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, validateFieldName, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.d.ts

@@ -868,4 +868,191 @@ declare function seededDataSource(index: Map<string, unknown>): {
     missed: () => boolean;
 };
 
-export { type BlockOutcome, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DoorKey, type ExportRow, Field, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRIMED_DOOR_TTL_MS, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, type RecordsSeed, type RecordsSeedAnswer, STORE_SCHEMA, StaleWriteDetail, type StoreCaller, type StoreDoorAnswer, type StoreDoorError, type StoreDoors, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, archivedOrganizationId, asRecordsDataSource, blockLandedInStore, cellText, doorAbsent, doorCensus, doorExists, doorReady, dropPrimedDoorAnswers, exportCellText, exportCsv, exportMarkdown, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, isRecordRemoved, landingOutcomesFor, mapPgError, mapThrownError, markRecordRemoved, markRecordRestored, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, seedIndex, seedKey, seededDataSource, staleWriteDetail, storeDoors, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };
+/** A database JSON column. Nothing is assumed about it; a reader narrows what it reads. */
+type Json = unknown;
+/** `public.field_data_type`. */
+type FieldDataType = "string" | "number" | "integer" | "boolean" | "date" | "datetime" | "json" | "array";
+/** A column as the grid draws it. */
+type DatasetField = {
+    id: string;
+    table_id: string;
+    field_name: string;
+    display_name: string;
+    data_type: FieldDataType;
+    field_order: number;
+    is_required: boolean;
+    is_public: boolean;
+    default_value: Json | null;
+    validation_rules: Json | null;
+    metadata: Json;
+    custom_fields: Json;
+    organization_id: string;
+    user_id: string;
+    created_at: string;
+    created_by: string | null;
+    updated_at: string;
+    updated_by: string | null;
+    deleted_at: string | null;
+    version: number;
+};
+/** A row as the grid holds it. */
+type DatasetRow = {
+    id: string;
+    table_id: string;
+    data: Json;
+    metadata: Json;
+    custom_fields: Json;
+    is_public: boolean;
+    organization_id: string;
+    user_id: string;
+    source_row_ref: string | null;
+    created_at: string;
+    created_by: string | null;
+    updated_at: string;
+    updated_by: string | null;
+    deleted_at: string | null;
+    version: number;
+};
+type BulkInsertOp = {
+    op: "insert";
+    data: Record<string, unknown>;
+};
+type BulkUpdateOp = {
+    op: "update";
+    row_id: string;
+    /** REPLACES the row's data wholesale. Keys not in `data` are dropped. */
+    data: Record<string, unknown>;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkMergeOp = {
+    op: "merge";
+    row_id: string;
+    /**
+     * Partial update — `data = existing_data || patch`. Keys in `data` overwrite
+     * the row's matching keys; keys absent from `data` are preserved. Use this
+     * when sending only changed fields.
+     */
+    data: Record<string, unknown>;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkCellOp = {
+    op: "cell";
+    row_id: string;
+    field_name: string;
+    value: unknown;
+    /**
+     * The version the person saw this row at, when the caller holds it (an undo carries the version its
+     * own write produced). Absent = the seam's ledger of the rows it drew (`lib/records/record-versions.ts`).
+     */
+    expected_version?: number | null;
+};
+type BulkDeleteOp = {
+    op: "delete";
+    row_id: string;
+};
+type BulkOp = BulkInsertOp | BulkUpdateOp | BulkMergeOp | BulkCellOp | BulkDeleteOp;
+/**
+ * Per-op result envelope returned inside `bulkWrite`'s `results[]`.
+ *
+ * Note: insert / update / cell / delete that succeed return the full row.
+ * Update / cell / delete against a row that is gone return `row_not_found`;
+ * update / cell / merge against a row that is in Trash return `row_in_trash`
+ * (with the server's own sentence in `message`). Both are soft failures — the
+ * rest of the batch continues. Inserts that fail RAISE and abort the batch.
+ */
+type BulkOpError = {
+    error: "row_not_found" | "row_in_trash";
+    row_id: string;
+    message?: string;
+};
+type BulkOpResult = DatasetRow | BulkOpError;
+/**
+ * Narrow a bulk-write result slot to the error variant.
+ * Successful results carry the full DatasetRow shape (no discriminator key
+ * on the success side, so consumers narrow via this guard).
+ */
+declare function isBulkOpError(r: BulkOpResult): r is BulkOpError;
+/**
+ * One plain sentence for the rows a batch could not change — the ONE wording
+ * every bulk surface uses. A row in Trash is named as such (it can be restored),
+ * never reported as "could not be found".
+ */
+declare function describeBulkFailures(failed: BulkOpError[]): string;
+type BulkWriteResponse = {
+    table_id: string;
+    count: number;
+    results: BulkOpResult[];
+};
+type ServiceOk<T> = {
+    success: true;
+    data: T;
+};
+/**
+ * THE STORE'S OWN REFUSAL, kept whole (lane FIX-15, 2026-09-23).
+ *
+ * `error` is `PostgrestError.message` and nothing else, so a refusal written as
+ * three parts — what happened, what the column is, what to do instead — reached
+ * the screen as one third of itself, and the other two thirds (DETAIL and HINT)
+ * were thrown away in this envelope. On production a name typed into a relation
+ * column was refused by the store with a perfectly good sentence
+ * and the person saw nothing usable.
+ *
+ * `refusal` carries the whole thing in the shape every Matrx screen already
+ * knows how to draw (`RefusalNotice` / `RefusalLine` from `@ai-matrx/records-ui`,
+ * which run it through `plainWords` so no machine identity is ever printed at a
+ * person). `error` stays exactly what it was for the callers that print a line.
+ */
+type ServiceErr = {
+    success: false;
+    error: string;
+    refusal?: RecordsError;
+};
+type ServiceResult<T> = ServiceOk<T> | ServiceErr;
+/**
+ * Narrow a ServiceResult to the failure variant. Use instead of `!result.success`
+ * inside generic functions where TS's narrow through `Promise<ServiceResult<T>>`
+ * sometimes fails to discriminate the union members reliably.
+ */
+declare function isServiceFailure<T>(r: ServiceResult<T>): r is ServiceErr;
+/**
+ * Infer a table column's data type for a single value. Used by both the
+ * CSV/Excel import path and the JSON-to-table path. The returned strings
+ * align with `VALID_DATA_TYPES` in `table-utils.ts`.
+ */
+declare function inferDataType(value: unknown): string;
+/**
+ * Sanitize a display name into a valid field name
+ * Converts to lowercase, replaces special chars with underscores, follows snake_case
+ *
+ * @param displayName - The user-entered display name
+ * @returns Sanitized field name in snake_case format
+ *
+ * @example
+ * sanitizeFieldName("Total Revenue") // returns "total_revenue"
+ * sanitizeFieldName("Price ($)") // returns "price"
+ * sanitizeFieldName("2024 Sales") // returns "_2024_sales"
+ */
+declare function sanitizeFieldName(displayName: string): string;
+/**
+ * Validate that a field name follows the required format
+ * Must start with lowercase letter, contain only lowercase letters, numbers, and underscores
+ *
+ * @param fieldName - The field name to validate
+ * @returns true if valid, false otherwise
+ *
+ * @example
+ * validateFieldName("total_revenue") // returns true
+ * validateFieldName("Total Revenue") // returns false
+ * validateFieldName("123_sales") // returns false
+ */
+declare function validateFieldName(fieldName: string): boolean;
+
+export { type BlockOutcome, type BulkCellOp, type BulkDeleteOp, type BulkInsertOp, type BulkMergeOp, type BulkOp, type BulkOpError, type BulkOpResult, type BulkUpdateOp, type BulkWriteResponse, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_VALUE_MAX_BYTES, DOORS, type DatasetField, type DatasetRow, type DoorKey, type ExportRow, Field, type FieldDataType, type Json, LANDING_SOURCE_TYPE, LANDING_TARGET_TYPES, type Landing, type LandingBlock, type LandingOutcomes, type LandingState, type LandingStore, MAPPED_SQLSTATES, type MirrorLimits, OUTPUT_KEPT_KEY, PRIMED_DOOR_TTL_MS, PRODUCED_BY_LABEL, type ParsedImport, PgError, PredictedRefusal, type PrimedBundleAnswer, type ReadFileText, ReadValue, RecordDocument, RecordsDataSource, RecordsError, RecordsResult, type RecordsSeed, type RecordsSeedAnswer, STORE_SCHEMA, type ServiceErr, type ServiceOk, type ServiceResult, StaleWriteDetail, type StoreCaller, type StoreDoorAnswer, type StoreDoorError, type StoreDoors, type SupabaseLike, TableKindFacts, Uuid, WHOLE_VALUE_SOURCE_KIND, type WholeValuePointer, announceRecordChanged, announceTableStructureChanged, archivedOrganizationId, asRecordsDataSource, blockLandedInStore, cellText, describeBulkFailures, doorAbsent, doorCensus, doorExists, doorReady, dropPrimedDoorAnswers, exportCellText, exportCsv, exportMarkdown, exportXlsx, forgetPrimedTablePageBundles, importCsv, importXlsx, inferDataType, isBulkOpError, isRecordRemoved, isServiceFailure, landingOutcomesFor, mapPgError, mapThrownError, markRecordRemoved, markRecordRestored, onRecordChanged, onTableStructureChanged, outcomeForBlock, outputIsKept, parseCsv, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, primeDoorAnswer, primeRecordPageBundle, primeTablePageBundle, recordingDataSource, sanitizeFieldName, seedIndex, seedKey, seededDataSource, staleWriteDetail, storeDoors, supabaseDataSource, tableKindFacts, takePrimedTablePageBundle, toAoa, validateFieldName, valuesAreUnconfirmed, wholeValueNotRead, wholeValueOf, wholeValueOfRead, wholeValueSize, withWholeValues };

package/dist/core/index.js

@@ -12059,6 +12059,64 @@ function seededDataSource(index) {
   };
   return { source, missed: () => missed };
 }
+
+// src/core/table-logic.ts
+function isBulkOpError(r) {
+  return typeof r === "object" && r !== null && "error" in r;
+}
+function describeBulkFailures(failed) {
+  const inTrash = failed.filter((f) => f.error === "row_in_trash").length;
+  const missing = failed.length - inTrash;
+  const parts = [];
+  if (inTrash > 0) {
+    parts.push(
+      `${inTrash} row${inTrash === 1 ? " is" : "s are"} in Trash \u2014 restore ${inTrash === 1 ? "it" : "them"} from Trash to edit`
+    );
+  }
+  if (missing > 0) {
+    parts.push(
+      `${missing} row${missing === 1 ? "" : "s"} could not be found \u2014 ${missing === 1 ? "it" : "they"} may have been removed by someone else`
+    );
+  }
+  return `${parts.join("; ")}.`;
+}
+function isServiceFailure(r) {
+  return r.success === false;
+}
+var DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+var DATETIME_PATTERN = /^\d{4}-\d{2}-\d{2}[T\s]\d{2}:\d{2}/;
+function inferDataType(value) {
+  if (value === null || value === void 0 || value === "") return "string";
+  if (typeof value === "boolean") return "boolean";
+  if (typeof value === "number") {
+    return Number.isInteger(value) ? "integer" : "number";
+  }
+  if (typeof value === "object") {
+    return Array.isArray(value) ? "array" : "json";
+  }
+  const str2 = String(value);
+  const num2 = Number(str2);
+  if (!isNaN(num2) && str2.trim() !== "") {
+    return Number.isInteger(num2) ? "integer" : "number";
+  }
+  const lower = str2.toLowerCase().trim();
+  if (lower === "true" || lower === "false") return "boolean";
+  if (DATE_PATTERN.test(str2)) return "date";
+  if (DATETIME_PATTERN.test(str2)) return "datetime";
+  return "string";
+}
+function sanitizeFieldName(displayName) {
+  if (!displayName || typeof displayName !== "string") {
+    return "";
+  }
+  return displayName.toLowerCase().trim().replace(/[^a-z0-9\s_]/g, "").replace(/\s+/g, "_").replace(/^_+|_+$/g, "").replace(/_+/g, "_").replace(/^(\d)/, "_$1");
+}
+function validateFieldName(fieldName) {
+  if (!fieldName || typeof fieldName !== "string") {
+    return false;
+  }
+  return /^[a-z][a-z0-9_]*$/.test(fieldName);
+}
 export {
   ABSENCE_REASONS,
   ACTOR_VOCABULARY,
@@ -12189,6 +12247,7 @@ export {
   declareDrillDefinition,
   declareTable,
   defaultOpLedger,
+  describeBulkFailures,
   doorAbsent,
   doorCensus,
   doorExists,
@@ -12226,11 +12285,13 @@ export {
   importCsv,
   importXlsx,
   indexedDbStore,
+  inferDataType,
   intersectIds,
   isAPersonsRefusal,
   isAddressValue,
   isArchiveLane,
   isAutonumberField,
+  isBulkOpError,
   isButtonField,
   isDecided,
   isEntityReferenceConfig,
@@ -12244,6 +12305,7 @@ export {
   isRecordsErr,
   isReverseField,
   isRuleFilter,
+  isServiceFailure,
   isShownTo,
   isTableKind,
   isTheChosen,
@@ -12328,6 +12390,7 @@ export {
   rulesWithTopStar,
   safeLinkHref,
   sameDocument,
+  sanitizeFieldName,
   scopeChip,
   seedIndex,
   seedKey,
@@ -12356,6 +12419,7 @@ export {
   typedMatchScore,
   typedTimeText,
   unwrapRecords,
+  validateFieldName,
   valueConverts,
   valuesAreUnconfirmed,
   whereIdOpensPort,