@fas-core/shared-types 1.0.103 → 1.0.106

package/dist/index.d.mts

@@ -391,8 +391,6 @@ interface IAddonConfig extends BaseEntity {
     quantity: number;
     sortOrder: number;
     applyToAll: boolean;
-    appliesFromPrice?: number;
-    appliesToPrice?: number;
     isDefault: boolean;
     isVisible: boolean;
     status: boolean;
@@ -418,6 +416,14 @@ interface AddonNetsuiteLink {
     itemName?: string;
     syncedAt?: Date | string;
 }
+interface AddonSnapshot {
+    groupKey: string;
+    addonKey: string;
+    name: string;
+    price: number;
+    pricingType: PricingType;
+    quantity: number;
+}
 
 interface ProductAddonScope {
     storeId?: string;
@@ -497,6 +503,13 @@ interface OfferedAddonGroup {
     name: string;
     addons: OfferedAddon[];
 }
+interface OfferedServicePlan {
+    planKey: string;
+    name: string;
+    description: string;
+    longDescription: string;
+    price: number;
+}
 declare const CartStatusEnum: {
     readonly ACTIVE: "ACTIVE";
     readonly CONVERTED: "CONVERTED";
@@ -684,13 +697,14 @@ declare const OrderStatusEnum: {
     readonly PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
     readonly QUOTE_REQUESTED: "QUOTE_REQUESTED";
     readonly QUOTE_OPEN: "QUOTE_OPEN";
+    readonly QUOTE_APPROVED: "QUOTE_APPROVED";
     readonly QUOTE_PROCESSED: "QUOTE_PROCESSED";
     readonly QUOTE_CLOSED: "QUOTE_CLOSED";
     readonly QUOTE_VOIDED: "QUOTE_VOIDED";
     readonly QUOTE_EXPIRED: "QUOTE_EXPIRED";
 };
 type OrderStatusEnum = (typeof OrderStatusEnum)[keyof typeof OrderStatusEnum];
-declare const ORDER_STATUS_VALUES: ("CANCELLED" | "REFUNDED" | "PARTIALLY_REFUNDED" | "CREATED" | "PAYMENT_FAILED" | "PENDING_APPROVAL" | "PENDING_FULFILLMENT" | "PARTIALLY_FULFILLED" | "PENDING_BILLING" | "BILLED" | "CLOSED" | "PENDING_RECEIPT" | "PENDING_REFUND" | "QUOTE_REQUESTED" | "QUOTE_OPEN" | "QUOTE_PROCESSED" | "QUOTE_CLOSED" | "QUOTE_VOIDED" | "QUOTE_EXPIRED")[];
+declare const ORDER_STATUS_VALUES: ("CANCELLED" | "REFUNDED" | "PARTIALLY_REFUNDED" | "CREATED" | "PAYMENT_FAILED" | "PENDING_APPROVAL" | "PENDING_FULFILLMENT" | "PARTIALLY_FULFILLED" | "PENDING_BILLING" | "BILLED" | "CLOSED" | "PENDING_RECEIPT" | "PENDING_REFUND" | "QUOTE_REQUESTED" | "QUOTE_OPEN" | "QUOTE_APPROVED" | "QUOTE_PROCESSED" | "QUOTE_CLOSED" | "QUOTE_VOIDED" | "QUOTE_EXPIRED")[];
 declare const statusColors: Record<OrderStatusEnum, string>;
 declare const PURCHASE_ORDER_STATUSES: OrderStatusEnum[];
 declare const OPEN_ORDER_STATUSES: OrderStatusEnum[];
@@ -806,6 +820,10 @@ declare const ADMIN_RESOURCE_LIST: readonly [{
     readonly value: "addon-configs";
     readonly label: "Addon Configs";
     readonly group: "Catalog";
+}, {
+    readonly value: "service-plans";
+    readonly label: "Service Plans";
+    readonly group: "Catalog";
 }, {
     readonly value: "relation-groups";
     readonly label: "Relation Groups";
@@ -903,7 +921,7 @@ declare const ADMIN_RESOURCE_LIST: readonly [{
     readonly label: "Account";
     readonly group: "Settings";
 }];
-declare const ADMIN_RESOURCES: ("stores" | "categories" | "podcast" | "blog" | "dashboard" | "metrics" | "products" | "brands" | "technical-specs" | "addon-configs" | "relation-groups" | "configurators" | "orders" | "quotes" | "carts" | "transactions" | "coupons" | "store-fees" | "tax-rates" | "customers" | "contact-us" | "subscribers" | "faqs" | "email-templates" | "notifications" | "campaigns" | "currencies" | "redirects" | "cache" | "admins" | "account")[];
+declare const ADMIN_RESOURCES: ("stores" | "categories" | "podcast" | "blog" | "dashboard" | "metrics" | "products" | "brands" | "technical-specs" | "addon-configs" | "service-plans" | "relation-groups" | "configurators" | "orders" | "quotes" | "carts" | "transactions" | "coupons" | "store-fees" | "tax-rates" | "customers" | "contact-us" | "subscribers" | "faqs" | "email-templates" | "notifications" | "campaigns" | "currencies" | "redirects" | "cache" | "admins" | "account")[];
 type IAdminResource = (typeof ADMIN_RESOURCE_LIST)[number]['value'];
 declare const ADMIN_ACTIONS: readonly ["read", "write", "delete"];
 type IAdminBaseAction = (typeof ADMIN_ACTIONS)[number];
@@ -1005,6 +1023,43 @@ interface IContact extends BaseEntity {
     resolvedAt?: Date;
 }
 
+declare const SERVICE_PLAN_ELIGIBILITY_FIELD = "custitem520";
+
+interface IServicePlan extends BaseEntity {
+    key: string;
+    name: string;
+    description: string;
+    longDescription: string;
+    price: number;
+    appliesFromPrice?: number;
+    appliesToPrice?: number;
+    sortOrder: number;
+    isVisible: boolean;
+    status: boolean;
+    stores: IStore[];
+    netsuite?: ServicePlanNetsuiteLink | null;
+}
+interface ServicePlanNetsuiteLink {
+    itemId: string;
+    itemName?: string;
+    syncedAt?: Date;
+}
+interface ICartServicePlanSnapshot {
+    id: string;
+    key: string;
+    name: string;
+    description: string;
+    price: number;
+    netsuiteItemId?: string;
+}
+
+interface ProductServicePlanScope {
+    storeId?: string;
+    productPrice?: number;
+    productFlags?: Record<string, boolean | undefined>;
+}
+declare const resolveProductServicePlans: (plans: IServicePlan[], scope?: ProductServicePlanScope, requiresField?: string) => IServicePlan[];
+
 interface ITechnicalSpecColumn extends BaseEntity {
     name: string;
     key: string;
@@ -1113,6 +1168,17 @@ interface IEmailTemplate extends BaseEntity {
     isVisible: boolean;
     status: boolean;
 }
+declare const EmailParamMismatchKindEnum: {
+    readonly MISSING: "missing";
+    readonly UNDECLARED: "undeclared";
+    readonly UNLISTED: "unlisted";
+};
+type EmailParamMismatchKindEnum = (typeof EmailParamMismatchKindEnum)[keyof typeof EmailParamMismatchKindEnum];
+declare const EMAIL_PARAM_MISMATCH_KIND_VALUES: ("missing" | "undeclared" | "unlisted")[];
+interface EmailParamMismatch {
+    kind: EmailParamMismatchKindEnum;
+    token: string;
+}
 
 declare const ConfiguratorSelectModeEnum: {
     readonly SINGLE: "SINGLE";
@@ -1305,6 +1371,12 @@ interface IUnmatched404 extends BaseEntity {
     stores?: (IStore | string)[];
     suggestions?: IRedirectSuggestion[];
 }
+interface MatchResult {
+    best: IRedirectSuggestion | null;
+    score: number;
+    autoLink: boolean;
+    suggestions: IRedirectSuggestion[];
+}
 
 declare const normalizePath: (input: string) => string;
 declare const canonicalizeSlug: (input: string) => string;
@@ -1327,6 +1399,13 @@ interface PricedLineLike {
     };
     metaData?: unknown;
 }
+interface LineChargeInput extends AddonAmountInput {
+    key: string;
+    name: string;
+    kind: "addon" | "servicePlan";
+    netsuiteItemId?: string;
+}
+declare const chargesOfLine: (line: PricedLineLike) => LineChargeInput[];
 declare const addonsOfLine: (line: PricedLineLike) => AddonAmountInput[];
 declare const baseUnitPriceOfLine: (line: PricedLineLike) => number | null;
 declare const feeHint: (fee: IAppliedFee) => string;
@@ -2156,7 +2235,7 @@ declare const RELATION_FIELDS: {
         readonly target: "relationGroups.models-available";
         readonly policy: "seed";
         readonly pending: true;
-        readonly note: "Populated on 1,365 items. No relation group is seeded for it yet.";
+        readonly note: string;
     };
 };
 
@@ -2528,13 +2607,6 @@ declare const addonFields: NetsuiteFieldProvider<{
         readonly conditional: true;
         readonly note: string;
     };
-    readonly priceBand: {
-        readonly before: "featureddescription";
-        readonly target: "appliesFromPrice / appliesToPrice";
-        readonly policy: "always";
-        readonly conditional: true;
-        readonly note: string;
-    };
     readonly eligibilityGate: {
         readonly before: "custitem520";
         readonly target: "AddonGroup.netsuite.requiresField";
@@ -2542,6 +2614,92 @@ declare const addonFields: NetsuiteFieldProvider<{
         readonly note: string;
     };
 }>;
+declare const servicePlanFields: NetsuiteFieldProvider<{
+    readonly netsuiteItemId: {
+        readonly before: "item.id";
+        readonly target: "netsuite.itemId";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly netsuiteItemName: {
+        readonly before: "item.itemid";
+        readonly target: "netsuite.itemName";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+    };
+    readonly key: {
+        readonly before: "urlcomponent";
+        readonly target: "key";
+        readonly policy: "always";
+        readonly identity: true;
+        readonly note: string;
+        readonly caution: "Changing urlcomponent in NetSuite orphans the existing plan and creates a new one.";
+    };
+    readonly name: {
+        readonly before: "storedisplayname";
+        readonly target: "name";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+    };
+    readonly webVisible: {
+        readonly before: "isonline";
+        readonly target: "isVisible";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly active: {
+        readonly before: "isinactive";
+        readonly target: "status";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly price: {
+        readonly before: "itemprice at price level 1";
+        readonly target: "price";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly sellingPoints: {
+        readonly before: "salesdescription";
+        readonly target: "description";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly detail: {
+        readonly before: "storedetaileddescription";
+        readonly target: "longDescription";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly bandFrom: {
+        readonly before: "featureddescription";
+        readonly target: "appliesFromPrice";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+    };
+    readonly bandTo: {
+        readonly before: "featureddescription";
+        readonly target: "appliesToPrice";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+    };
+    readonly sortOrder: {
+        readonly before: "storedisplayname (ordering)";
+        readonly target: "sortOrder";
+        readonly policy: "always";
+        readonly note: string;
+    };
+}>;
 declare const brandFields: NetsuiteFieldProvider<{
     readonly name: {
         readonly before: "commercecategory.name";
@@ -3663,19 +3821,97 @@ declare const PROVIDERS: readonly [NetsuiteFieldProvider<{
         readonly conditional: true;
         readonly note: string;
     };
-    readonly priceBand: {
-        readonly before: "featureddescription";
-        readonly target: "appliesFromPrice / appliesToPrice";
-        readonly policy: "always";
-        readonly conditional: true;
-        readonly note: string;
-    };
     readonly eligibilityGate: {
         readonly before: "custitem520";
         readonly target: "AddonGroup.netsuite.requiresField";
         readonly policy: "seed";
         readonly note: string;
     };
+}>, NetsuiteFieldProvider<{
+    readonly netsuiteItemId: {
+        readonly before: "item.id";
+        readonly target: "netsuite.itemId";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly netsuiteItemName: {
+        readonly before: "item.itemid";
+        readonly target: "netsuite.itemName";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+    };
+    readonly key: {
+        readonly before: "urlcomponent";
+        readonly target: "key";
+        readonly policy: "always";
+        readonly identity: true;
+        readonly note: string;
+        readonly caution: "Changing urlcomponent in NetSuite orphans the existing plan and creates a new one.";
+    };
+    readonly name: {
+        readonly before: "storedisplayname";
+        readonly target: "name";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+    };
+    readonly webVisible: {
+        readonly before: "isonline";
+        readonly target: "isVisible";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly active: {
+        readonly before: "isinactive";
+        readonly target: "status";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly price: {
+        readonly before: "itemprice at price level 1";
+        readonly target: "price";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly sellingPoints: {
+        readonly before: "salesdescription";
+        readonly target: "description";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly detail: {
+        readonly before: "storedetaileddescription";
+        readonly target: "longDescription";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: string;
+    };
+    readonly bandFrom: {
+        readonly before: "featureddescription";
+        readonly target: "appliesFromPrice";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+    };
+    readonly bandTo: {
+        readonly before: "featureddescription";
+        readonly target: "appliesToPrice";
+        readonly policy: "always";
+        readonly conditional: true;
+        readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+    };
+    readonly sortOrder: {
+        readonly before: "storedisplayname (ordering)";
+        readonly target: "sortOrder";
+        readonly policy: "always";
+        readonly note: string;
+    };
 }>, NetsuiteFieldProvider<{
     readonly name: {
         readonly before: "commercecategory.name";
@@ -3926,7 +4162,7 @@ declare const PROVIDERS: readonly [NetsuiteFieldProvider<{
         readonly target: "relationGroups.models-available";
         readonly policy: "seed";
         readonly pending: true;
-        readonly note: "Populated on 1,365 items. No relation group is seeded for it yet.";
+        readonly note: string;
     };
 }>, NetsuiteFieldProvider<{
     netsuiteId: {
@@ -4844,13 +5080,6 @@ declare const BY_ENTITY: {
             readonly conditional: true;
             readonly note: string;
         };
-        readonly priceBand: {
-            readonly before: "featureddescription";
-            readonly target: "appliesFromPrice / appliesToPrice";
-            readonly policy: "always";
-            readonly conditional: true;
-            readonly note: string;
-        };
         readonly eligibilityGate: {
             readonly before: "custitem520";
             readonly target: "AddonGroup.netsuite.requiresField";
@@ -4858,6 +5087,92 @@ declare const BY_ENTITY: {
             readonly note: string;
         };
     }>;
+    readonly 'service-plan': NetsuiteFieldProvider<{
+        readonly netsuiteItemId: {
+            readonly before: "item.id";
+            readonly target: "netsuite.itemId";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly netsuiteItemName: {
+            readonly before: "item.itemid";
+            readonly target: "netsuite.itemName";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+        };
+        readonly key: {
+            readonly before: "urlcomponent";
+            readonly target: "key";
+            readonly policy: "always";
+            readonly identity: true;
+            readonly note: string;
+            readonly caution: "Changing urlcomponent in NetSuite orphans the existing plan and creates a new one.";
+        };
+        readonly name: {
+            readonly before: "storedisplayname";
+            readonly target: "name";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: "A native NetSuite item field, not a SuiteCommerce one, so it survives the cutover.";
+        };
+        readonly webVisible: {
+            readonly before: "isonline";
+            readonly target: "isVisible";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly active: {
+            readonly before: "isinactive";
+            readonly target: "status";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly price: {
+            readonly before: "itemprice at price level 1";
+            readonly target: "price";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly sellingPoints: {
+            readonly before: "salesdescription";
+            readonly target: "description";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly detail: {
+            readonly before: "storedetaileddescription";
+            readonly target: "longDescription";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: string;
+        };
+        readonly bandFrom: {
+            readonly before: "featureddescription";
+            readonly target: "appliesFromPrice";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+        };
+        readonly bandTo: {
+            readonly before: "featureddescription";
+            readonly target: "appliesToPrice";
+            readonly policy: "always";
+            readonly conditional: true;
+            readonly note: "NetSuite states the applicable range in prose — \"for select tools between $600 and $1,200\" — so that prose is the source. Read into a half-open range (from <= price < to) so neighbouring tiers cannot both match. Stating no range means the plan applies at any price, which is how NIST CERT and Pre-set are offered.";
+        };
+        readonly sortOrder: {
+            readonly before: "storedisplayname (ordering)";
+            readonly target: "sortOrder";
+            readonly policy: "always";
+            readonly note: string;
+        };
+    }>;
     readonly brand: NetsuiteFieldProvider<{
         readonly name: {
             readonly before: "commercecategory.name";
@@ -5639,6 +5954,216 @@ declare const NETSUITE_RELATION_GROUPS: readonly string[];
  */
 declare const syncOwnerFor: (entity: NetsuiteOwnedEntity) => string;
 
+declare const NetsuiteEventStateEnum: {
+    readonly APPLIED: "applied";
+    readonly DEFERRED: "deferred";
+    readonly FAILED: "failed";
+    readonly SKIPPED: "skipped";
+};
+type NetsuiteEventStateEnum = (typeof NetsuiteEventStateEnum)[keyof typeof NetsuiteEventStateEnum];
+declare const NETSUITE_EVENT_STATE_VALUES: ("applied" | "deferred" | "failed" | "skipped")[];
+interface INetsuiteEvent extends BaseEntity {
+    eventId: string;
+    recordType: string;
+    recordId: string;
+    action?: string;
+    sourceId?: string;
+    orderId?: string;
+    state: NetsuiteEventStateEnum;
+    detail?: string;
+    receivedAt: Date;
+    appliedAt?: Date;
+    attempts?: number;
+    lastAttemptAt?: Date;
+}
+interface INetsuiteQueueEntry {
+    key: string;
+    label: string;
+    state: "queued" | "running";
+    runsInSeconds: number | null;
+    runningForSeconds: number | null;
+}
+
+declare const TaxRateSourceEnum: {
+    readonly GROUP: "group";
+    readonly ORDERS: "orders";
+};
+type TaxRateSourceEnum = (typeof TaxRateSourceEnum)[keyof typeof TaxRateSourceEnum];
+declare const TAX_RATE_SOURCE_VALUES: ("orders" | "group")[];
+interface ITaxRate extends BaseEntity {
+    key: string;
+    city: string;
+    zip: string;
+    state: string;
+    county?: string;
+    rate: number;
+    netsuiteGroupId: string;
+    netsuiteGroupName: string;
+    source: TaxRateSourceEnum;
+    syncedAt: Date;
+}
+
+interface TaxSyncResult {
+    groups: number;
+    rates: number;
+    overlaps: number;
+    observed: number;
+    corrected: number;
+    removed: number;
+    states: string[];
+}
+interface PromotionSyncResult {
+    found: number;
+    written: number;
+    codes: string[];
+    skipped: Array<{
+        code: string;
+        name: string;
+        reason: string;
+    }>;
+    deactivated: string[];
+}
+interface CategoryImportSummary {
+    received: number;
+    created: number;
+    existing: number;
+    linked: number;
+    skipped: number;
+    missingParents: string[];
+}
+interface NetsuiteLinkResult {
+    key: string;
+    netsuiteId: string;
+    created: boolean;
+}
+
+declare const PushCheckStatusEnum: {
+    readonly PASS: "pass";
+    readonly WARN: "warn";
+    readonly FAIL: "fail";
+};
+type PushCheckStatusEnum = (typeof PushCheckStatusEnum)[keyof typeof PushCheckStatusEnum];
+declare const PUSH_CHECK_STATUS_VALUES: ("pass" | "warn" | "fail")[];
+interface PushCheck {
+    key: string;
+    label: string;
+    status: PushCheckStatusEnum;
+    detail?: string;
+    fixable?: boolean;
+}
+interface PushField {
+    label: string;
+    value: string;
+    note?: string;
+}
+interface NetsuitePreviewLine {
+    kind: "item" | "fee" | "addon";
+    name: string;
+    sku?: string;
+    netsuiteItemId?: string;
+    matchedBy?: "stored id" | "SKU lookup";
+    quantity: number;
+    rate: number;
+    amount: number;
+    problem?: string;
+}
+interface NetsuiteReceipt {
+    id: string;
+    recordType: string;
+    externalId: string;
+    tranId?: string;
+    statusText?: string;
+    total?: number;
+    entityId?: string;
+    entityLabel?: string;
+    createdDate?: string;
+    httpStatus?: number;
+    recordUrl?: string;
+    pushedAt: Date;
+    sentLines?: Array<{
+        kind: "item" | "fee" | "addon";
+        sku?: string;
+        name: string;
+        netsuiteItemId?: string;
+        quantity: number;
+        amount: number;
+    }>;
+    totalMismatch?: {
+        charged: number;
+        landed: number;
+        drift: number;
+    };
+}
+interface NetsuiteOrderPreview {
+    orderId: string;
+    recordType: "salesOrder" | "estimate";
+    recordLabel: string;
+    alreadyPushed?: NetsuiteReceipt;
+    lastError?: {
+        message: string;
+        failedAt?: string;
+        recordType?: string;
+    };
+    connection: {
+        configured: boolean;
+        missing: string[];
+        writesEnabled: boolean;
+        account: string;
+    };
+    writesEnabled: boolean;
+    customer: {
+        email: string;
+        netsuiteId?: string;
+        label?: string;
+        willCreate: boolean;
+    };
+    lines: NetsuitePreviewLine[];
+    fields?: PushField[];
+    totals: {
+        netsuite: number;
+        order: number;
+        matches: boolean;
+        currencyCode: string;
+    };
+    checks: PushCheck[];
+    canSend: boolean;
+    warnings: string[];
+    blockers: string[];
+}
+interface NetsuiteSyncDefinition {
+    key: string;
+    label: string;
+    recordTypes: string[];
+    supportsSingle: boolean;
+    supportsFull: boolean;
+    heavy: boolean;
+    fields: string[];
+    source: string;
+}
+
+interface RevalidationResult {
+    domain: string;
+    url: string;
+    ok: boolean;
+    error: string | null;
+    durationMs: number;
+    at: string;
+}
+interface CacheStoreTarget {
+    id: string;
+    name: string;
+    domain: string;
+    reachable: boolean;
+    lastResult: RevalidationResult | null;
+}
+interface CacheStatus {
+    secretConfigured: boolean;
+    urlOverride: string | null;
+    urlTemplate: string | null;
+    tags: string[];
+    stores: CacheStoreTarget[];
+}
+
 interface CheckoutAddressInput {
     addressLine1: string;
     addressLine2?: string;
@@ -5719,4 +6244,4 @@ interface IWishlist extends BaseEntity {
     items: IWishlistItem[];
 }
 
-export { ACTIVE_SUBSCRIPTION_CHANNELS, ADMIN_ACTIONS, ADMIN_AUDIT_ACTIONS, ADMIN_RESOURCES, ADMIN_RESOURCE_LIST, ALL_STORES, AWAITING_PAYMENT_STATUSES, type AddonAmountInput, type AddonGroupNetsuiteLink, type AddonNetsuiteLink, type AddonSelectionRef, type ApiResponse, type AppliedTax, BRAND_FIELDS, type BaseEntity, CAMPAIGN_RECIPIENT_STATUS_VALUES, CAMPAIGN_STATUS_VALUES, CART_STATUS_VALUES, CATEGORY_FIELDS, CONFIGURATOR_CONDITION_TYPE_VALUES, CONFIGURATOR_EFFECT_TYPE_VALUES, CONFIGURATOR_SELECT_MODE_VALUES, CONFIGURATOR_SOURCE_VALUES, CampaignRecipientStatusEnum, CampaignStatusEnum, type CartIssue, type CartIssueType, CartIssueTypes, CartStatusEnum, type CartValidation, type CheckoutAddressInput, type CheckoutPayload, type CheckoutResult, ConfiguratorConditionTypeEnum, ConfiguratorEffectTypeEnum, ConfiguratorErrorCodeEnum, type ConfiguratorEvalContext, type ConfiguratorEvalError, type ConfiguratorEvalResult, ConfiguratorSelectModeEnum, type ConfiguratorSelections, ConfiguratorSourceEnum, type CouponNetsuiteLink, DEFAULT_SUBSCRIPTION_TOPICS, DISCOUNT_TYPE_VALUES, DiscountTypeEnum, EMAIL_TEMPLATE_EVENT_VALUES, EMAIL_TEMPLATE_VARIABLES_BY_EVENT, EMPTY_ACCESS, type EffectiveAccess, EmailTemplateEventEnum, FEE_APPLIES_TO_VALUES, FeeAppliesToEnum, type FieldMap, type FieldMapping, type FieldSource, type IAddonConfig, type IAddonGroup, type IAddress, type IAdmin, type IAdminAction, type IAdminAuditAction, type IAdminAuditLog, type IAdminBaseAction, type IAdminPermission, type IAdminResource, type IAdminRole, type IAdminRoleCreate, type IAdminSafe, type IAdminStoreAccess, type IAppliedFee, type IBannerSlide, type IBlogAuthor, type IBlogCategory, type IBlogPost, type IBrand, type ICampaign, type ICampaignRecipient, type ICampaignStats, type ICart, type ICartItem, type ICategory, type ICategorySubcategory, type IConfigurator, type IConfiguratorCondition, type IConfiguratorEffect, type IConfiguratorFacet, type IConfiguratorFacetValue, type IConfiguratorOption, type IConfiguratorPriceAdjustment, type IConfiguratorQuery, type IConfiguratorRule, type IConfiguratorSection, type IConfiguratorStep, type IConfiguratorTarget, type IContact, type ICountry, type ICoupon, type ICurrency, type ICustomer, type IDiscountType, type IEmailTemplate, type IFaq, type IFaqCategory, type IKeyValue, type ILinePricing, type IMediaAsset, INVENTORY_POLICY_VALUES, type INetsuiteOrderLink, type INotification, type IOrder, type IOrderItem, type IOrderLog, type IOrderShipment, type IOrderTransaction, type IPaymentLink, type IPodcastEpisode, type IPrice, type IProduct, type IProductDailyStat, type IProductRelationGroup, type IProductTechnicalSpec, type IProductTechnicalSpecTable, type IProductVariantFields, type IProductVariantOptionGroup, type IProductVariantOptionMatrix, type IProductVariantOptionValue, type IRedirect, type IRedirectSuggestion, type IRefundTransaction, type IRelationGroup, type ISEOMetaData, type ISelectableFee, type IShipFromAddress, type IShipping, type IShippingRate, type IState, type IStock, type IStore, type IStoreFee, type IStoreSettings, type ISubscriber, type ISubscriberConsent, type ISubscription, type ISummaryPricing, type ITechnicalSpecColumn, type ITechnicalSpecGroup, type ITransactionBase, type IUnmatched404, type IVariant, type IVariantOptionSelection, type IWishlist, type IWishlistItem, type Id, type InventoryPolicy, InventoryPolicyEnum, type Metadata, NETSUITE_OWNED_FIELDS, NETSUITE_RELATION_GROUPS, NOTIFICATION_TYPE_VALUES, NetsuiteFieldProvider, type NetsuiteOwnedEntity, type NetsuiteRelationSource, NotificationTypeEnum, OPEN_ORDER_STATUSES, ORDER_LOG_TYPE_VALUES, ORDER_STATUS_VALUES, type OfferedAddon, type OfferedAddonGroup, OrderLogTypeEnum, OrderStatusEnum, PAYMENT_GATEWAY_VALUES, PAYMENT_LINK_STATUS_VALUES, PAYMENT_METHOD_VALUES, PAYMENT_STATUS_VALUES, PRICING_TYPE_VALUES, PRODUCT_FIELDS, PRODUCT_VARIANT_TYPE_VALUES, PROVIDERS, PURCHASE_ORDER_STATUSES, PaymentGatewayEnum, PaymentLinkStatusEnum, PaymentMethodEnum, PaymentStatusEnum, type PricedLineLike, type PricingType, PricingTypeEnum, type ProductAddonScope, ProductEventTypeEnum, type ProductVariantType, ProductVariantTypeEnum, QUOTE_ORDER_STATUSES, RELATION_FIELDS, RESOURCE_OPERATIONS, RETIRED_CART_STATUSES, type RedirectTargetType, type ResolveAccessInput, type ResolvedAddonSelection, SALE_TYPE_VALUES, SUBSCRIPTION_CHANNEL_VALUES, SUBSCRIPTION_TOPIC_LABELS, SUBSCRIPTION_TOPIC_VALUES, type SaleType, SaleTypeEnum, type SaleTypedLike, type SelectedShippingMethod, type StockDemandLine, type StockStatus, StockStatusEnum, type StockVerdict, StockVerdictEnum, type StoreAccessCheckInput, type StoreScopeInput, SubscriptionChannelEnum, SubscriptionTopicEnum, type SyncPolicy, type SyncRisk, TRANSACTION_TYPE_VALUES, TransactionTypeEnum, type VariantOptionMode, WIRED_EMAIL_TEMPLATE_EVENTS, actionsForResource, addonFields, addonUnitAmount, addonsOfLine, addonsUnitAmount, adjustmentsFor, applyPriceAdjustments, baseUnitPriceOfLine, blogAuthorFields, blogCategoryFields, blogPostFields, brandFields, can, canAny, canonicalizePath, canonicalizeSlug, categoryFields, conditionHolds, couponFields, demandByKey, evaluateConfigurator, feeHint, formatMoney, grantedPermissions, groupHasDefaultAddon, hasStoreAccess, isConfigurationValid, isNetsuiteOwned, isNonEmptyString, isQuoteOnlyItem, isValidAction, isValidEmail, missingGrants, netsuiteFieldCaution, netsuiteFieldConditional, netsuiteFieldNote, netsuiteFieldRisk, netsuiteFieldSource, netsuiteRelationSource, normalizeLineQuantity, normalizeNumber, normalizePath, orderLogTypeColorMap, paymentLinkStatusColorMap, paymentMethodColorMap, paymentStatusColorMap, podcastFields, productFields, readMapped, resolveAddonSelections, resolveEffectivePermissions, resolveProductAddonGroups, resolveStoreScope, roundMoney, saleTypeOf, statusColors, stockVerdict, syncOwnerFor, toIdString, typeColorMap };
+export { ACTIVE_SUBSCRIPTION_CHANNELS, ADMIN_ACTIONS, ADMIN_AUDIT_ACTIONS, ADMIN_RESOURCES, ADMIN_RESOURCE_LIST, ALL_STORES, AWAITING_PAYMENT_STATUSES, type AddonAmountInput, type AddonGroupNetsuiteLink, type AddonNetsuiteLink, type AddonSelectionRef, type AddonSnapshot, type ApiResponse, type AppliedTax, BRAND_FIELDS, type BaseEntity, CAMPAIGN_RECIPIENT_STATUS_VALUES, CAMPAIGN_STATUS_VALUES, CART_STATUS_VALUES, CATEGORY_FIELDS, CONFIGURATOR_CONDITION_TYPE_VALUES, CONFIGURATOR_EFFECT_TYPE_VALUES, CONFIGURATOR_SELECT_MODE_VALUES, CONFIGURATOR_SOURCE_VALUES, type CacheStatus, type CacheStoreTarget, CampaignRecipientStatusEnum, CampaignStatusEnum, type CartIssue, type CartIssueType, CartIssueTypes, CartStatusEnum, type CartValidation, type CategoryImportSummary, type CheckoutAddressInput, type CheckoutPayload, type CheckoutResult, ConfiguratorConditionTypeEnum, ConfiguratorEffectTypeEnum, ConfiguratorErrorCodeEnum, type ConfiguratorEvalContext, type ConfiguratorEvalError, type ConfiguratorEvalResult, ConfiguratorSelectModeEnum, type ConfiguratorSelections, ConfiguratorSourceEnum, type CouponNetsuiteLink, DEFAULT_SUBSCRIPTION_TOPICS, DISCOUNT_TYPE_VALUES, DiscountTypeEnum, EMAIL_PARAM_MISMATCH_KIND_VALUES, EMAIL_TEMPLATE_EVENT_VALUES, EMAIL_TEMPLATE_VARIABLES_BY_EVENT, EMPTY_ACCESS, type EffectiveAccess, type EmailParamMismatch, EmailParamMismatchKindEnum, EmailTemplateEventEnum, FEE_APPLIES_TO_VALUES, FeeAppliesToEnum, type FieldMap, type FieldMapping, type FieldSource, type IAddonConfig, type IAddonGroup, type IAddress, type IAdmin, type IAdminAction, type IAdminAuditAction, type IAdminAuditLog, type IAdminBaseAction, type IAdminPermission, type IAdminResource, type IAdminRole, type IAdminRoleCreate, type IAdminSafe, type IAdminStoreAccess, type IAppliedFee, type IBannerSlide, type IBlogAuthor, type IBlogCategory, type IBlogPost, type IBrand, type ICampaign, type ICampaignRecipient, type ICampaignStats, type ICart, type ICartItem, type ICartServicePlanSnapshot, type ICategory, type ICategorySubcategory, type IConfigurator, type IConfiguratorCondition, type IConfiguratorEffect, type IConfiguratorFacet, type IConfiguratorFacetValue, type IConfiguratorOption, type IConfiguratorPriceAdjustment, type IConfiguratorQuery, type IConfiguratorRule, type IConfiguratorSection, type IConfiguratorStep, type IConfiguratorTarget, type IContact, type ICountry, type ICoupon, type ICurrency, type ICustomer, type IDiscountType, type IEmailTemplate, type IFaq, type IFaqCategory, type IKeyValue, type ILinePricing, type IMediaAsset, INVENTORY_POLICY_VALUES, type INetsuiteEvent, type INetsuiteOrderLink, type INetsuiteQueueEntry, type INotification, type IOrder, type IOrderItem, type IOrderLog, type IOrderShipment, type IOrderTransaction, type IPaymentLink, type IPodcastEpisode, type IPrice, type IProduct, type IProductDailyStat, type IProductRelationGroup, type IProductTechnicalSpec, type IProductTechnicalSpecTable, type IProductVariantFields, type IProductVariantOptionGroup, type IProductVariantOptionMatrix, type IProductVariantOptionValue, type IRedirect, type IRedirectSuggestion, type IRefundTransaction, type IRelationGroup, type ISEOMetaData, type ISelectableFee, type IServicePlan, type IShipFromAddress, type IShipping, type IShippingRate, type IState, type IStock, type IStore, type IStoreFee, type IStoreSettings, type ISubscriber, type ISubscriberConsent, type ISubscription, type ISummaryPricing, type ITaxRate, type ITechnicalSpecColumn, type ITechnicalSpecGroup, type ITransactionBase, type IUnmatched404, type IVariant, type IVariantOptionSelection, type IWishlist, type IWishlistItem, type Id, type InventoryPolicy, InventoryPolicyEnum, type LineChargeInput, type MatchResult, type Metadata, NETSUITE_EVENT_STATE_VALUES, NETSUITE_OWNED_FIELDS, NETSUITE_RELATION_GROUPS, NOTIFICATION_TYPE_VALUES, NetsuiteEventStateEnum, NetsuiteFieldProvider, type NetsuiteLinkResult, type NetsuiteOrderPreview, type NetsuiteOwnedEntity, type NetsuitePreviewLine, type NetsuiteReceipt, type NetsuiteRelationSource, type NetsuiteSyncDefinition, NotificationTypeEnum, OPEN_ORDER_STATUSES, ORDER_LOG_TYPE_VALUES, ORDER_STATUS_VALUES, type OfferedAddon, type OfferedAddonGroup, type OfferedServicePlan, OrderLogTypeEnum, OrderStatusEnum, PAYMENT_GATEWAY_VALUES, PAYMENT_LINK_STATUS_VALUES, PAYMENT_METHOD_VALUES, PAYMENT_STATUS_VALUES, PRICING_TYPE_VALUES, PRODUCT_FIELDS, PRODUCT_VARIANT_TYPE_VALUES, PROVIDERS, PURCHASE_ORDER_STATUSES, PUSH_CHECK_STATUS_VALUES, PaymentGatewayEnum, PaymentLinkStatusEnum, PaymentMethodEnum, PaymentStatusEnum, type PricedLineLike, type PricingType, PricingTypeEnum, type ProductAddonScope, ProductEventTypeEnum, type ProductServicePlanScope, type ProductVariantType, ProductVariantTypeEnum, type PromotionSyncResult, type PushCheck, PushCheckStatusEnum, type PushField, QUOTE_ORDER_STATUSES, RELATION_FIELDS, RESOURCE_OPERATIONS, RETIRED_CART_STATUSES, type RedirectTargetType, type ResolveAccessInput, type ResolvedAddonSelection, type RevalidationResult, SALE_TYPE_VALUES, SERVICE_PLAN_ELIGIBILITY_FIELD, SUBSCRIPTION_CHANNEL_VALUES, SUBSCRIPTION_TOPIC_LABELS, SUBSCRIPTION_TOPIC_VALUES, type SaleType, SaleTypeEnum, type SaleTypedLike, type SelectedShippingMethod, type ServicePlanNetsuiteLink, type StockDemandLine, type StockStatus, StockStatusEnum, type StockVerdict, StockVerdictEnum, type StoreAccessCheckInput, type StoreScopeInput, SubscriptionChannelEnum, SubscriptionTopicEnum, type SyncPolicy, type SyncRisk, TAX_RATE_SOURCE_VALUES, TRANSACTION_TYPE_VALUES, TaxRateSourceEnum, type TaxSyncResult, TransactionTypeEnum, type VariantOptionMode, WIRED_EMAIL_TEMPLATE_EVENTS, actionsForResource, addonFields, addonUnitAmount, addonsOfLine, addonsUnitAmount, adjustmentsFor, applyPriceAdjustments, baseUnitPriceOfLine, blogAuthorFields, blogCategoryFields, blogPostFields, brandFields, can, canAny, canonicalizePath, canonicalizeSlug, categoryFields, chargesOfLine, conditionHolds, couponFields, demandByKey, evaluateConfigurator, feeHint, formatMoney, grantedPermissions, groupHasDefaultAddon, hasStoreAccess, isConfigurationValid, isNetsuiteOwned, isNonEmptyString, isQuoteOnlyItem, isValidAction, isValidEmail, missingGrants, netsuiteFieldCaution, netsuiteFieldConditional, netsuiteFieldNote, netsuiteFieldRisk, netsuiteFieldSource, netsuiteRelationSource, normalizeLineQuantity, normalizeNumber, normalizePath, orderLogTypeColorMap, paymentLinkStatusColorMap, paymentMethodColorMap, paymentStatusColorMap, podcastFields, productFields, readMapped, resolveAddonSelections, resolveEffectivePermissions, resolveProductAddonGroups, resolveProductServicePlans, resolveStoreScope, roundMoney, saleTypeOf, servicePlanFields, statusColors, stockVerdict, syncOwnerFor, toIdString, typeColorMap };