@hartl-services/medusa-contracts 1.0.1 → 1.1.0

package/README.md

@@ -27,6 +27,7 @@ Consumer subpaths:
 - `@hartl-services/medusa-contracts/types/checkout-store`
 - `@hartl-services/medusa-contracts/types/plugin-features-store`
 - `@hartl-services/medusa-contracts/types/plugin-features-admin`
+- `@hartl-services/medusa-contracts/types/tax-compliance-store`
 - `@hartl-services/medusa-contracts/schemas/affiliate`
 - `@hartl-services/medusa-contracts/schemas/batch-management`
 - `@hartl-services/medusa-contracts/schemas/documents`
@@ -37,6 +38,7 @@ Consumer subpaths:
 - `@hartl-services/medusa-contracts/schemas/password-policy`
 - `@hartl-services/medusa-contracts/schemas/checkout`
 - `@hartl-services/medusa-contracts/schemas/plugin-features`
+- `@hartl-services/medusa-contracts/schemas/tax-compliance`
 - `@hartl-services/medusa-contracts/paths/affiliate`
 - `@hartl-services/medusa-contracts/paths/batch-management`
 - `@hartl-services/medusa-contracts/paths/documents`
@@ -46,6 +48,7 @@ Consumer subpaths:
 - `@hartl-services/medusa-contracts/paths/customer-auth`
 - `@hartl-services/medusa-contracts/paths/checkout`
 - `@hartl-services/medusa-contracts/paths/plugin-features`
+- `@hartl-services/medusa-contracts/paths/tax-compliance`
 
 Server-only event subpaths (see "Server-only event contracts" below):
 
@@ -634,7 +637,11 @@ await sdk.client.fetch<AdminPluginActionRunResponse>(
 ```
 
 A `select` setting carries `options` (`{ value, label }[]`) and a string
-`value`/`default`; a `number` setting carries `min`/`max` (`null` = no bound).
+`value`/`default`. An `ordered_list` setting carries `options` as well; its
+string `value`/`default` lists the chosen option values in order, comma-separated
+without spaces (`"finanzonline,vies"`). A setting group's `visible_when` is
+`{ setting, equals }` (select or boolean) or `{ setting, includes }` (the
+ordered list contains that option). A `number` setting carries `min`/`max` (`null` = no bound).
 An `image` setting's `value` is the public http(s) URL of an uploaded image.
 A `color` setting's `value` is a lowercase hex color `#rrggbb`. Every setting
 carries `group`: the section heading the Admin shows it under (`null` = none).

package/dist/checkout/paths.d.ts

@@ -4,3 +4,11 @@ export declare const checkoutStorePaths: {
         readonly completionCheck: (cartId: string) => string;
     };
 };
+/**
+ * Message of the 400 a store cart request gets when the cart's email belongs
+ * to a registered customer and the request is not authenticated as that
+ * customer (setting the email, a payment session, completion). A storefront
+ * matches on it to offer its login: the JS SDK's FetchError keeps only the
+ * message and status, and a bare 400 is shared with validation failures.
+ */
+export declare const CUSTOMER_LOGIN_REQUIRED_MESSAGE = "F\u00FCr diese E-Mail-Adresse besteht bereits ein Kundenkonto. Bitte melde dich an, um die Bestellung abzuschlie\u00DFen.";

package/dist/checkout/paths.js

@@ -1,9 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkoutStorePaths = void 0;
+exports.CUSTOMER_LOGIN_REQUIRED_MESSAGE = exports.checkoutStorePaths = void 0;
 exports.checkoutStorePaths = {
     post: {
         /** Runs the completion checks without completing (POST, no body). */
         completionCheck: (cartId) => `/store/carts/${encodeURIComponent(cartId)}/completion-check`,
     },
 };
+/**
+ * Message of the 400 a store cart request gets when the cart's email belongs
+ * to a registered customer and the request is not authenticated as that
+ * customer (setting the email, a payment session, completion). A storefront
+ * matches on it to offer its login: the JS SDK's FetchError keeps only the
+ * message and status, and a bare 400 is shared with validation failures.
+ */
+exports.CUSTOMER_LOGIN_REQUIRED_MESSAGE = "Für diese E-Mail-Adresse besteht bereits ein Kundenkonto. Bitte melde dich an, um die Bestellung abzuschließen.";

package/dist/esm/checkout/paths.mjs

@@ -4,3 +4,11 @@ export const checkoutStorePaths = {
         completionCheck: (cartId) => `/store/carts/${encodeURIComponent(cartId)}/completion-check`,
     },
 };
+/**
+ * Message of the 400 a store cart request gets when the cart's email belongs
+ * to a registered customer and the request is not authenticated as that
+ * customer (setting the email, a payment session, completion). A storefront
+ * matches on it to offer its login: the JS SDK's FetchError keeps only the
+ * message and status, and a bare 400 is shared with validation failures.
+ */
+export const CUSTOMER_LOGIN_REQUIRED_MESSAGE = "Für diese E-Mail-Adresse besteht bereits ein Kundenkonto. Bitte melde dich an, um die Bestellung abzuschließen.";

package/dist/esm/plugin-features/schemas.mjs

@@ -28,7 +28,8 @@ export const AdminPluginFeatureSchema = z.object({
 });
 /**
  * `image` holds the public http(s) URL of an image uploaded in the Admin;
- * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`.
+ * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`;
+ * `ordered_list` the option values in order, comma-separated without spaces.
  */
 export const PluginSettingTypeSchema = z.enum([
     "string",
@@ -40,6 +41,7 @@ export const PluginSettingTypeSchema = z.enum([
     "image",
     "color",
     "date",
+    "ordered_list",
 ]);
 /** Where a setting's current value comes from. */
 export const PluginSettingSourceSchema = z.enum([
@@ -88,7 +90,7 @@ export const AdminPluginSecretSettingSchema = z.object({
     ...AdminPluginSettingBaseShape,
     type: z.literal("secret"),
 });
-/** One allowed value of a `select` setting. */
+/** One allowed value of a `select` or `ordered_list` setting. */
 export const PluginSettingOptionSchema = z.object({
     value: z.string().min(1),
     label: z.string().min(1),
@@ -102,6 +104,20 @@ export const AdminPluginSelectSettingSchema = z.object({
     /** Current value; `null` when nothing is set. */
     value: z.string().nullable(),
 });
+/**
+ * An ordered selection of the `options`: `value` is a comma-separated string
+ * of option values in order, e.g. `"finanzonline,vies"` (at least one, none
+ * twice).
+ */
+export const AdminPluginOrderedListSettingSchema = z.object({
+    ...AdminPluginSettingBaseShape,
+    type: z.literal("ordered_list"),
+    /** The values the list may contain, in display order. */
+    options: z.array(PluginSettingOptionSchema).min(1),
+    default: z.string().nullable(),
+    /** Current value; `null` when nothing is set. */
+    value: z.string().nullable(),
+});
 export const AdminPluginNumberSettingSchema = z.object({
     ...AdminPluginSettingBaseShape,
     type: z.literal("number"),
@@ -125,6 +141,7 @@ export const AdminPluginPlainSettingSchema = z.object({
 export const AdminPluginSettingSchema = z.union([
     AdminPluginSecretSettingSchema,
     AdminPluginSelectSettingSchema,
+    AdminPluginOrderedListSettingSchema,
     AdminPluginNumberSettingSchema,
     AdminPluginPlainSettingSchema,
 ]);
@@ -162,13 +179,21 @@ export const AdminPluginSettingGroupSchema = z.object({
     requires_feature: PluginFeatureKeySchema.nullable(),
     /**
      * The group applies only while the select or boolean setting `setting`
-     * has the value `equals`; the Admin hides it otherwise. `null` = always.
+     * has the value `equals`, or while the ordered_list setting `setting`
+     * contains the option `includes`; the Admin hides it otherwise. `null` =
+     * always.
      */
     visible_when: z
-        .object({
-        setting: PluginFeatureKeySchema,
-        equals: z.union([z.string(), z.boolean()]),
-    })
+        .union([
+        z.object({
+            setting: PluginFeatureKeySchema,
+            equals: z.union([z.string(), z.boolean()]),
+        }),
+        z.object({
+            setting: PluginFeatureKeySchema,
+            includes: z.string().min(1),
+        }),
+    ])
         .nullable(),
 });
 export const AdminPluginFeaturesSchema = z.object({

package/dist/esm/tax-compliance/paths.mjs

@@ -22,7 +22,14 @@ export const taxCompliancePaths = {
         /** GET: the merchant country, for which no UID is asked or checked. */
         taxIdentificationPolicy: "/store/tax-identification-policy",
         carts: {
+            /**
+             * POST: checks the billing address UID (synchronously) and applies the
+             * result to the cart's taxes. GET: the current status of the cart's UID
+             * check, `pending` while a background check runs.
+             */
             taxIdentification: (cartId) => `/store/carts/${pathSegment(cartId)}/tax-identification`,
+            /** POST: starts the background UID check of the billing address and answers at once. */
+            taxIdentificationCheck: (cartId) => `/store/carts/${pathSegment(cartId)}/tax-identification/check`,
         },
         customers: {
             /** POST: checks company, UID (metadata) and address of a saved address of the logged-in customer. */

package/dist/esm/tax-compliance/schemas.mjs

@@ -17,6 +17,32 @@ export const TaxIdentificationStatusSchema = z.enum([
     "invalid",
     "unavailable",
 ]);
+/**
+ * Status of a background UID check of a cart: the evidence statuses plus
+ * `pending` while the check (or one of its retries) still runs.
+ */
+export const TaxIdentificationCheckStatusSchema = z.enum([
+    "pending",
+    "eligible",
+    "ineligible",
+    "invalid",
+    "unavailable",
+]);
+/** Starting a background check takes no input: company and UID come from the billing address. */
+export const StartTaxIdentificationCheckSchema = z.object({}).strict();
+/**
+ * Answer of the background check routes. `status` is `null` while the
+ * billing address carries no UID or names a company in the merchant country
+ * (no check), and on GET while no check was started for the billing address
+ * as it is now. Once it is no longer `pending`, call the cart
+ * tax-identification route (POST) to apply the result to the cart's taxes.
+ */
+export const TaxIdentificationCheckResponseSchema = z.object({
+    status: TaxIdentificationCheckStatusSchema.nullable(),
+    message: z.string().nullable(),
+});
+export const StartTaxIdentificationCheckResponseSchema = TaxIdentificationCheckResponseSchema;
+export const GetTaxIdentificationStatusResponseSchema = TaxIdentificationCheckResponseSchema;
 export const TaxIdentificationCartTotalsSchema = z.object({
     id: z.string().trim().min(1),
     currency_code: z.string().trim().min(1),

package/dist/plugin-features/schemas.d.ts

@@ -31,7 +31,8 @@ export declare const AdminPluginFeatureSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * `image` holds the public http(s) URL of an image uploaded in the Admin;
- * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`.
+ * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`;
+ * `ordered_list` the option values in order, comma-separated without spaces.
  */
 export declare const PluginSettingTypeSchema: z.ZodEnum<{
     string: "string";
@@ -43,6 +44,7 @@ export declare const PluginSettingTypeSchema: z.ZodEnum<{
     select: "select";
     image: "image";
     color: "color";
+    ordered_list: "ordered_list";
 }>;
 /** Where a setting's current value comes from. */
 export declare const PluginSettingSourceSchema: z.ZodEnum<{
@@ -79,7 +81,7 @@ export declare const AdminPluginSecretSettingSchema: z.ZodObject<{
     }>;
     section: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
-/** One allowed value of a `select` setting. */
+/** One allowed value of a `select` or `ordered_list` setting. */
 export declare const PluginSettingOptionSchema: z.ZodObject<{
     value: z.ZodString;
     label: z.ZodString;
@@ -113,6 +115,40 @@ export declare const AdminPluginSelectSettingSchema: z.ZodObject<{
     }>;
     section: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * An ordered selection of the `options`: `value` is a comma-separated string
+ * of option values in order, e.g. `"finanzonline,vies"` (at least one, none
+ * twice).
+ */
+export declare const AdminPluginOrderedListSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ordered_list">;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    default: z.ZodNullable<z.ZodString>;
+    value: z.ZodNullable<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    group: z.ZodNullable<z.ZodString>;
+    required: z.ZodBoolean;
+    is_set: z.ZodBoolean;
+    source: z.ZodEnum<{
+        default: "default";
+        stored: "stored";
+        config: "config";
+        none: "none";
+    }>;
+    invalidates: z.ZodArray<z.ZodString>;
+    hint: z.ZodNullable<z.ZodString>;
+    placeholder: z.ZodNullable<z.ZodString>;
+    width: z.ZodEnum<{
+        full: "full";
+        half: "half";
+    }>;
+    section: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
 export declare const AdminPluginNumberSettingSchema: z.ZodObject<{
     type: z.ZodLiteral<"number">;
     min: z.ZodNullable<z.ZodNumber>;
@@ -223,6 +259,34 @@ export declare const AdminPluginSettingSchema: z.ZodUnion<readonly [z.ZodObject<
         half: "half";
     }>;
     section: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ordered_list">;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    default: z.ZodNullable<z.ZodString>;
+    value: z.ZodNullable<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    group: z.ZodNullable<z.ZodString>;
+    required: z.ZodBoolean;
+    is_set: z.ZodBoolean;
+    source: z.ZodEnum<{
+        default: "default";
+        stored: "stored";
+        config: "config";
+        none: "none";
+    }>;
+    invalidates: z.ZodArray<z.ZodString>;
+    hint: z.ZodNullable<z.ZodString>;
+    placeholder: z.ZodNullable<z.ZodString>;
+    width: z.ZodEnum<{
+        full: "full";
+        half: "half";
+    }>;
+    section: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"number">;
     min: z.ZodNullable<z.ZodNumber>;
@@ -351,6 +415,34 @@ export declare const AdminPluginSettingsSchema: z.ZodObject<{
             half: "half";
         }>;
         section: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ordered_list">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        default: z.ZodNullable<z.ZodString>;
+        value: z.ZodNullable<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        group: z.ZodNullable<z.ZodString>;
+        required: z.ZodBoolean;
+        is_set: z.ZodBoolean;
+        source: z.ZodEnum<{
+            default: "default";
+            stored: "stored";
+            config: "config";
+            none: "none";
+        }>;
+        invalidates: z.ZodArray<z.ZodString>;
+        hint: z.ZodNullable<z.ZodString>;
+        placeholder: z.ZodNullable<z.ZodString>;
+        width: z.ZodEnum<{
+            full: "full";
+            half: "half";
+        }>;
+        section: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"number">;
         min: z.ZodNullable<z.ZodNumber>;
@@ -417,10 +509,13 @@ export declare const AdminPluginSettingGroupSchema: z.ZodObject<{
     description: z.ZodNullable<z.ZodString>;
     note: z.ZodNullable<z.ZodString>;
     requires_feature: z.ZodNullable<z.ZodString>;
-    visible_when: z.ZodNullable<z.ZodObject<{
+    visible_when: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
         setting: z.ZodString;
         equals: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        setting: z.ZodString;
+        includes: z.ZodString;
+    }, z.core.$strip>]>>;
 }, z.core.$strip>;
 export declare const AdminPluginFeaturesSchema: z.ZodObject<{
     plugin_key: z.ZodString;
@@ -489,6 +584,34 @@ export declare const AdminPluginFeaturesSchema: z.ZodObject<{
             half: "half";
         }>;
         section: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ordered_list">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        default: z.ZodNullable<z.ZodString>;
+        value: z.ZodNullable<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        group: z.ZodNullable<z.ZodString>;
+        required: z.ZodBoolean;
+        is_set: z.ZodBoolean;
+        source: z.ZodEnum<{
+            default: "default";
+            stored: "stored";
+            config: "config";
+            none: "none";
+        }>;
+        invalidates: z.ZodArray<z.ZodString>;
+        hint: z.ZodNullable<z.ZodString>;
+        placeholder: z.ZodNullable<z.ZodString>;
+        width: z.ZodEnum<{
+            full: "full";
+            half: "half";
+        }>;
+        section: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"number">;
         min: z.ZodNullable<z.ZodNumber>;
@@ -575,10 +698,13 @@ export declare const AdminPluginFeaturesSchema: z.ZodObject<{
         description: z.ZodNullable<z.ZodString>;
         note: z.ZodNullable<z.ZodString>;
         requires_feature: z.ZodNullable<z.ZodString>;
-        visible_when: z.ZodNullable<z.ZodObject<{
+        visible_when: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
             setting: z.ZodString;
             equals: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            setting: z.ZodString;
+            includes: z.ZodString;
+        }, z.core.$strip>]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const AdminPluginFeaturesListResponseSchema: z.ZodObject<{
@@ -649,6 +775,34 @@ export declare const AdminPluginFeaturesListResponseSchema: z.ZodObject<{
                 half: "half";
             }>;
             section: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"ordered_list">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+            default: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            group: z.ZodNullable<z.ZodString>;
+            required: z.ZodBoolean;
+            is_set: z.ZodBoolean;
+            source: z.ZodEnum<{
+                default: "default";
+                stored: "stored";
+                config: "config";
+                none: "none";
+            }>;
+            invalidates: z.ZodArray<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            width: z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>;
+            section: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"number">;
             min: z.ZodNullable<z.ZodNumber>;
@@ -735,10 +889,13 @@ export declare const AdminPluginFeaturesListResponseSchema: z.ZodObject<{
             description: z.ZodNullable<z.ZodString>;
             note: z.ZodNullable<z.ZodString>;
             requires_feature: z.ZodNullable<z.ZodString>;
-            visible_when: z.ZodNullable<z.ZodObject<{
+            visible_when: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
                 setting: z.ZodString;
                 equals: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
-            }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                setting: z.ZodString;
+                includes: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -810,6 +967,34 @@ export declare const AdminPluginFeaturesResponseSchema: z.ZodObject<{
                 half: "half";
             }>;
             section: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"ordered_list">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+            default: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            group: z.ZodNullable<z.ZodString>;
+            required: z.ZodBoolean;
+            is_set: z.ZodBoolean;
+            source: z.ZodEnum<{
+                default: "default";
+                stored: "stored";
+                config: "config";
+                none: "none";
+            }>;
+            invalidates: z.ZodArray<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            width: z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>;
+            section: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"number">;
             min: z.ZodNullable<z.ZodNumber>;
@@ -896,10 +1081,13 @@ export declare const AdminPluginFeaturesResponseSchema: z.ZodObject<{
             description: z.ZodNullable<z.ZodString>;
             note: z.ZodNullable<z.ZodString>;
             requires_feature: z.ZodNullable<z.ZodString>;
-            visible_when: z.ZodNullable<z.ZodObject<{
+            visible_when: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
                 setting: z.ZodString;
                 equals: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
-            }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodObject<{
+                setting: z.ZodString;
+                includes: z.ZodString;
+            }, z.core.$strip>]>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -965,6 +1153,34 @@ export declare const AdminPluginSettingsResponseSchema: z.ZodObject<{
                 half: "half";
             }>;
             section: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"ordered_list">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+            default: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            group: z.ZodNullable<z.ZodString>;
+            required: z.ZodBoolean;
+            is_set: z.ZodBoolean;
+            source: z.ZodEnum<{
+                default: "default";
+                stored: "stored";
+                config: "config";
+                none: "none";
+            }>;
+            invalidates: z.ZodArray<z.ZodString>;
+            hint: z.ZodNullable<z.ZodString>;
+            placeholder: z.ZodNullable<z.ZodString>;
+            width: z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>;
+            section: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"number">;
             min: z.ZodNullable<z.ZodNumber>;

package/dist/plugin-features/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdminPluginActionRunsResponseSchema = exports.ListPluginActionRunsQuerySchema = exports.PLUGIN_ACTION_RUNS_MAX_LIMIT = exports.AdminPluginActionConflictResponseSchema = exports.AdminPluginActionRunResponseSchema = exports.PluginActionRunSchema = exports.PluginActionRunProgressSchema = exports.PluginActionRunStateSchema = exports.PluginActionRunStatusSchema = exports.RunPluginActionSchema = exports.UpdatePluginSettingsSchema = exports.PLUGIN_SETTING_MAX_STRING_LENGTH = exports.AdminPluginSettingsResponseSchema = exports.UpdatePluginFeaturesSchema = exports.AdminPluginFeaturesResponseSchema = exports.AdminPluginFeaturesListResponseSchema = exports.AdminPluginFeaturesSchema = exports.AdminPluginSettingGroupSchema = exports.AdminPluginSettingsSchema = exports.AdminPluginActionSchema = exports.PluginActionModeSchema = exports.AdminPluginSettingSchema = exports.AdminPluginPlainSettingSchema = exports.AdminPluginNumberSettingSchema = exports.AdminPluginSelectSettingSchema = exports.PluginSettingOptionSchema = exports.AdminPluginSecretSettingSchema = exports.PluginSettingValueSchema = exports.PluginSettingSourceSchema = exports.PluginSettingTypeSchema = exports.AdminPluginFeatureSchema = exports.StorePluginFeaturesResponseSchema = exports.StorePluginFeaturesListResponseSchema = exports.StorePluginFeaturesSchema = exports.PluginFeatureKeySchema = void 0;
+exports.AdminPluginActionRunsResponseSchema = exports.ListPluginActionRunsQuerySchema = exports.PLUGIN_ACTION_RUNS_MAX_LIMIT = exports.AdminPluginActionConflictResponseSchema = exports.AdminPluginActionRunResponseSchema = exports.PluginActionRunSchema = exports.PluginActionRunProgressSchema = exports.PluginActionRunStateSchema = exports.PluginActionRunStatusSchema = exports.RunPluginActionSchema = exports.UpdatePluginSettingsSchema = exports.PLUGIN_SETTING_MAX_STRING_LENGTH = exports.AdminPluginSettingsResponseSchema = exports.UpdatePluginFeaturesSchema = exports.AdminPluginFeaturesResponseSchema = exports.AdminPluginFeaturesListResponseSchema = exports.AdminPluginFeaturesSchema = exports.AdminPluginSettingGroupSchema = exports.AdminPluginSettingsSchema = exports.AdminPluginActionSchema = exports.PluginActionModeSchema = exports.AdminPluginSettingSchema = exports.AdminPluginPlainSettingSchema = exports.AdminPluginNumberSettingSchema = exports.AdminPluginOrderedListSettingSchema = exports.AdminPluginSelectSettingSchema = exports.PluginSettingOptionSchema = exports.AdminPluginSecretSettingSchema = exports.PluginSettingValueSchema = exports.PluginSettingSourceSchema = exports.PluginSettingTypeSchema = exports.AdminPluginFeatureSchema = exports.StorePluginFeaturesResponseSchema = exports.StorePluginFeaturesListResponseSchema = exports.StorePluginFeaturesSchema = exports.PluginFeatureKeySchema = void 0;
 const zod_1 = require("@medusajs/framework/zod");
 const primitives_1 = require("../shared/primitives");
 /** Key format shared by plugin keys and feature keys. */
@@ -31,7 +31,8 @@ exports.AdminPluginFeatureSchema = zod_1.z.object({
 });
 /**
  * `image` holds the public http(s) URL of an image uploaded in the Admin;
- * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`.
+ * `color` a lowercase hex color `#rrggbb`; `date` a calendar day `YYYY-MM-DD`;
+ * `ordered_list` the option values in order, comma-separated without spaces.
  */
 exports.PluginSettingTypeSchema = zod_1.z.enum([
     "string",
@@ -43,6 +44,7 @@ exports.PluginSettingTypeSchema = zod_1.z.enum([
     "image",
     "color",
     "date",
+    "ordered_list",
 ]);
 /** Where a setting's current value comes from. */
 exports.PluginSettingSourceSchema = zod_1.z.enum([
@@ -91,7 +93,7 @@ exports.AdminPluginSecretSettingSchema = zod_1.z.object({
     ...AdminPluginSettingBaseShape,
     type: zod_1.z.literal("secret"),
 });
-/** One allowed value of a `select` setting. */
+/** One allowed value of a `select` or `ordered_list` setting. */
 exports.PluginSettingOptionSchema = zod_1.z.object({
     value: zod_1.z.string().min(1),
     label: zod_1.z.string().min(1),
@@ -105,6 +107,20 @@ exports.AdminPluginSelectSettingSchema = zod_1.z.object({
     /** Current value; `null` when nothing is set. */
     value: zod_1.z.string().nullable(),
 });
+/**
+ * An ordered selection of the `options`: `value` is a comma-separated string
+ * of option values in order, e.g. `"finanzonline,vies"` (at least one, none
+ * twice).
+ */
+exports.AdminPluginOrderedListSettingSchema = zod_1.z.object({
+    ...AdminPluginSettingBaseShape,
+    type: zod_1.z.literal("ordered_list"),
+    /** The values the list may contain, in display order. */
+    options: zod_1.z.array(exports.PluginSettingOptionSchema).min(1),
+    default: zod_1.z.string().nullable(),
+    /** Current value; `null` when nothing is set. */
+    value: zod_1.z.string().nullable(),
+});
 exports.AdminPluginNumberSettingSchema = zod_1.z.object({
     ...AdminPluginSettingBaseShape,
     type: zod_1.z.literal("number"),
@@ -128,6 +144,7 @@ exports.AdminPluginPlainSettingSchema = zod_1.z.object({
 exports.AdminPluginSettingSchema = zod_1.z.union([
     exports.AdminPluginSecretSettingSchema,
     exports.AdminPluginSelectSettingSchema,
+    exports.AdminPluginOrderedListSettingSchema,
     exports.AdminPluginNumberSettingSchema,
     exports.AdminPluginPlainSettingSchema,
 ]);
@@ -165,13 +182,21 @@ exports.AdminPluginSettingGroupSchema = zod_1.z.object({
     requires_feature: exports.PluginFeatureKeySchema.nullable(),
     /**
      * The group applies only while the select or boolean setting `setting`
-     * has the value `equals`; the Admin hides it otherwise. `null` = always.
+     * has the value `equals`, or while the ordered_list setting `setting`
+     * contains the option `includes`; the Admin hides it otherwise. `null` =
+     * always.
      */
     visible_when: zod_1.z
-        .object({
-        setting: exports.PluginFeatureKeySchema,
-        equals: zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]),
-    })
+        .union([
+        zod_1.z.object({
+            setting: exports.PluginFeatureKeySchema,
+            equals: zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]),
+        }),
+        zod_1.z.object({
+            setting: exports.PluginFeatureKeySchema,
+            includes: zod_1.z.string().min(1),
+        }),
+    ])
         .nullable(),
 });
 exports.AdminPluginFeaturesSchema = zod_1.z.object({

package/dist/tax-compliance/paths.d.ts

@@ -21,7 +21,14 @@ export declare const taxCompliancePaths: {
         /** GET: the merchant country, for which no UID is asked or checked. */
         readonly taxIdentificationPolicy: "/store/tax-identification-policy";
         readonly carts: {
+            /**
+             * POST: checks the billing address UID (synchronously) and applies the
+             * result to the cart's taxes. GET: the current status of the cart's UID
+             * check, `pending` while a background check runs.
+             */
             readonly taxIdentification: (cartId: string) => string;
+            /** POST: starts the background UID check of the billing address and answers at once. */
+            readonly taxIdentificationCheck: (cartId: string) => string;
         };
         readonly customers: {
             /** POST: checks company, UID (metadata) and address of a saved address of the logged-in customer. */

package/dist/tax-compliance/paths.js

@@ -25,7 +25,14 @@ exports.taxCompliancePaths = {
         /** GET: the merchant country, for which no UID is asked or checked. */
         taxIdentificationPolicy: "/store/tax-identification-policy",
         carts: {
+            /**
+             * POST: checks the billing address UID (synchronously) and applies the
+             * result to the cart's taxes. GET: the current status of the cart's UID
+             * check, `pending` while a background check runs.
+             */
             taxIdentification: (cartId) => `/store/carts/${pathSegment(cartId)}/tax-identification`,
+            /** POST: starts the background UID check of the billing address and answers at once. */
+            taxIdentificationCheck: (cartId) => `/store/carts/${pathSegment(cartId)}/tax-identification/check`,
         },
         customers: {
             /** POST: checks company, UID (metadata) and address of a saved address of the logged-in customer. */

package/dist/tax-compliance/schemas.d.ts

@@ -15,6 +15,56 @@ export declare const TaxIdentificationStatusSchema: z.ZodEnum<{
     unavailable: "unavailable";
     invalid: "invalid";
 }>;
+/**
+ * Status of a background UID check of a cart: the evidence statuses plus
+ * `pending` while the check (or one of its retries) still runs.
+ */
+export declare const TaxIdentificationCheckStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    eligible: "eligible";
+    ineligible: "ineligible";
+    unavailable: "unavailable";
+    invalid: "invalid";
+}>;
+/** Starting a background check takes no input: company and UID come from the billing address. */
+export declare const StartTaxIdentificationCheckSchema: z.ZodObject<{}, z.core.$strict>;
+/**
+ * Answer of the background check routes. `status` is `null` while the
+ * billing address carries no UID or names a company in the merchant country
+ * (no check), and on GET while no check was started for the billing address
+ * as it is now. Once it is no longer `pending`, call the cart
+ * tax-identification route (POST) to apply the result to the cart's taxes.
+ */
+export declare const TaxIdentificationCheckResponseSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        eligible: "eligible";
+        ineligible: "ineligible";
+        unavailable: "unavailable";
+        invalid: "invalid";
+    }>>;
+    message: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const StartTaxIdentificationCheckResponseSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        eligible: "eligible";
+        ineligible: "ineligible";
+        unavailable: "unavailable";
+        invalid: "invalid";
+    }>>;
+    message: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const GetTaxIdentificationStatusResponseSchema: z.ZodObject<{
+    status: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        eligible: "eligible";
+        ineligible: "ineligible";
+        unavailable: "unavailable";
+        invalid: "invalid";
+    }>>;
+    message: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
 export declare const TaxIdentificationCartTotalsSchema: z.ZodObject<{
     id: z.ZodString;
     currency_code: z.ZodString;

package/dist/tax-compliance/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListCustomerTaxIdentificationsResponseSchema = exports.GetTaxIdentificationPolicyResponseSchema = exports.SubmitCustomerAddressTaxIdentificationResponseSchema = exports.CustomerAddressTaxIdentificationSchema = exports.SubmitTaxIdentificationResponseSchema = exports.TaxIdentificationCartTotalsSchema = exports.TaxIdentificationStatusSchema = exports.SubmitTaxIdentificationSchema = void 0;
+exports.ListCustomerTaxIdentificationsResponseSchema = exports.GetTaxIdentificationPolicyResponseSchema = exports.SubmitCustomerAddressTaxIdentificationResponseSchema = exports.CustomerAddressTaxIdentificationSchema = exports.SubmitTaxIdentificationResponseSchema = exports.TaxIdentificationCartTotalsSchema = exports.GetTaxIdentificationStatusResponseSchema = exports.StartTaxIdentificationCheckResponseSchema = exports.TaxIdentificationCheckResponseSchema = exports.StartTaxIdentificationCheckSchema = exports.TaxIdentificationCheckStatusSchema = exports.TaxIdentificationStatusSchema = exports.SubmitTaxIdentificationSchema = void 0;
 const zod_1 = require("@medusajs/framework/zod");
 /**
  * Company and UID come from the cart's billing address (company and
@@ -20,6 +20,32 @@ exports.TaxIdentificationStatusSchema = zod_1.z.enum([
     "invalid",
     "unavailable",
 ]);
+/**
+ * Status of a background UID check of a cart: the evidence statuses plus
+ * `pending` while the check (or one of its retries) still runs.
+ */
+exports.TaxIdentificationCheckStatusSchema = zod_1.z.enum([
+    "pending",
+    "eligible",
+    "ineligible",
+    "invalid",
+    "unavailable",
+]);
+/** Starting a background check takes no input: company and UID come from the billing address. */
+exports.StartTaxIdentificationCheckSchema = zod_1.z.object({}).strict();
+/**
+ * Answer of the background check routes. `status` is `null` while the
+ * billing address carries no UID or names a company in the merchant country
+ * (no check), and on GET while no check was started for the billing address
+ * as it is now. Once it is no longer `pending`, call the cart
+ * tax-identification route (POST) to apply the result to the cart's taxes.
+ */
+exports.TaxIdentificationCheckResponseSchema = zod_1.z.object({
+    status: exports.TaxIdentificationCheckStatusSchema.nullable(),
+    message: zod_1.z.string().nullable(),
+});
+exports.StartTaxIdentificationCheckResponseSchema = exports.TaxIdentificationCheckResponseSchema;
+exports.GetTaxIdentificationStatusResponseSchema = exports.TaxIdentificationCheckResponseSchema;
 exports.TaxIdentificationCartTotalsSchema = zod_1.z.object({
     id: zod_1.z.string().trim().min(1),
     currency_code: zod_1.z.string().trim().min(1),

package/dist/tax-compliance/store-types.d.ts

@@ -1,10 +1,14 @@
 import type { z } from "@medusajs/framework/zod";
-import type { CustomerAddressTaxIdentificationSchema, GetTaxIdentificationPolicyResponseSchema, ListCustomerTaxIdentificationsResponseSchema, SubmitCustomerAddressTaxIdentificationResponseSchema, SubmitTaxIdentificationResponseSchema, SubmitTaxIdentificationSchema, TaxIdentificationCartTotalsSchema, TaxIdentificationStatusSchema } from "./schemas";
+import type { CustomerAddressTaxIdentificationSchema, GetTaxIdentificationPolicyResponseSchema, GetTaxIdentificationStatusResponseSchema, StartTaxIdentificationCheckResponseSchema, StartTaxIdentificationCheckSchema, TaxIdentificationCheckStatusSchema, ListCustomerTaxIdentificationsResponseSchema, SubmitCustomerAddressTaxIdentificationResponseSchema, SubmitTaxIdentificationResponseSchema, SubmitTaxIdentificationSchema, TaxIdentificationCartTotalsSchema, TaxIdentificationStatusSchema } from "./schemas";
 /** Raw Store HTTP body before trim and uppercase normalization. */
 export type SubmitTaxIdentificationRequest = z.input<typeof SubmitTaxIdentificationSchema>;
 /** Validated Store HTTP body consumed by the route workflow. */
 export type SubmitTaxIdentification = z.infer<typeof SubmitTaxIdentificationSchema>;
 export type TaxIdentificationStatus = z.infer<typeof TaxIdentificationStatusSchema>;
+export type TaxIdentificationCheckStatus = z.infer<typeof TaxIdentificationCheckStatusSchema>;
+export type StartTaxIdentificationCheckRequest = z.input<typeof StartTaxIdentificationCheckSchema>;
+export type StartTaxIdentificationCheckResponse = z.infer<typeof StartTaxIdentificationCheckResponseSchema>;
+export type GetTaxIdentificationStatusResponse = z.infer<typeof GetTaxIdentificationStatusResponseSchema>;
 export type TaxIdentificationCartTotals = z.infer<typeof TaxIdentificationCartTotalsSchema>;
 export type SubmitTaxIdentificationResponse = z.infer<typeof SubmitTaxIdentificationResponseSchema>;
 export type CustomerAddressTaxIdentification = z.infer<typeof CustomerAddressTaxIdentificationSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hartl-services/medusa-contracts",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": false,
   "sideEffects": false,
   "files": [