feeef 0.12.9 → 0.12.11

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

@@ -69,6 +69,14 @@ export interface OrderEntity {
      * JSON / API field name is always **`references`** (never `orderReferences`).
      */
     references?: string[];
+    /**
+     * Optional schedule date. When set, list sort and day/range filters use
+     * `effectiveAt` (= COALESCE(scheduledAt, createdAt)) so the order appears
+     * as if created on this date. Null clears the schedule.
+     */
+    scheduledAt?: string | null;
+    /** Server-computed COALESCE(scheduledAt, createdAt). Read-only. */
+    effectiveAt?: string;
     createdAt: any;
     updatedAt: any;
 }
@@ -154,6 +162,8 @@ export interface OrderCreateInput {
     storeId: string;
     tags?: string[];
     references?: string[];
+    /** Optional schedule date (ISO). Null clears. */
+    scheduledAt?: string | null;
 }
 /**
  * Input for order items when creating/updating an order
@@ -200,10 +210,9 @@ export interface OrderUpdateInput {
     metadata?: Record<string, any>;
     tags?: string[];
     references?: string[];
+    /** Optional schedule date (ISO). Null clears. */
+    scheduledAt?: string | null;
 }
-/**
- * Order pricing calculation result
- */
 export interface OrderPricing {
     subtotal: number;
     shippingPrice: number | null;

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

@@ -48,7 +48,19 @@ export interface StoreEntity {
     /** Linked inventory project ID for stock management. */
     projectId?: string | null;
 }
-export declare const generatePublicStoreIntegrations: (integrations: StoreIntegrations | null | undefined) => PublicStoreIntegrations | null;
+export declare const generatePublicStoreIntegrations: (integrations: StoreIntegrations | null | undefined, 
+/**
+ * Optional store configs — used to expose inventory storefront flags
+ * (`show_unavailable_on_frontend`) on {@link PublicInventoryIntegration}.
+ */
+configs?: Pick<StoreConfigs, "inventory_integration"> | StoreConfigs | null) => PublicStoreIntegrations | null;
+/**
+ * Public inventory module (no project credentials).
+ * Storefront OOS UI runs only when `active` and `showUnavailableOnFrontend`.
+ */
+export declare const generatePublicStoreIntegrationInventory: (inventory: StoreInventoryIntegration | null | undefined, options?: {
+    showUnavailableOnFrontend?: boolean;
+}) => PublicInventoryIntegration | null | undefined;
 /** Strips connector auth secrets from public store JSON. */
 export declare const generatePublicStoreIntegrationConnectors: (connectors: ConnectorsIntegration | null | undefined) => PublicConnectorsIntegration | null | undefined;
 export declare const generatePublicStoreIntegrationCustomFields: (customFields: any | null | undefined) => PublicCustomFieldsIntegration | null | undefined;
@@ -191,6 +203,21 @@ export interface PublicPaymentIntegration {
     methods: PublicPaymentMethod[];
     defaultMethod?: string;
 }
+/**
+ * Public inventory module — no project / warehouse secrets.
+ * Combined with effective-active (entitlement) on store serialization.
+ *
+ * Storefront must only fetch/apply OOS when `active && showUnavailableOnFrontend`.
+ */
+export interface PublicInventoryIntegration {
+    active: boolean;
+    /**
+     * When true, storefront shows unavailable variants (live qty / legacy stock).
+     * Opt-in via `configs.inventory_integration.show_unavailable_on_frontend`.
+     * @default false
+     */
+    showUnavailableOnFrontend: boolean;
+}
 export interface PublicStoreIntegrations {
     metaPixel: PublicMetaPixelIntegration | null;
     tiktokPixel: PublicTiktokPixelIntegration | null;
@@ -206,6 +233,11 @@ export interface PublicStoreIntegrations {
     customFields: PublicCustomFieldsIntegration | null;
     payment: PublicPaymentIntegration | null;
     connectors: PublicConnectorsIntegration | null;
+    /**
+     * Inventory module. Storefront OOS checks require `active` and
+     * `showUnavailableOnFrontend` (merchant opt-in).
+     */
+    inventory: PublicInventoryIntegration | null;
 }
 export declare enum StoreMemberRole {
     editor = "editor",
@@ -278,6 +310,12 @@ export interface InventoryIntegration {
      * @default true
      */
     allow_backorder?: boolean;
+    /**
+     * When true (and inventory public integration is active), the storefront
+     * fetches live availability and marks out-of-stock variants.
+     * @default false
+     */
+    show_unavailable_on_frontend?: boolean;
 }
 export type FinancePdfPaperSize = 'a4' | 'letter' | 'a5' | 'legal';
 /** Layout and content options for finance PDF documents. */
@@ -312,6 +350,7 @@ export interface StoreConfigs {
     customStatusMappings?: CustomStatusMapping[];
     /** Feature flag to enable custom statuses across the app */
     customStatusEnabled?: boolean;
+    confirmationQueue?: ConfirmationQueueConfig;
     inventory_integration?: InventoryIntegration;
     finance_integration?: FinanceIntegration;
 }
@@ -332,6 +371,42 @@ export interface CustomStatusMapping {
     paymentStatus?: PaymentStatus | null;
     /** Codes (or names) of other mappings suggested as the next workflow step */
     next?: string[];
+    /**
+     * Minutes to postpone the order when this status is set. The order's
+     * `scheduledAt` becomes `now + snoozeMinutes`, so it leaves the confirmation
+     * queue and re-enters it once the delay elapses (e.g. "not_respond_1" -> 180).
+     */
+    snoozeMinutes?: number | null;
+    /** Plain-text reason presets offered to the confirmer when this status is set. */
+    reasons?: string[];
+    /** Whether the confirmer may type a reason that is not in `reasons`. */
+    allowOtherReason?: boolean;
+    /**
+     * Whether a reason is mandatory. Always treated as `true` when `status` is
+     * `cancelled`, regardless of the stored value.
+     */
+    requiresReason?: boolean;
+    /** Whether orders carrying this status may be served by the confirmation queue. */
+    queueEligible?: boolean;
+}
+/** Store-level confirmation queue settings. */
+export interface ConfirmationQueueConfig {
+    enabled?: boolean;
+    /**
+     * How long a `draft` order must age before it becomes eligible for
+     * confirmation. Gives the customer time to finish submitting.
+     */
+    draftDelayMinutes?: number;
+    /**
+     * After a confirmer skips, how long before the order is due again
+     * (`scheduled_at` soft-snooze). Default 15.
+     */
+    skipDeferMinutes?: number;
+    /**
+     * How long after `updated_at` a recent history order stays correctable
+     * in the confirmation feed. Default 5.
+     */
+    historyActionMinutes?: number;
 }
 export interface StoreCurrencyConfig {
     code: string;
@@ -580,6 +655,30 @@ export interface ZrexpressIntegration {
     /** Additional metadata for the integration */
     metadata?: Record<string, any>;
 }
+/**
+ * Codpilot mini-ERP — push Feeef orders for confirmation / COD ops.
+ *
+ * Auth: subdomain + apiId + Bearer apiToken.
+ * Docs: https://codpilot.gitbook.io/codpilot-api
+ * Sync state: `order.metadata.codpilot` (not a delivery carrier).
+ */
+export interface CodpilotIntegration {
+    /** Business subdomain (`mystore` → mystore.codpilot.net) */
+    subdomain: string;
+    apiId: string;
+    apiToken: string;
+    active: boolean;
+    /**
+     * Auto-send when a status dimension transitions into `equals`.
+     * Default (client-seeded): `[{ id: 'default-pending', dimension: 'orderStatus', equals: 'pending' }]`.
+     */
+    statusRules?: Array<{
+        id: string;
+        dimension: 'orderStatus' | 'deliveryStatus' | 'paymentStatus' | 'customStatus';
+        equals: string;
+    }>;
+    metadata?: Record<string, any>;
+}
 /**
  * MDM Express (api.mdm.express) — `x-api-key` and/or Bearer JWT, MDM store `trackingId` (`mdmStoreId` on orders),
  * and MDM seller id (`mdmSellerId`) for service-fees.
@@ -598,6 +697,29 @@ export interface MdmExpressIntegration {
     webhookSecret?: string | null;
     metadata?: Record<string, any>;
 }
+/**
+ * Feeef Delivery (Near Delivery white-label). Merchants never hold Near API keys —
+ * enable via `POST .../integrations/feeefDelivery/enable`.
+ */
+export interface FeeefDeliveryIntegration {
+    id: string;
+    active: boolean;
+    autoSend?: boolean;
+    /** Near sender user id — required when active. */
+    nearSenderUserId: number;
+    nearSenderUsername?: string | null;
+    nearSenderEmail?: string | null;
+    nearAccountType?: 'platform' | 'api' | 'both' | null;
+    /** 0 = address pickup, 1 = center pickup. */
+    pickupLocationType?: 0 | 1 | null;
+    pickupAddress?: string | null;
+    senderCenterId?: number | null;
+    defaultBuralistId?: number | null;
+    /** Prefer Feeef-branded PDF labels (default true). */
+    useFeeefLabel?: boolean | null;
+    webhookSecret?: string | null;
+    metadata?: Record<string, any>;
+}
 export declare enum SecurityTreatment {
     block = "block",
     warning = "warning",
@@ -852,6 +974,9 @@ export interface StoreIntegrations {
     zimou?: ZimouIntegration;
     zrexpress?: ZrexpressIntegration;
     mdmExpress?: MdmExpressIntegration;
+    /** Feeef Delivery (Near white-label) — no merchant API keys. */
+    feeefDelivery?: FeeefDeliveryIntegration;
+    codpilot?: CodpilotIntegration;
     security?: SecurityIntegration;
     dispatcher?: DispatcherIntegration;
     inventory?: StoreInventoryIntegration;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.12.9",
+  "version": "0.12.11",
   "main": "build/index.js",
   "type": "module",
   "files": [
@@ -18,7 +18,7 @@
     "clean": "del-cli build",
     "typecheck": "tsc --noEmit",
     "precompile": "npm run lint && npm run clean",
-    "compile": "tsup-node && tsc --emitDeclarationOnly --declaration",
+    "compile": "tsup-node && tsc --emitDeclarationOnly --declaration -p tsconfig.build.json",
     "build": "npm run compile",
     "release": "npx release-it",
     "publish:npm": "bash ./scripts/publish.sh",

package/build/bin/japa_types.d.ts

@@ -1,7 +0,0 @@
-import '@japa/assert';
-declare module '@japa/assert' {
-    interface Assert {
-        validationErrors(promiseLike: Promise<any>, messages: any): Promise<void>;
-        validationOutput(promiseLike: Promise<any>, output: any): Promise<void>;
-    }
-}

package/build/bin/test.d.ts

@@ -1 +0,0 @@
-export {};