@wix/bex-core 2.325.0 → 2.327.0

package/dist/esm/state/ImportState/detectFieldType.js

@@ -0,0 +1,125 @@
+// Field-type detection for new fields created during CSV import (CAIRO-4131).
+//
+// Ported from cm-import (`wix-data-client/cm-import`):
+//   - per-cell rules from `src/field-configuration/detectFieldConfig.js`
+//     (`detectPrimitiveType`) and `src/types/validators/{number,url}.js`
+//   - the column-level majority vote from
+//     `src/field-configuration/guessFieldConfigFromSamples.js`
+//
+// This module owns the shared `NewFieldType` vocabulary and the primitive
+// detector (number / date / boolean / url, else text). Media detection (image /
+// video / document / audio) lives in `@wix/patterns-fields` — it needs the media
+// URI parser, which core must not depend on — and is injected into `ImportState`
+// via `detectColumnType` (see `ImportStateProps`). `detectColumnType` here takes
+// the per-value detector as a parameter so the fields detector reuses this
+// sampling/majority logic instead of re-implementing it.
+// Column-detection sampling: look at the first `TYPE_SAMPLE_SIZE` values and
+// require a >= `MAJORITY` share to agree on a non-text type. We use the same 2/3
+// vote as cm-import but a **larger sample** — cm-import's `constants.sampleSize`
+// is 6; we deliberately sample more so the inference is steadier on messy
+// columns. Exported so callers pass only the head of a column to
+// `detectColumnType` instead of copying it whole.
+export const TYPE_SAMPLE_SIZE = 50;
+const MAJORITY = 2 / 3;
+// cm-import `validators/number.js` `validateString`.
+const NUMBER_RE = /^[+-]?(?:\d+\.?\d*)?$/;
+// cm-import `detectFieldConfig.js` date patterns.
+const SLASH_DATE_RE = /^\d{1,2}\/\d{1,2}\/\d{4}(?: \d{1,2}:\d{1,2})?$/;
+const ISO_DATE_RE = /\d{4}-\d{2}-\d{2}/;
+// Approximates cm-import `validators/url.js` (website / email / phone / relative
+// links). cm-import delegates structural validation to `@wix/santa-core-utils`
+// `isValidUrl`/`isValidEmail`, which aren't available here — so website URLs are
+// validated with the platform `URL` parser instead (rejects empty/whitespace/
+// malformed authorities). It's still an approximation: `URL` accepts some
+// odd-but-parseable hosts santa would reject.
+const WEBSITE_PROTOCOLS = ['http:', 'https:', 'ftp:'];
+const EMAIL_PROTOCOL = 'mailto:';
+const PHONE_PROTOCOLS = ['sms:', 'tel:'];
+const RELATIVE_PREFIXES = ['/', '#', '?'];
+const PHONE_RE = /^[\s\d()+\-/_]+$/;
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const startsWithAny = (value, prefixes) => prefixes.some((prefix) => value.startsWith(prefix));
+const isValidWebsiteUrl = (value) => {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    return WEBSITE_PROTOCOLS.includes(parsed.protocol);
+};
+const isEmailUrl = (value) => value.startsWith(EMAIL_PROTOCOL) &&
+    EMAIL_RE.test(value.slice(EMAIL_PROTOCOL.length));
+const isPhoneUrl = (value) => PHONE_PROTOCOLS.some((protocol) => value.startsWith(protocol) && PHONE_RE.test(value.slice(protocol.length)));
+const isUrl = (value) => isValidWebsiteUrl(value) ||
+    isEmailUrl(value) ||
+    isPhoneUrl(value) ||
+    startsWithAny(value, RELATIVE_PREFIXES);
+const isDate = (value) => {
+    if (SLASH_DATE_RE.test(value)) {
+        if (!Number.isNaN(new Date(value).getTime())) {
+            return true;
+        }
+        // cm-import also accepts dd/mm/yyyy by swapping day and month.
+        const swapped = value.replace(/(\d{1,2})\/(\d{1,2})\/(\d{4})/, '$2/$1/$3');
+        if (!Number.isNaN(new Date(swapped).getTime())) {
+            return true;
+        }
+    }
+    return ISO_DATE_RE.test(value) && !Number.isNaN(new Date(value).getTime());
+};
+/**
+ * Infer the field type of a single CSV cell, in cm-import's order:
+ * empty → number → boolean → date → url, else text.
+ */
+export function detectValueType(value) {
+    if (value === '') {
+        return 'text';
+    }
+    if (NUMBER_RE.test(value)) {
+        return 'number';
+    }
+    const lower = value.toLowerCase();
+    if (lower === 'true' || lower === 'false') {
+        return 'boolean';
+    }
+    if (isDate(value)) {
+        return 'date';
+    }
+    if (isUrl(value)) {
+        return 'url';
+    }
+    return 'text';
+}
+/**
+ * Infer a column's field type from its first values: the most common detected
+ * type, but only when it covers at least two-thirds of the samples (otherwise
+ * `text`). Same majority-vote algorithm as cm-import
+ * `guessFieldConfigFromSamples`, with a larger sample (see `TYPE_SAMPLE_SIZE`).
+ *
+ * `detectValue` defaults to the primitive {@link detectValueType}; the fields
+ * detector passes a media-aware variant so it reuses this sampling/majority
+ * logic.
+ */
+export function detectColumnType(values, detectValue = detectValueType) {
+    const samples = values.slice(0, TYPE_SAMPLE_SIZE);
+    if (samples.length === 0) {
+        return 'text';
+    }
+    const counts = new Map();
+    samples.forEach((value) => {
+        const type = detectValue(value);
+        counts.set(type, (counts.get(type) ?? 0) + 1);
+    });
+    let best = 'text';
+    let bestCount = 0;
+    counts.forEach((count, type) => {
+        if (count > bestCount) {
+            best = type;
+            bestCount = count;
+        }
+    });
+    return bestCount >= samples.length * MAJORITY ? best : 'text';
+}
+//# sourceMappingURL=detectFieldType.js.map

package/dist/esm/state/ImportState/detectFieldType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectFieldType.js","sourceRoot":"","sources":["../../../../src/state/ImportState/detectFieldType.ts"],"names":[],"mappings":"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"}

package/dist/esm/state/ImportState/index.js

@@ -1,3 +1,4 @@
 export * from './ImportState';
 export * from './parseCsv';
+export * from './detectFieldType';
 //# sourceMappingURL=index.js.map

package/dist/esm/state/ImportState/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/state/ImportState/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/state/ImportState/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/types/hooks/useImport.d.ts

@@ -1,10 +1,12 @@
-import { ModalState, ImportState, BackupFn, BulkUploadItemsFn } from '../state';
+import { ModalState, ImportState, BackupFn, BulkUploadItemsFn, UpdateSchemaFn, DetectColumnType } from '../state';
 import { CreateExportAsyncJobRequest } from '@wix/bex-utils/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/types';
 import { FiltersMap } from '../model';
 export interface UseImportParams {
     fields: CreateExportAsyncJobRequest['fields'];
     bulkUploadItems: BulkUploadItemsFn;
     backup?: BackupFn;
+    updateSchema?: UpdateSchemaFn;
+    detectColumnType?: DetectColumnType;
     importModalState: ModalState;
     batchSize?: number;
 }

package/dist/types/hooks/useImport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useImport.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iFAAiF,CAAC;AAC9H,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,MAAM,EAAE,eAAe,qBAyBtG"}
+{"version":3,"file":"useImport.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImport.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iFAAiF,CAAC;AAC9H,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,EAAE,UAAU,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,UAAU,GAAG,UAAU,EAC5E,MAAM,EAAE,eAAe,qBAoCxB"}

package/dist/types/hooks/useImportConfig.d.ts

@@ -1,9 +1,10 @@
 import { CreateExportAsyncJobRequest } from '@wix/bex-utils/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/types';
-import { BackupFn, BulkUploadItemsFn } from '../state';
+import { BackupFn, BulkUploadItemsFn, UpdateSchemaFn } from '../state';
 export interface UseImportConfigParams {
     fields: CreateExportAsyncJobRequest['fields'];
     bulkUploadItems: BulkUploadItemsFn;
     backup?: BackupFn;
+    updateSchema?: UpdateSchemaFn;
     batchSize?: number;
 }
 export declare function useImportConfig(params: UseImportConfigParams): UseImportConfigParams;

package/dist/types/hooks/useImportConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useImportConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImportConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iFAAiF,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,yBAI5D"}
+{"version":3,"file":"useImportConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useImportConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iFAAiF,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,yBAI5D"}

package/dist/types/state/ImportState/ImportState.d.ts

@@ -3,6 +3,7 @@ import { Translate } from '../../services';
 import { ModalState } from '../ModalState';
 import { ConditionalModalState } from '../ConditionalModalState';
 import { CreateExportAsyncJobRequest } from '@wix/bex-utils/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/types';
+import { type DetectColumnType, type NewFieldType } from './detectFieldType';
 export interface ImportCollection {
     clearResultAndMoveToStart(params?: {
         force?: boolean;
@@ -26,10 +27,46 @@ export interface BackupResult {
 export type BackupFn = (signal: AbortSignal) => Promise<BackupResult | void>;
 export type DownloadCsvFn = (content: string, fileName: string) => void;
 export type ImportField = NonNullable<CreateExportAsyncJobRequest['fields']>[number];
+export interface NewFieldDefinition {
+    key: string;
+    type: NewFieldType;
+    displayName: string;
+}
+/**
+ * Consumer-supplied callback that adds the given new fields to the collection
+ * schema in a single call, before the rows are uploaded. Mirrors the cm-import
+ * `beforeImport`/`updateSchema` flow: Cairo decides the fields (and their keys),
+ * the consumer performs one schema mutation (e.g. `updateSchema(collectionId,
+ * ...addField(key, config))`). Its presence is also the opt-in for the "create
+ * new field" default — see `getDefaultMapping`.
+ */
+export type UpdateSchemaFn = (fields: NewFieldDefinition[]) => Promise<void>;
+/**
+ * How a CSV column is mapped:
+ * - `existing` — into an existing collection field by id
+ * - `new` — into a new field created during import (always text for now)
+ * - `null` — don't import (skip)
+ */
+export type ColumnMapping = {
+    kind: 'existing';
+    fieldId: string;
+} | {
+    kind: 'new';
+    fieldType: NewFieldType;
+} | null;
 export interface ImportStateProps {
     fields: CreateExportAsyncJobRequest['fields'];
     bulkUploadItems: BulkUploadItemsFn;
     backup?: BackupFn;
+    updateSchema?: UpdateSchemaFn;
+    /**
+     * Infers a new field's type from its column data. Defaults to the primitive
+     * detector (number / date / boolean / url / text). `@wix/patterns` injects a
+     * media-aware detector from `@wix/patterns-fields` (image / video / document /
+     * audio) — that detection needs the media URI parser, which core can't depend
+     * on.
+     */
+    detectColumnType?: DetectColumnType;
     collection: ImportCollection;
     importModalState: ModalState;
     translate: Translate;
@@ -43,6 +80,7 @@ export declare class ImportState {
     readonly fields: ImportField[];
     readonly bulkUploadItems: BulkUploadItemsFn;
     readonly backup?: BackupFn;
+    readonly updateSchema?: UpdateSchemaFn;
     readonly collection: ImportCollection;
     readonly importModalState: ModalState;
     readonly translate: Translate;
@@ -50,13 +88,14 @@ export declare class ImportState {
     readonly showToast?: ShowToast;
     readonly downloadCsv?: DownloadCsvFn;
     readonly batchSize: number;
+    private readonly _detectColumnType;
     readonly discardChangesModal: ConditionalModalState<"close" | "goBack">;
     currentStep: ImportStep;
     importStatus: TaskStatus<BulkUploadResults, unknown>;
     fileName: string;
     csvHeaders: string[];
     csvRows: string[][];
-    mappingByHeader: Record<string, string | null>;
+    mappingByHeader: Record<string, ColumnMapping>;
     processedCount: number;
     totalCount: number;
     result: BulkUploadResults;
@@ -79,7 +118,13 @@ export declare class ImportState {
      */
     get hasNoMappedData(): boolean;
     get selectedFieldIds(): Set<string>;
-    get mappedRows(): Record<string, unknown>[];
+    /**
+     * Whether columns may be mapped to a brand-new field created during import.
+     * Driven purely by the presence of the `updateSchema` callback — providing the
+     * capability is the opt-in (see `getDefaultMapping`). Never changes after
+     * construction, so it isn't an observable.
+     */
+    get canCreateNewField(): boolean;
     reset(): void;
     close(): Promise<void>;
     private _restoreBackup;
@@ -88,6 +133,7 @@ export declare class ImportState {
     discardAndClose(): Promise<void>;
     onUploadContinue(): void;
     private getDefaultMapping;
+    private _columnValues;
     private applyParsedCsv;
     onFileSelected(file: File | null): Promise<void>;
     private _readFileBytes;
@@ -97,9 +143,18 @@ export declare class ImportState {
     private _showPartialSuccessToast;
     private _downloadFailedRows;
     setMapping(header: string, fieldId: string | null): void;
+    setNewFieldMapping(header: string): void;
     private _uploadBatches;
     private _runBackup;
     private _lingerOnCompletion;
+    /**
+     * Resolves every column to the final destination key used in the upload
+     * payload: an existing field id, a new field's (Cairo-decided) key, or `null`
+     * to skip. All new fields are added to the schema in a single `updateSchema`
+     * call before the rows upload — mirroring the cm-import `beforeImport` flow.
+     * `updateSchema` may throw — `startImport` surfaces that as the error state.
+     */
+    private _resolveFieldMapping;
     private _createRowsBatches;
     startImport(): Promise<void>;
 }

package/dist/types/state/ImportState/ImportState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImportState.d.ts","sourceRoot":"","sources":["../../../../src/state/ImportState/ImportState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ImportState.d.ts","sourceRoot":"","sources":["../../../../src/state/ImportState/ImportState.ts"],"names":[],"mappings":"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"}

package/dist/types/state/ImportState/detectFieldType.d.ts

@@ -0,0 +1,21 @@
+export type NewFieldType = 'text' | 'number' | 'date' | 'boolean' | 'url' | 'image' | 'video' | 'document' | 'audio';
+export type DetectColumnType = (values: string[]) => NewFieldType;
+export type DetectValueType = (value: string) => NewFieldType;
+export declare const TYPE_SAMPLE_SIZE = 50;
+/**
+ * Infer the field type of a single CSV cell, in cm-import's order:
+ * empty → number → boolean → date → url, else text.
+ */
+export declare function detectValueType(value: string): NewFieldType;
+/**
+ * Infer a column's field type from its first values: the most common detected
+ * type, but only when it covers at least two-thirds of the samples (otherwise
+ * `text`). Same majority-vote algorithm as cm-import
+ * `guessFieldConfigFromSamples`, with a larger sample (see `TYPE_SAMPLE_SIZE`).
+ *
+ * `detectValue` defaults to the primitive {@link detectValueType}; the fields
+ * detector passes a media-aware variant so it reuses this sampling/majority
+ * logic.
+ */
+export declare function detectColumnType(values: string[], detectValue?: DetectValueType): NewFieldType;
+//# sourceMappingURL=detectFieldType.d.ts.map

package/dist/types/state/ImportState/detectFieldType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectFieldType.d.ts","sourceRoot":"","sources":["../../../../src/state/ImportState/detectFieldType.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,SAAS,GACT,KAAK,GACL,OAAO,GACP,OAAO,GACP,UAAU,GACV,OAAO,CAAC;AAGZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC;AAGlE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC;AAQ9D,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAkEnC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAkB3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,GAAE,eAAiC,GAC7C,YAAY,CAsBd"}

package/dist/types/state/ImportState/index.d.ts

@@ -1,3 +1,4 @@
 export * from './ImportState';
 export * from './parseCsv';
+export * from './detectFieldType';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/state/ImportState/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/state/ImportState/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/state/ImportState/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/bex-core",
-  "version": "2.325.0",
+  "version": "2.327.0",
   "license": "UNLICENSED",
   "author": {
     "name": "Kobi",
@@ -41,7 +41,7 @@
     "exports"
   ],
   "dependencies": {
-    "@wix/bex-utils": "2.112.0",
+    "@wix/bex-utils": "2.114.0",
     "chance": "^1.0.0",
     "events": "^3.0.0",
     "formstate": "^2.1.0",
@@ -63,7 +63,7 @@
     "@types/react": "^16.0.0",
     "@wix/auto-crud": "^1.0.108",
     "@wix/babel-cli": "^1.11.0",
-    "@wix/cairo-integration-utils": "1.87.0",
+    "@wix/cairo-integration-utils": "1.89.0",
     "@wix/eslint-config-yoshi": "^6.74.0",
     "@wix/fe-essentials": "^1.233.0",
     "@wix/fe-essentials-standalone": "^1.374.0",
@@ -169,5 +169,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "12cf7dbcd7b0dec932a5bd919516215d68d58f282c01a85a03840249"
+  "falconPackageHash": "6c5687da76f292d8e76a0834ce75a642941a5cb2f9e442bd777403e2"
 }