@hantera/portal-app 20260617.0.0-develop.1 → 20260803.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;
 }
@@ -728,6 +736,8 @@ declare interface CreateReturnCommand {
     refundFactor: Decimal | number;
 }
 
+declare function createReviver(options?: DeserializeOptions): (key: string, value: unknown) => unknown;
+
 /**
  * Creates a static discount on an Order. An order discount value is distributed across all order lines and shipping fees proportionally to their value.
  *
@@ -940,6 +950,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>;
@@ -1071,8 +1085,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;
@@ -1092,9 +1106,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>
@@ -1108,6 +1123,16 @@ declare interface Delivery_2 {
     shippingDiscounts: Array<Discount_2>
 }
 
+declare function deserialize(json: string, options?: DeserializeOptions): any;
+
+export declare interface DeserializeOptions {
+    /**
+     * When true, objects containing an array property named "nodes" are replaced
+     * by that array, flattening graph query responses for easier consumption.
+     */
+    graph?: boolean;
+}
+
 export declare type Dialogs = ReturnType<typeof useDialogs>;
 
 declare interface Discount {
@@ -1530,6 +1555,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
@@ -1594,6 +1624,15 @@ declare interface GraphValueTypeScalar_2 {
     scalarType: 'string' | 'instant' | 'decimal' | 'boolean' | 'uuid' | 'any';
 }
 
+export declare namespace HanteraJson {
+    export {
+        serialize,
+        deserialize,
+        createReviver,
+        DeserializeOptions
+    }
+}
+
 export declare interface Host {
     /**
      * Send a message to the portal host
@@ -1803,6 +1842,7 @@ export declare interface JsonTableResponse {
     totalCount?: default_2;
     headers: string[];
     rows: Array<Array<unknown>>;
+    warnings?: GraphQueryWarning[];
 }
 
 export declare interface LegacyActivityLog {
@@ -2602,7 +2642,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>;
@@ -2624,8 +2664,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
@@ -2665,7 +2706,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
      */
@@ -3193,6 +3257,8 @@ declare interface SearchProduct {
     dynamic?: Record<string, any>;
 }
 
+declare function serialize(value: unknown): string;
+
 export declare interface ServiceContext {
     processes: Processes;
     backend: BackendApi;
@@ -3814,6 +3880,7 @@ export declare namespace standardServices {
         OrderProduct,
         SearchProduct,
         shippingProductsService,
+        OrderQueryNodeExtension,
         productsService,
         orderView,
         legacyOrderView

package/package.json

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