feeef 0.9.4 → 0.9.7

package/build/src/core/entities/order.d.ts

@@ -220,4 +220,22 @@ export interface CalculateOrderPricingOptions {
     shippingType?: ShippingType;
     shippingAddress?: string;
 }
+/**
+ * Check if an order ID indicates a fake/honeypot order
+ * Fake orders use the "FuHe3nf" prefix
+ */
+export declare function isFakeOrderId(orderId: string | undefined | null): boolean;
+/**
+ * Check if an order is a fake order (by ID or metadata flag)
+ */
+export declare function isFakeOrder(order: OrderEntity): boolean;
+/**
+ * Check if an order has warning treatment (created but flagged)
+ */
+export declare function isWarningOrder(order: OrderEntity): boolean;
+/**
+ * Check if pixel events should be suppressed for this order
+ * Suppress for: fake orders, warning treatment, fake treatment
+ */
+export declare function shouldSuppressPixelEvents(order: OrderEntity): boolean;
 export {};

package/build/src/core/entities/store.d.ts

@@ -80,7 +80,8 @@ export declare const generatePublicStoreIntegrationOrderdz: (orderdz: OrderdzInt
 export declare const generatePublicStoreIntegrationWebhooks: (webhooks: WebhooksIntegration | null | undefined) => PublicWebhooksIntegration | null | undefined;
 /**
  * Generates public security integration data from private integration data.
- * Only exposes non-sensitive information, keeping backend protection details private for security.
+ * Exposes storefront-safe rules: frontend, doubleSend, minTimeInPage, countries, sources.
+ * Fingerprint, ip, phone, and ads stay server-only.
  */
 export declare const generatePublicStoreIntegrationSecurity: (security: SecurityIntegration | null | undefined) => PublicSecurityIntegration | null | undefined;
 /**
@@ -339,6 +340,27 @@ export declare enum PixelReportMode {
     client = "client",
     both = "both"
 }
+/** Which order field to compare for [PixelStatusRule] (server-side CAPI on transition). */
+export declare enum PixelStatusDimension {
+    orderStatus = "orderStatus",
+    deliveryStatus = "deliveryStatus",
+    paymentStatus = "paymentStatus",
+    customStatus = "customStatus"
+}
+/**
+ * When the order transitions so `dimension` becomes `equals`, send configured Meta/TikTok server events.
+ * `id` must be stable (UUID) — used for idempotency in `order.claims.pixelStatusEvents`.
+ */
+export interface PixelStatusRule {
+    id: string;
+    dimension: PixelStatusDimension;
+    equals: string;
+    metaEvent?: MetaPixelEvent | null;
+    tiktokEvent?: TiktokPixelEvent | null;
+    /** When set, overrides `metaEvent` (Meta CAPI custom event name). */
+    metaCustomEvent?: string | null;
+    tiktokCustomEvent?: string | null;
+}
 export interface MetaPixel {
     name?: string;
     id: string;
@@ -365,6 +387,8 @@ export interface MetaPixelIntegration {
     pixels: MetaPixel[];
     objective?: MetaPixelEvent | null;
     draftObjective?: MetaPixelEvent | null;
+    /** Server-only lifecycle rules; never exposed on public storefront JSON. */
+    statusRules?: PixelStatusRule[];
     active: boolean;
     metadata: Record<string, any>;
     /** Facebook Marketing OAuth data - for accessing pixels via API */
@@ -377,6 +401,8 @@ export interface TiktokPixelIntegration {
     pixels: TiktokPixel[];
     objective?: TiktokPixelEvent | null;
     draftObjective?: TiktokPixelEvent | null;
+    /** Server-only lifecycle rules; never exposed on public storefront JSON. */
+    statusRules?: PixelStatusRule[];
     active: boolean;
     metadata: Record<string, any>;
     /** Where to send events: server, client, or both. Omit for auto (prefer server if accessToken set). */
@@ -497,40 +523,70 @@ export interface ZrexpressIntegration {
     /** Additional metadata for the integration */
     metadata?: Record<string, any>;
 }
-export interface SecurityIntegrationOrdersProtection {
-    frontend: {
-        active: boolean;
-    };
-    backend: {
-        active: boolean;
-        phoneTtl: number;
-        ipTtl: number;
-        blockDirectOrders: boolean;
-        adsOnlyMode: boolean;
-        fingerprintTtl?: number | null;
-        minFormLoadTime?: number | null;
-        requireFingerprint?: boolean | null;
-    };
+export declare enum SecurityTreatment {
+    block = "block",
+    warning = "warning",
+    fake = "fake"
 }
-export interface PublicSecurityIntegrationOrdersProtection {
-    frontend: {
-        active: boolean;
-    };
+export interface SecurityOption {
+    active: boolean;
+    ttl?: number | null;
+    treatment: SecurityTreatment;
+}
+export interface SecurityMinTimeOption {
+    active: boolean;
+    duration: number;
+    treatment: SecurityTreatment;
+}
+export interface SecurityCountriesOption {
+    active: boolean;
+    treatment: SecurityTreatment;
+    allowed: string[] | null;
+    blocked: string[];
+}
+export interface SecuritySourcesOption {
+    active: boolean;
+    treatment: SecurityTreatment;
+    allowed: string[] | null;
+    blocked: string[];
+}
+/** Storefront-safe min-time rule (same shape as private; no secrets). */
+export type PublicSecurityMinTimeOption = SecurityMinTimeOption;
+/** Storefront-safe country allow/block lists (policy only). */
+export type PublicSecurityCountriesOption = SecurityCountriesOption;
+/** Storefront-safe traffic-source allow/block lists (policy only). */
+export type PublicSecuritySourcesOption = SecuritySourcesOption;
+export interface SecurityOptions {
+    fingerprint?: SecurityOption | null;
+    ip?: SecurityOption | null;
+    phone?: SecurityOption | null;
+    ads?: SecurityOption | null;
+    frontend?: SecurityOption | null;
+    doubleSend?: SecurityOption | null;
+    minTimeInPage?: SecurityMinTimeOption | null;
+    countries?: SecurityCountriesOption | null;
+    sources?: SecuritySourcesOption | null;
 }
 export interface SecurityIntegration {
-    orders?: SecurityIntegrationOrdersProtection;
-    /** Whether this integration is currently active */
     active: boolean;
-    /** Additional metadata for the integration */
+    options?: SecurityOptions | null;
     metadata?: Record<string, any>;
 }
+export interface PublicSecurityOption {
+    active: boolean;
+    ttl: number;
+    treatment: SecurityTreatment;
+}
+export interface PublicSecurityOptions {
+    frontend?: PublicSecurityOption;
+    doubleSend?: PublicSecurityOption;
+    minTimeInPage?: PublicSecurityMinTimeOption;
+    countries?: PublicSecurityCountriesOption;
+    sources?: PublicSecuritySourcesOption;
+}
 export interface PublicSecurityIntegration {
-    key?: string | null;
-    orders?: PublicSecurityIntegrationOrdersProtection;
-    /** Whether this integration is currently active */
     active: boolean;
-    /** Additional metadata for the integration */
-    metadata?: Record<string, any>;
+    options: PublicSecurityOptions;
 }
 /**
  * Webhook event types for order lifecycle

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.9.4",
+  "version": "0.9.7",
   "main": "build/index.js",
   "type": "module",
   "files": [