feeef 0.9.5 → 0.10.0

package/build/src/ai/ai_calculator.d.ts

@@ -9,6 +9,7 @@
  * Canonical `aiModels.billing` keys — keep in sync: backend `configs_controller.ts`,
  * feeef `lib/core/app_config.dart`, admins_dashboard `src/lib/hooks/useOptions.ts`.
  */
+import { ModelsCatalogConfig } from '../core/models_catalog.js';
 /** Fallback DZD per USD when `aiModels.exchangeRate` is missing (mirror backend). */
 export declare const FALLBACK_AI_EXCHANGE_RATE = 260;
 export interface RetailMarkupBilling {
@@ -141,6 +142,8 @@ export interface AiCalculatorConfig {
     referenceImageCost?: number;
     resolutionCosts?: Record<string, number>;
     models?: AiModelConfig[];
+    /** Optional model catalog (`models` option): allows pricing.prompt/completion to price text models without aiModels rows. */
+    modelsCatalog?: ModelsCatalogConfig;
     /** Optional `aiModels.billing` overrides (merged over [mergeAiModelsBilling] defaults). */
     billing?: AIModelsBilling | null;
 }

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

@@ -340,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;
@@ -366,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 */
@@ -378,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). */
@@ -498,6 +523,24 @@ export interface ZrexpressIntegration {
     /** Additional metadata for the integration */
     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.
+ */
+export interface MdmExpressIntegration {
+    id: string;
+    apiKey?: string;
+    bearerToken?: string;
+    /** Store tracking id (e.g. STR-…) — `storeId` on `POST /api/v2/orders`. */
+    mdmStoreId: string;
+    /** Seller id (e.g. SLR-…) — `GET /api/sellers/{id}/service-fees`. */
+    mdmSellerId?: string;
+    active: boolean;
+    silentMode?: boolean;
+    autoSend?: boolean;
+    webhookSecret?: string | null;
+    metadata?: Record<string, any>;
+}
 export declare enum SecurityTreatment {
     block = "block",
     warning = "warning",
@@ -688,6 +731,7 @@ export interface StoreIntegrations {
     noest?: any;
     zimou?: ZimouIntegration;
     zrexpress?: ZrexpressIntegration;
+    mdmExpress?: MdmExpressIntegration;
     security?: SecurityIntegration;
     dispatcher?: DispatcherIntegration;
 }

package/build/src/core/models_catalog.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Multi-provider model catalog (options key `models`).
+ * Re-uses OpenRouter **Models API** types (`Model`, `ModelsListResponse`) for parity with
+ * `curl https://openrouter.ai/api/v1/models` and `@openrouter/sdk`.
+ *
+ * @see https://openrouter.ai/docs/guides/overview/models
+ * @see https://openrouter.ai/docs/api-reference/models/get-models
+ */
+export type { DefaultParameters, InputModality, Model, ModelArchitecture, ModelLinks, ModelsListResponse, OutputModality, Parameter, PerRequestLimits, PublicPricing, TopProviderInfo, } from '@openrouter/sdk/models';
+/** Feeef routing — not part of OpenRouter's schema. */
+export type AiProviderKind = 'google' | 'openai' | 'azure' | 'openrouter';
+export interface ProviderRegistryRow {
+    slug: string;
+    kind: AiProviderKind;
+    baseUrl: string;
+    displayName?: string;
+    name?: string;
+}
+/**
+ * Feeef catalog extensions (not from OpenRouter Models API).
+ * Optional `capabilities.image_generation` drives aspect/output tiers and pricing add-ons.
+ */
+export interface ImageGenerationCapabilitiesWire {
+    allowed_aspect_ratios?: string[];
+    output_size_tiers?: string[];
+    input_resolution_tiers?: string[];
+    params?: {
+        background?: string[];
+        quality?: string[];
+        output_format?: string[];
+    };
+    toggles?: {
+        google_search?: boolean;
+        image_search?: boolean;
+    };
+    pricing_addons_dzd?: {
+        transparent_background?: number;
+    };
+}
+export interface FeeefModelCapabilities {
+    image_generation?: ImageGenerationCapabilitiesWire;
+}
+/** `GET /v1/models` row + `provider_slug` for Feeef's registry lookup. */
+export type ModelCatalogRow = import('@openrouter/sdk/models').Model & {
+    provider_slug: string;
+    capabilities?: FeeefModelCapabilities;
+    /** Azure OpenAI deployment name when it differs from catalog `id`. */
+    azure_deployment?: string;
+};
+export interface ModelsCatalogConfig {
+    providers: ProviderRegistryRow[];
+    data: ModelCatalogRow[];
+}

package/build/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from './feeef/feeef.js';
+export * from './core/models_catalog.js';
 export * from './delivery/parcel.js';
 export * from './delivery/delivery_carrier_client.js';
 export * from './core/entities/order.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.9.5",
+  "version": "0.10.0",
   "main": "build/index.js",
   "type": "module",
   "files": [
@@ -38,6 +38,7 @@
     "@japa/snapshot": "^2.0.5",
     "@swc/core": "^1.5.3",
     "@types/dlv": "^1.1.4",
+    "@types/luxon": "^3.4.2",
     "@types/node": "^20.12.10",
     "ajv": "^8.13.0",
     "benchmark": "^2.1.4",
@@ -51,11 +52,11 @@
     "release-it": "^17.2.1",
     "ts-node": "^10.9.2",
     "tsup": "^8.0.2",
-    "typescript": "^5.4.5",
-    "@types/luxon": "^3.4.2"
+    "typescript": "^5.4.5"
   },
   "dependencies": {
     "@adonisjs/transmit-client": "^1.0.0",
+    "@openrouter/sdk": "^0.12.26",
     "axios": "^1.6.8",
     "axios-cache-interceptor": "^1.5.1",
     "luxon": "^3.5.0"