@vivoa/plugin-sdk 0.5.2 → 0.6.0

package/dist/index.d.mts

@@ -754,9 +754,20 @@ interface SupplierOrderAddressLevel {
 interface SupplierShipTo {
     address: string;
     referencePoint?: string | null;
-    /** Supplier geo ids — resolved against the supplier's own geo endpoints. */
-    stateId: string;
-    cityId: string;
+    /**
+     * Supplier-native geo ids. Optional: when the host cannot produce the
+     * supplier's own ids (the common case — the host only knows its own geo),
+     * it leaves these empty and passes the human-readable names below. The
+     * plugin resolves names → supplier ids against its own geo endpoints.
+     */
+    stateId?: string;
+    cityId?: string;
+    /** ISO 3166-1 alpha-2 of the destination country (e.g. "GT", "SV"). */
+    countryCode?: string;
+    /** Human-readable admin-area (state/department) name for plugin-side resolution. */
+    stateName?: string;
+    /** Human-readable locality (city/municipality) name for plugin-side resolution. */
+    cityName?: string;
     extraLevels?: SupplierOrderAddressLevel[];
     latitude?: number;
     longitude?: number;
@@ -826,6 +837,7 @@ interface ISuppliersPlugin extends IPlugin {
     getListing(externalId: string, ctx: DispatchContext): Promise<SupplierListing>;
     placeOrder(order: PlaceSupplierOrderInput, ctx: DispatchContext): Promise<SupplierOrderResult>;
     getOrderStatus(externalOrderId: string, ctx: DispatchContext): Promise<SupplierOrderResult>;
+    cancelOrder?(externalOrderId: string, ctx: DispatchContext): Promise<SupplierOrderResult>;
     syncStock?(externalIds: string[], ctx: DispatchContext): Promise<SupplierStock[]>;
     parseWebhook?(body: unknown, headers: Record<string, string>, ctx: DispatchContext): SupplierFulfillmentEvent | null;
     isConfigured?(ctx: DispatchContext): boolean;
@@ -989,7 +1001,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.5.2";
+declare const SDK_VERSION = "0.6.0";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.d.ts

@@ -754,9 +754,20 @@ interface SupplierOrderAddressLevel {
 interface SupplierShipTo {
     address: string;
     referencePoint?: string | null;
-    /** Supplier geo ids — resolved against the supplier's own geo endpoints. */
-    stateId: string;
-    cityId: string;
+    /**
+     * Supplier-native geo ids. Optional: when the host cannot produce the
+     * supplier's own ids (the common case — the host only knows its own geo),
+     * it leaves these empty and passes the human-readable names below. The
+     * plugin resolves names → supplier ids against its own geo endpoints.
+     */
+    stateId?: string;
+    cityId?: string;
+    /** ISO 3166-1 alpha-2 of the destination country (e.g. "GT", "SV"). */
+    countryCode?: string;
+    /** Human-readable admin-area (state/department) name for plugin-side resolution. */
+    stateName?: string;
+    /** Human-readable locality (city/municipality) name for plugin-side resolution. */
+    cityName?: string;
     extraLevels?: SupplierOrderAddressLevel[];
     latitude?: number;
     longitude?: number;
@@ -826,6 +837,7 @@ interface ISuppliersPlugin extends IPlugin {
     getListing(externalId: string, ctx: DispatchContext): Promise<SupplierListing>;
     placeOrder(order: PlaceSupplierOrderInput, ctx: DispatchContext): Promise<SupplierOrderResult>;
     getOrderStatus(externalOrderId: string, ctx: DispatchContext): Promise<SupplierOrderResult>;
+    cancelOrder?(externalOrderId: string, ctx: DispatchContext): Promise<SupplierOrderResult>;
     syncStock?(externalIds: string[], ctx: DispatchContext): Promise<SupplierStock[]>;
     parseWebhook?(body: unknown, headers: Record<string, string>, ctx: DispatchContext): SupplierFulfillmentEvent | null;
     isConfigured?(ctx: DispatchContext): boolean;
@@ -989,7 +1001,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.5.2";
+declare const SDK_VERSION = "0.6.0";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.js

@@ -530,7 +530,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.2";
+var SDK_VERSION = "0.6.0";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);

package/dist/index.mjs

@@ -491,7 +491,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.2";
+var SDK_VERSION = "0.6.0";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivoa/plugin-sdk",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",