@hantera/portal-app 20260625.0.0-develop.1 → 20260812.0.0-develop.1

package/dist/index.d.ts

@@ -249,6 +249,7 @@ export declare namespace apps {
         _default_3 as legacySlots,
         _default_4 as inventoryEditorSlots,
         _default_5 as channelEditorSlots,
+        _default_6 as appSettingsSlots,
         AppSlot,
         AppService,
         standardServices
@@ -259,6 +260,13 @@ declare interface AppService<T> {
     key: string;
 }
 
+declare interface AppSettingsSlotContext {
+    appId: string;
+    values: Readonly<Record<string, any>>;
+    setValue: (key: string, value: any) => void;
+    refresh: () => Promise<void>;
+}
+
 declare interface AppSlot<T> {
     key: string;
 }
@@ -849,6 +857,11 @@ declare const _default_2: {
         orderLine: OrderLine;
         }>;
     };
+    shippingLine: {
+        extras: AppSlot<    {
+        delivery: Delivery;
+        }>;
+    };
     payment: {
         header: AppSlot<    {
         payment: Payment;
@@ -942,6 +955,10 @@ declare const _default_5: {
     };
 };
 
+declare const _default_6: {
+    settings: AppSlot<AppSettingsSlotContext>;
+};
+
 declare function defineService<T>(key: string): AppService<T>;
 
 declare function defineSlot<T extends Record<string, any>>(key: string): AppSlot<T>;
@@ -1073,8 +1090,8 @@ declare interface Delivery {
     deliveryState: 'open' | 'processing' | 'completed' | 'cancelled' | 'cancelledByOrder';
     deliveryAddress: Address;
     shippingPrice: default_2;
-    shippingTaxFactor: default_2;
-    shippingTaxTotal: default_2;
+    shippingTaxFactor?: default_2;
+    shippingTax: default_2;
     shippingTotal: default_2;
     shippingProductNumber: string;
     shippingDescription: string;
@@ -1094,9 +1111,10 @@ declare interface Delivery_2 {
     deliveryState: 'open' | 'processing' | 'completed' | 'cancelled' | 'cancelledByOrder'
     deliveryAddress: Address_2
     shippingPrice: Decimal
-    shippingTaxFactor: Decimal
-    shippingTaxTotal: Decimal
+    shippingTaxFactor?: Decimal
+    shippingTax: Decimal
     shippingTotal: Decimal
+
     shippingProductNumber: string
     shippingDescription: string
     tags: Array<string>
@@ -1542,6 +1560,11 @@ export declare interface GraphQueryNavigation {
 
 export declare type GraphQueryRequire = 'any' | 'some' | 'none' | boolean;
 
+export declare interface GraphQueryWarning {
+    code: string;
+    message: string;
+}
+
 declare interface GraphValueTypeArray {
     type: 'array'
     itemType: GraphValueTypeMeta
@@ -1824,6 +1847,7 @@ export declare interface JsonTableResponse {
     totalCount?: default_2;
     headers: string[];
     rows: Array<Array<unknown>>;
+    warnings?: GraphQueryWarning[];
 }
 
 export declare interface LegacyActivityLog {
@@ -2623,7 +2647,7 @@ declare interface OrderLine {
     reservedQuantity: default_2;
     salesQuantity: default_2;
     unitPrice: default_2;
-    taxFactor: default_2;
+    taxFactor?: default_2;
     taxTotal: default_2;
     orderLineTotal: default_2;
     dynamic: Record<string, any>;
@@ -2645,8 +2669,9 @@ declare interface OrderLine_2 {
     reservedQuantity: Decimal
     salesQuantity: Decimal
     unitPrice: Decimal
-    taxFactor: Decimal
+    taxFactor?: Decimal
     taxTotal: Decimal
+
     orderLineTotal: Decimal
     dynamic: Record<string, any>
     releasedToInvoice: boolean
@@ -2686,7 +2711,30 @@ declare interface OrderProduct {
     taxFactor?: default_2;
 }
 
+/**
+ * Append-only extension of a graph query node, used by apps to add fields and
+ * navigations to the foundational order view query. Apps can only add; existing
+ * fields and navigations are never removed.
+ */
+declare interface OrderQueryNodeExtension {
+    fields?: string[];
+    navigate?: {
+        edge: string;
+        node: OrderQueryNodeExtension;
+    }[];
+}
+
 declare const orderView: {
+    /**
+     * Allows services to extend the foundational order view graph query with
+     * additional fields and navigations. Extensions are append-only: existing
+     * fields and navigations are never removed. This lets apps surface their own
+     * typed fields (including registry-defined dynamic fields) on the order view
+     * state instead of reading and coercing values from the dynamic bag manually.
+     */
+    queryExtensionProvider: AppService<    {
+    extendOrderQuery(): OrderQueryNodeExtension;
+    }>;
     /**
      * Allows services to extend the details tabs of the standard order view
      */
@@ -3837,6 +3885,7 @@ export declare namespace standardServices {
         OrderProduct,
         SearchProduct,
         shippingProductsService,
+        OrderQueryNodeExtension,
         productsService,
         orderView,
         legacyOrderView

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hantera/portal-app",
-  "version": "20260625.0.0-develop.1",
+  "version": "20260812.0.0-develop.1",
   "types": "./dist/index.d.ts",
   "scripts": {
     "build": "cpx ../../portal/portal-app/dist/**/*.d.ts ./dist -C"