@hartl-services/medusa-contracts 1.5.0 → 1.6.0

package/README.md

@@ -28,6 +28,7 @@ Consumer subpaths:
 - `@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/types/order-assistant`
 - `@hartl-services/medusa-contracts/schemas/affiliate`
 - `@hartl-services/medusa-contracts/schemas/batch-management`
 - `@hartl-services/medusa-contracts/schemas/documents`
@@ -39,6 +40,7 @@ Consumer subpaths:
 - `@hartl-services/medusa-contracts/schemas/checkout`
 - `@hartl-services/medusa-contracts/schemas/plugin-features`
 - `@hartl-services/medusa-contracts/schemas/tax-compliance`
+- `@hartl-services/medusa-contracts/schemas/order-assistant`
 - `@hartl-services/medusa-contracts/paths/affiliate`
 - `@hartl-services/medusa-contracts/paths/batch-management`
 - `@hartl-services/medusa-contracts/paths/documents`
@@ -49,6 +51,7 @@ Consumer subpaths:
 - `@hartl-services/medusa-contracts/paths/checkout`
 - `@hartl-services/medusa-contracts/paths/plugin-features`
 - `@hartl-services/medusa-contracts/paths/tax-compliance`
+- `@hartl-services/medusa-contracts/paths/order-assistant`
 
 Server-only event subpaths (see "Server-only event contracts" below):
 
@@ -70,6 +73,12 @@ Packing-list DTOs are exported only from `types/documents-admin`. Use
 `packingListsPaths` from `paths/documents` with the consuming Admin's configured
 Medusa SDK; there is deliberately no packing-list Store contract or client.
 
+The order assistant (`order-assistant`) is not a JSON REST route: `paths` holds
+the MCP endpoint (`/mcp`), `schemas` the input and output schemas of its four
+tools, the tool names and the order metadata keys the assistant writes, and
+`types` their inferred types. A storefront never calls it; the consumer is an
+MCP client (an AI chatbot) and the base's own tests.
+
 File Gateway responses are binary and have no JSON response DTO. Public paths
 come from `paths/files`. Private gateway URLs are opaque, signed server results
 and must not be assembled by a consumer.

package/dist/email/schemas.d.ts

@@ -40,6 +40,7 @@ export declare const EmailSafeStatusCodeSchema: z.ZodEnum<{
     connection_failed: "connection_failed";
     invalid_content: "invalid_content";
     lease_expired: "lease_expired";
+    no_recipient: "no_recipient";
     not_configured: "not_configured";
     notifications_disabled: "notifications_disabled";
     outcome_unknown: "outcome_unknown";
@@ -179,6 +180,7 @@ export declare const AdminEmailMessageSchema: z.ZodObject<{
         connection_failed: "connection_failed";
         invalid_content: "invalid_content";
         lease_expired: "lease_expired";
+        no_recipient: "no_recipient";
         not_configured: "not_configured";
         notifications_disabled: "notifications_disabled";
         outcome_unknown: "outcome_unknown";
@@ -217,6 +219,7 @@ export declare const AdminEmailAttemptSchema: z.ZodObject<{
         connection_failed: "connection_failed";
         invalid_content: "invalid_content";
         lease_expired: "lease_expired";
+        no_recipient: "no_recipient";
         not_configured: "not_configured";
         notifications_disabled: "notifications_disabled";
         outcome_unknown: "outcome_unknown";
@@ -312,6 +315,7 @@ export declare const ListAdminEmailMessagesResponseSchema: z.ZodObject<{
             connection_failed: "connection_failed";
             invalid_content: "invalid_content";
             lease_expired: "lease_expired";
+            no_recipient: "no_recipient";
             not_configured: "not_configured";
             notifications_disabled: "notifications_disabled";
             outcome_unknown: "outcome_unknown";
@@ -382,6 +386,7 @@ export declare const GetAdminEmailMessageResponseSchema: z.ZodObject<{
             connection_failed: "connection_failed";
             invalid_content: "invalid_content";
             lease_expired: "lease_expired";
+            no_recipient: "no_recipient";
             not_configured: "not_configured";
             notifications_disabled: "notifications_disabled";
             outcome_unknown: "outcome_unknown";
@@ -420,6 +425,7 @@ export declare const GetAdminEmailMessageResponseSchema: z.ZodObject<{
             connection_failed: "connection_failed";
             invalid_content: "invalid_content";
             lease_expired: "lease_expired";
+            no_recipient: "no_recipient";
             not_configured: "not_configured";
             notifications_disabled: "notifications_disabled";
             outcome_unknown: "outcome_unknown";
@@ -486,6 +492,7 @@ export declare const ResendAdminEmailMessageResponseSchema: z.ZodObject<{
             connection_failed: "connection_failed";
             invalid_content: "invalid_content";
             lease_expired: "lease_expired";
+            no_recipient: "no_recipient";
             not_configured: "not_configured";
             notifications_disabled: "notifications_disabled";
             outcome_unknown: "outcome_unknown";

package/dist/email/schemas.js

@@ -44,6 +44,7 @@ exports.EmailSafeStatusCodeSchema = zod_1.z.enum([
     "connection_failed",
     "invalid_content",
     "lease_expired",
+    "no_recipient",
     "not_configured",
     "notifications_disabled",
     "outcome_unknown",

package/dist/esm/email/schemas.mjs

@@ -41,6 +41,7 @@ export const EmailSafeStatusCodeSchema = z.enum([
     "connection_failed",
     "invalid_content",
     "lease_expired",
+    "no_recipient",
     "not_configured",
     "notifications_disabled",
     "outcome_unknown",

package/dist/esm/order-assistant/paths.mjs

@@ -0,0 +1,7 @@
+/**
+ * The shop's MCP endpoint for the order assistant (Streamable HTTP,
+ * stateless). Outside `/admin` and `/store`: it authenticates on its own.
+ */
+export const orderAssistantPaths = {
+    mcp: "/mcp",
+};

package/dist/esm/order-assistant/schemas.mjs

@@ -0,0 +1,183 @@
+import { z } from "@medusajs/framework/zod";
+import { NonEmptyStringSchema } from "../shared/primitives.mjs";
+/** Plugin key and container key of the order assistant in the base. */
+export const ORDER_ASSISTANT_PLUGIN_KEY = "order_assistant";
+/** Tool names as the MCP client sees them. */
+export const ORDER_ASSISTANT_TOOLS = {
+    searchCustomers: "kunden_suchen",
+    searchProducts: "produkte_suchen",
+    listShippingOptions: "versandarten_auflisten",
+    createDraftOrder: "bestellentwurf_anlegen",
+};
+/** How the order reached the shop; stored in the order metadata. */
+export const OrderAssistantSourceSchema = z.enum(["fax", "telefon"]);
+/** Order metadata keys the assistant writes. */
+export const ORDER_ASSISTANT_METADATA = {
+    source: "order_source",
+    note: "order_note",
+};
+export const ORDER_ASSISTANT_LIMITS = {
+    customers: 10,
+    variants: 20,
+    items: 50,
+    noteLength: 2000,
+};
+const CountryCodeSchema = z
+    .string()
+    .trim()
+    .toLowerCase()
+    .regex(/^[a-z]{2}$/)
+    .describe("Land als ISO-3166-1-alpha-2-Code, z. B. at oder de.");
+const OptionalTextSchema = z.string().trim().min(1).max(255).optional();
+export const OrderAssistantAddressSchema = z
+    .object({
+    first_name: NonEmptyStringSchema.max(255),
+    last_name: NonEmptyStringSchema.max(255),
+    company: OptionalTextSchema.describe("Firma oder Praxis, falls angegeben."),
+    address_1: NonEmptyStringSchema.max(255).describe("Straße und Hausnummer."),
+    address_2: OptionalTextSchema.describe("Adresszusatz."),
+    postal_code: NonEmptyStringSchema.max(20),
+    city: NonEmptyStringSchema.max(255),
+    country_code: CountryCodeSchema,
+    phone: OptionalTextSchema,
+})
+    .strict();
+export const SearchCustomersInputSchema = z
+    .object({
+    query: OptionalTextSchema.describe("Name, Firma, Telefonnummer oder E-Mail-Adresse (auch Teile davon)."),
+    postal_code: OptionalTextSchema.describe("PLZ einer Adresse der Person."),
+    city: OptionalTextSchema.describe("Ort einer Adresse der Person."),
+})
+    .strict()
+    .refine((value) => Boolean(value.query ?? value.postal_code ?? value.city), { message: "Mindestens ein Suchfeld ist nötig." });
+export const OrderAssistantCustomerAddressSchema = z.object({
+    first_name: z.string().nullable(),
+    last_name: z.string().nullable(),
+    company: z.string().nullable(),
+    address_1: z.string().nullable(),
+    address_2: z.string().nullable(),
+    postal_code: z.string().nullable(),
+    city: z.string().nullable(),
+    country_code: z.string().nullable(),
+    phone: z.string().nullable(),
+});
+export const OrderAssistantCustomerSchema = z.object({
+    id: z.string(),
+    first_name: z.string().nullable(),
+    last_name: z.string().nullable(),
+    company_name: z.string().nullable(),
+    email: z.string().nullable(),
+    phone: z.string().nullable(),
+    /** Registered shop account (true) or a customer record without login. */
+    has_account: z.boolean(),
+    addresses: z.array(OrderAssistantCustomerAddressSchema),
+});
+export const SearchCustomersOutputSchema = z.object({
+    customers: z.array(OrderAssistantCustomerSchema),
+});
+export const SearchProductsInputSchema = z
+    .object({
+    query: NonEmptyStringSchema.max(255).describe("Produktname oder Artikelnummer (auch Teile davon)."),
+    country_code: CountryCodeSchema.describe("Lieferland als ISO-Code; bestimmt Preis und Währung."),
+})
+    .strict();
+export const OrderAssistantVariantSchema = z.object({
+    variant_id: z.string(),
+    product_title: z.string(),
+    variant_title: z.string().nullable(),
+    sku: z.string().nullable(),
+    /** Price per unit in major currency units (33.5 = 33,50); null without a price. */
+    unit_price: z.number().nullable(),
+    currency_code: z.string(),
+    /** Available quantity; null when the variant's stock is not managed. */
+    available_quantity: z.number().nullable(),
+    /** False when the variant cannot be ordered (no price or no stock). */
+    orderable: z.boolean(),
+});
+export const SearchProductsOutputSchema = z.object({
+    variants: z.array(OrderAssistantVariantSchema),
+});
+export const ListShippingOptionsInputSchema = z
+    .object({
+    country_code: CountryCodeSchema.describe("Lieferland als ISO-Code."),
+})
+    .strict();
+export const OrderAssistantShippingOptionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    /** Flat price in major currency units; null when none is set for the currency. */
+    amount: z.number().nullable(),
+    currency_code: z.string(),
+});
+export const ListShippingOptionsOutputSchema = z.object({
+    shipping_options: z.array(OrderAssistantShippingOptionSchema),
+});
+export const OrderAssistantNewCustomerSchema = z
+    .object({
+    first_name: NonEmptyStringSchema.max(255),
+    last_name: NonEmptyStringSchema.max(255),
+    company_name: OptionalTextSchema,
+    email: z
+        .string()
+        .trim()
+        .toLowerCase()
+        .email()
+        .max(255)
+        .optional()
+        .describe("Nur angeben, wenn eine E-Mail-Adresse bekannt ist."),
+    phone: OptionalTextSchema,
+})
+    .strict();
+export const CreateDraftOrderInputSchema = z
+    .object({
+    customer_id: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("ID einer bestehenden Kund:in aus kunden_suchen."),
+    new_customer: OrderAssistantNewCustomerSchema.optional().describe("Neue Kund:in ohne Konto; nur wenn kunden_suchen niemanden findet."),
+    shipping_address: OrderAssistantAddressSchema,
+    billing_address: OrderAssistantAddressSchema.optional().describe("Rechnungsadresse; ohne Angabe gilt die Lieferadresse."),
+    items: z
+        .array(z
+        .object({
+        variant_id: NonEmptyStringSchema.describe("ID der Variante aus produkte_suchen."),
+        quantity: z.number().int().positive().max(9999),
+    })
+        .strict())
+        .min(1)
+        .max(ORDER_ASSISTANT_LIMITS.items),
+    shipping_option_id: NonEmptyStringSchema.describe("ID der Versandart aus versandarten_auflisten."),
+    source: OrderAssistantSourceSchema.describe("Wie die Bestellung eingegangen ist."),
+    note: z
+        .string()
+        .trim()
+        .min(1)
+        .max(ORDER_ASSISTANT_LIMITS.noteLength)
+        .optional()
+        .describe("Interne Notiz, z. B. Unklarheiten auf dem Fax."),
+})
+    .strict()
+    .refine((value) => Boolean(value.customer_id) !== Boolean(value.new_customer), { message: "Genau eines von customer_id und new_customer ist nötig." });
+export const OrderAssistantDraftItemSchema = z.object({
+    title: z.string(),
+    sku: z.string().nullable(),
+    quantity: z.number(),
+    unit_price: z.number(),
+    total: z.number(),
+});
+export const CreateDraftOrderOutputSchema = z.object({
+    draft_order_id: z.string(),
+    display_id: z.number().nullable(),
+    customer_id: z.string(),
+    /** True when the assistant created the customer record for this draft. */
+    customer_created: z.boolean(),
+    currency_code: z.string(),
+    items: z.array(OrderAssistantDraftItemSchema),
+    shipping_total: z.number(),
+    tax_total: z.number(),
+    total: z.number(),
+    /** Path of the draft in the Admin, relative to the backend URL. */
+    admin_path: z.string(),
+});

package/dist/esm/order-assistant/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/order-assistant/paths.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The shop's MCP endpoint for the order assistant (Streamable HTTP,
+ * stateless). Outside `/admin` and `/store`: it authenticates on its own.
+ */
+export declare const orderAssistantPaths: {
+    readonly mcp: "/mcp";
+};

package/dist/order-assistant/paths.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orderAssistantPaths = void 0;
+/**
+ * The shop's MCP endpoint for the order assistant (Streamable HTTP,
+ * stateless). Outside `/admin` and `/store`: it authenticates on its own.
+ */
+exports.orderAssistantPaths = {
+    mcp: "/mcp",
+};

package/dist/order-assistant/schemas.d.ts

@@ -0,0 +1,213 @@
+import { z } from "@medusajs/framework/zod";
+/** Plugin key and container key of the order assistant in the base. */
+export declare const ORDER_ASSISTANT_PLUGIN_KEY = "order_assistant";
+/** Tool names as the MCP client sees them. */
+export declare const ORDER_ASSISTANT_TOOLS: {
+    readonly searchCustomers: "kunden_suchen";
+    readonly searchProducts: "produkte_suchen";
+    readonly listShippingOptions: "versandarten_auflisten";
+    readonly createDraftOrder: "bestellentwurf_anlegen";
+};
+export type OrderAssistantToolName = (typeof ORDER_ASSISTANT_TOOLS)[keyof typeof ORDER_ASSISTANT_TOOLS];
+/** How the order reached the shop; stored in the order metadata. */
+export declare const OrderAssistantSourceSchema: z.ZodEnum<{
+    fax: "fax";
+    telefon: "telefon";
+}>;
+/** Order metadata keys the assistant writes. */
+export declare const ORDER_ASSISTANT_METADATA: {
+    readonly source: "order_source";
+    readonly note: "order_note";
+};
+export declare const ORDER_ASSISTANT_LIMITS: {
+    readonly customers: 10;
+    readonly variants: 20;
+    readonly items: 50;
+    readonly noteLength: 2000;
+};
+export declare const OrderAssistantAddressSchema: z.ZodObject<{
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    company: z.ZodOptional<z.ZodString>;
+    address_1: z.ZodString;
+    address_2: z.ZodOptional<z.ZodString>;
+    postal_code: z.ZodString;
+    city: z.ZodString;
+    country_code: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const SearchCustomersInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    postal_code: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const OrderAssistantCustomerAddressSchema: z.ZodObject<{
+    first_name: z.ZodNullable<z.ZodString>;
+    last_name: z.ZodNullable<z.ZodString>;
+    company: z.ZodNullable<z.ZodString>;
+    address_1: z.ZodNullable<z.ZodString>;
+    address_2: z.ZodNullable<z.ZodString>;
+    postal_code: z.ZodNullable<z.ZodString>;
+    city: z.ZodNullable<z.ZodString>;
+    country_code: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const OrderAssistantCustomerSchema: z.ZodObject<{
+    id: z.ZodString;
+    first_name: z.ZodNullable<z.ZodString>;
+    last_name: z.ZodNullable<z.ZodString>;
+    company_name: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    has_account: z.ZodBoolean;
+    addresses: z.ZodArray<z.ZodObject<{
+        first_name: z.ZodNullable<z.ZodString>;
+        last_name: z.ZodNullable<z.ZodString>;
+        company: z.ZodNullable<z.ZodString>;
+        address_1: z.ZodNullable<z.ZodString>;
+        address_2: z.ZodNullable<z.ZodString>;
+        postal_code: z.ZodNullable<z.ZodString>;
+        city: z.ZodNullable<z.ZodString>;
+        country_code: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchCustomersOutputSchema: z.ZodObject<{
+    customers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        first_name: z.ZodNullable<z.ZodString>;
+        last_name: z.ZodNullable<z.ZodString>;
+        company_name: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        has_account: z.ZodBoolean;
+        addresses: z.ZodArray<z.ZodObject<{
+            first_name: z.ZodNullable<z.ZodString>;
+            last_name: z.ZodNullable<z.ZodString>;
+            company: z.ZodNullable<z.ZodString>;
+            address_1: z.ZodNullable<z.ZodString>;
+            address_2: z.ZodNullable<z.ZodString>;
+            postal_code: z.ZodNullable<z.ZodString>;
+            city: z.ZodNullable<z.ZodString>;
+            country_code: z.ZodNullable<z.ZodString>;
+            phone: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchProductsInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    country_code: z.ZodString;
+}, z.core.$strict>;
+export declare const OrderAssistantVariantSchema: z.ZodObject<{
+    variant_id: z.ZodString;
+    product_title: z.ZodString;
+    variant_title: z.ZodNullable<z.ZodString>;
+    sku: z.ZodNullable<z.ZodString>;
+    unit_price: z.ZodNullable<z.ZodNumber>;
+    currency_code: z.ZodString;
+    available_quantity: z.ZodNullable<z.ZodNumber>;
+    orderable: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const SearchProductsOutputSchema: z.ZodObject<{
+    variants: z.ZodArray<z.ZodObject<{
+        variant_id: z.ZodString;
+        product_title: z.ZodString;
+        variant_title: z.ZodNullable<z.ZodString>;
+        sku: z.ZodNullable<z.ZodString>;
+        unit_price: z.ZodNullable<z.ZodNumber>;
+        currency_code: z.ZodString;
+        available_quantity: z.ZodNullable<z.ZodNumber>;
+        orderable: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ListShippingOptionsInputSchema: z.ZodObject<{
+    country_code: z.ZodString;
+}, z.core.$strict>;
+export declare const OrderAssistantShippingOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    amount: z.ZodNullable<z.ZodNumber>;
+    currency_code: z.ZodString;
+}, z.core.$strip>;
+export declare const ListShippingOptionsOutputSchema: z.ZodObject<{
+    shipping_options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        amount: z.ZodNullable<z.ZodNumber>;
+        currency_code: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const OrderAssistantNewCustomerSchema: z.ZodObject<{
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    company_name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CreateDraftOrderInputSchema: z.ZodObject<{
+    customer_id: z.ZodOptional<z.ZodString>;
+    new_customer: z.ZodOptional<z.ZodObject<{
+        first_name: z.ZodString;
+        last_name: z.ZodString;
+        company_name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    shipping_address: z.ZodObject<{
+        first_name: z.ZodString;
+        last_name: z.ZodString;
+        company: z.ZodOptional<z.ZodString>;
+        address_1: z.ZodString;
+        address_2: z.ZodOptional<z.ZodString>;
+        postal_code: z.ZodString;
+        city: z.ZodString;
+        country_code: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    billing_address: z.ZodOptional<z.ZodObject<{
+        first_name: z.ZodString;
+        last_name: z.ZodString;
+        company: z.ZodOptional<z.ZodString>;
+        address_1: z.ZodString;
+        address_2: z.ZodOptional<z.ZodString>;
+        postal_code: z.ZodString;
+        city: z.ZodString;
+        country_code: z.ZodString;
+        phone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    items: z.ZodArray<z.ZodObject<{
+        variant_id: z.ZodString;
+        quantity: z.ZodNumber;
+    }, z.core.$strict>>;
+    shipping_option_id: z.ZodString;
+    source: z.ZodEnum<{
+        fax: "fax";
+        telefon: "telefon";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const OrderAssistantDraftItemSchema: z.ZodObject<{
+    title: z.ZodString;
+    sku: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    unit_price: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CreateDraftOrderOutputSchema: z.ZodObject<{
+    draft_order_id: z.ZodString;
+    display_id: z.ZodNullable<z.ZodNumber>;
+    customer_id: z.ZodString;
+    customer_created: z.ZodBoolean;
+    currency_code: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        sku: z.ZodNullable<z.ZodString>;
+        quantity: z.ZodNumber;
+        unit_price: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    shipping_total: z.ZodNumber;
+    tax_total: z.ZodNumber;
+    total: z.ZodNumber;
+    admin_path: z.ZodString;
+}, z.core.$strip>;

package/dist/order-assistant/schemas.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateDraftOrderOutputSchema = exports.OrderAssistantDraftItemSchema = exports.CreateDraftOrderInputSchema = exports.OrderAssistantNewCustomerSchema = exports.ListShippingOptionsOutputSchema = exports.OrderAssistantShippingOptionSchema = exports.ListShippingOptionsInputSchema = exports.SearchProductsOutputSchema = exports.OrderAssistantVariantSchema = exports.SearchProductsInputSchema = exports.SearchCustomersOutputSchema = exports.OrderAssistantCustomerSchema = exports.OrderAssistantCustomerAddressSchema = exports.SearchCustomersInputSchema = exports.OrderAssistantAddressSchema = exports.ORDER_ASSISTANT_LIMITS = exports.ORDER_ASSISTANT_METADATA = exports.OrderAssistantSourceSchema = exports.ORDER_ASSISTANT_TOOLS = exports.ORDER_ASSISTANT_PLUGIN_KEY = void 0;
+const zod_1 = require("@medusajs/framework/zod");
+const primitives_1 = require("../shared/primitives");
+/** Plugin key and container key of the order assistant in the base. */
+exports.ORDER_ASSISTANT_PLUGIN_KEY = "order_assistant";
+/** Tool names as the MCP client sees them. */
+exports.ORDER_ASSISTANT_TOOLS = {
+    searchCustomers: "kunden_suchen",
+    searchProducts: "produkte_suchen",
+    listShippingOptions: "versandarten_auflisten",
+    createDraftOrder: "bestellentwurf_anlegen",
+};
+/** How the order reached the shop; stored in the order metadata. */
+exports.OrderAssistantSourceSchema = zod_1.z.enum(["fax", "telefon"]);
+/** Order metadata keys the assistant writes. */
+exports.ORDER_ASSISTANT_METADATA = {
+    source: "order_source",
+    note: "order_note",
+};
+exports.ORDER_ASSISTANT_LIMITS = {
+    customers: 10,
+    variants: 20,
+    items: 50,
+    noteLength: 2000,
+};
+const CountryCodeSchema = zod_1.z
+    .string()
+    .trim()
+    .toLowerCase()
+    .regex(/^[a-z]{2}$/)
+    .describe("Land als ISO-3166-1-alpha-2-Code, z. B. at oder de.");
+const OptionalTextSchema = zod_1.z.string().trim().min(1).max(255).optional();
+exports.OrderAssistantAddressSchema = zod_1.z
+    .object({
+    first_name: primitives_1.NonEmptyStringSchema.max(255),
+    last_name: primitives_1.NonEmptyStringSchema.max(255),
+    company: OptionalTextSchema.describe("Firma oder Praxis, falls angegeben."),
+    address_1: primitives_1.NonEmptyStringSchema.max(255).describe("Straße und Hausnummer."),
+    address_2: OptionalTextSchema.describe("Adresszusatz."),
+    postal_code: primitives_1.NonEmptyStringSchema.max(20),
+    city: primitives_1.NonEmptyStringSchema.max(255),
+    country_code: CountryCodeSchema,
+    phone: OptionalTextSchema,
+})
+    .strict();
+exports.SearchCustomersInputSchema = zod_1.z
+    .object({
+    query: OptionalTextSchema.describe("Name, Firma, Telefonnummer oder E-Mail-Adresse (auch Teile davon)."),
+    postal_code: OptionalTextSchema.describe("PLZ einer Adresse der Person."),
+    city: OptionalTextSchema.describe("Ort einer Adresse der Person."),
+})
+    .strict()
+    .refine((value) => Boolean(value.query ?? value.postal_code ?? value.city), { message: "Mindestens ein Suchfeld ist nötig." });
+exports.OrderAssistantCustomerAddressSchema = zod_1.z.object({
+    first_name: zod_1.z.string().nullable(),
+    last_name: zod_1.z.string().nullable(),
+    company: zod_1.z.string().nullable(),
+    address_1: zod_1.z.string().nullable(),
+    address_2: zod_1.z.string().nullable(),
+    postal_code: zod_1.z.string().nullable(),
+    city: zod_1.z.string().nullable(),
+    country_code: zod_1.z.string().nullable(),
+    phone: zod_1.z.string().nullable(),
+});
+exports.OrderAssistantCustomerSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    first_name: zod_1.z.string().nullable(),
+    last_name: zod_1.z.string().nullable(),
+    company_name: zod_1.z.string().nullable(),
+    email: zod_1.z.string().nullable(),
+    phone: zod_1.z.string().nullable(),
+    /** Registered shop account (true) or a customer record without login. */
+    has_account: zod_1.z.boolean(),
+    addresses: zod_1.z.array(exports.OrderAssistantCustomerAddressSchema),
+});
+exports.SearchCustomersOutputSchema = zod_1.z.object({
+    customers: zod_1.z.array(exports.OrderAssistantCustomerSchema),
+});
+exports.SearchProductsInputSchema = zod_1.z
+    .object({
+    query: primitives_1.NonEmptyStringSchema.max(255).describe("Produktname oder Artikelnummer (auch Teile davon)."),
+    country_code: CountryCodeSchema.describe("Lieferland als ISO-Code; bestimmt Preis und Währung."),
+})
+    .strict();
+exports.OrderAssistantVariantSchema = zod_1.z.object({
+    variant_id: zod_1.z.string(),
+    product_title: zod_1.z.string(),
+    variant_title: zod_1.z.string().nullable(),
+    sku: zod_1.z.string().nullable(),
+    /** Price per unit in major currency units (33.5 = 33,50); null without a price. */
+    unit_price: zod_1.z.number().nullable(),
+    currency_code: zod_1.z.string(),
+    /** Available quantity; null when the variant's stock is not managed. */
+    available_quantity: zod_1.z.number().nullable(),
+    /** False when the variant cannot be ordered (no price or no stock). */
+    orderable: zod_1.z.boolean(),
+});
+exports.SearchProductsOutputSchema = zod_1.z.object({
+    variants: zod_1.z.array(exports.OrderAssistantVariantSchema),
+});
+exports.ListShippingOptionsInputSchema = zod_1.z
+    .object({
+    country_code: CountryCodeSchema.describe("Lieferland als ISO-Code."),
+})
+    .strict();
+exports.OrderAssistantShippingOptionSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    /** Flat price in major currency units; null when none is set for the currency. */
+    amount: zod_1.z.number().nullable(),
+    currency_code: zod_1.z.string(),
+});
+exports.ListShippingOptionsOutputSchema = zod_1.z.object({
+    shipping_options: zod_1.z.array(exports.OrderAssistantShippingOptionSchema),
+});
+exports.OrderAssistantNewCustomerSchema = zod_1.z
+    .object({
+    first_name: primitives_1.NonEmptyStringSchema.max(255),
+    last_name: primitives_1.NonEmptyStringSchema.max(255),
+    company_name: OptionalTextSchema,
+    email: zod_1.z
+        .string()
+        .trim()
+        .toLowerCase()
+        .email()
+        .max(255)
+        .optional()
+        .describe("Nur angeben, wenn eine E-Mail-Adresse bekannt ist."),
+    phone: OptionalTextSchema,
+})
+    .strict();
+exports.CreateDraftOrderInputSchema = zod_1.z
+    .object({
+    customer_id: zod_1.z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe("ID einer bestehenden Kund:in aus kunden_suchen."),
+    new_customer: exports.OrderAssistantNewCustomerSchema.optional().describe("Neue Kund:in ohne Konto; nur wenn kunden_suchen niemanden findet."),
+    shipping_address: exports.OrderAssistantAddressSchema,
+    billing_address: exports.OrderAssistantAddressSchema.optional().describe("Rechnungsadresse; ohne Angabe gilt die Lieferadresse."),
+    items: zod_1.z
+        .array(zod_1.z
+        .object({
+        variant_id: primitives_1.NonEmptyStringSchema.describe("ID der Variante aus produkte_suchen."),
+        quantity: zod_1.z.number().int().positive().max(9999),
+    })
+        .strict())
+        .min(1)
+        .max(exports.ORDER_ASSISTANT_LIMITS.items),
+    shipping_option_id: primitives_1.NonEmptyStringSchema.describe("ID der Versandart aus versandarten_auflisten."),
+    source: exports.OrderAssistantSourceSchema.describe("Wie die Bestellung eingegangen ist."),
+    note: zod_1.z
+        .string()
+        .trim()
+        .min(1)
+        .max(exports.ORDER_ASSISTANT_LIMITS.noteLength)
+        .optional()
+        .describe("Interne Notiz, z. B. Unklarheiten auf dem Fax."),
+})
+    .strict()
+    .refine((value) => Boolean(value.customer_id) !== Boolean(value.new_customer), { message: "Genau eines von customer_id und new_customer ist nötig." });
+exports.OrderAssistantDraftItemSchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    sku: zod_1.z.string().nullable(),
+    quantity: zod_1.z.number(),
+    unit_price: zod_1.z.number(),
+    total: zod_1.z.number(),
+});
+exports.CreateDraftOrderOutputSchema = zod_1.z.object({
+    draft_order_id: zod_1.z.string(),
+    display_id: zod_1.z.number().nullable(),
+    customer_id: zod_1.z.string(),
+    /** True when the assistant created the customer record for this draft. */
+    customer_created: zod_1.z.boolean(),
+    currency_code: zod_1.z.string(),
+    items: zod_1.z.array(exports.OrderAssistantDraftItemSchema),
+    shipping_total: zod_1.z.number(),
+    tax_total: zod_1.z.number(),
+    total: zod_1.z.number(),
+    /** Path of the draft in the Admin, relative to the backend URL. */
+    admin_path: zod_1.z.string(),
+});

package/dist/order-assistant/types.d.ts

@@ -0,0 +1,15 @@
+import type { z } from "@medusajs/framework/zod";
+import type { CreateDraftOrderInputSchema, CreateDraftOrderOutputSchema, ListShippingOptionsInputSchema, ListShippingOptionsOutputSchema, OrderAssistantAddressSchema, OrderAssistantCustomerSchema, OrderAssistantShippingOptionSchema, OrderAssistantSourceSchema, OrderAssistantVariantSchema, SearchCustomersInputSchema, SearchCustomersOutputSchema, SearchProductsInputSchema, SearchProductsOutputSchema } from "./schemas";
+export type OrderAssistantSource = z.infer<typeof OrderAssistantSourceSchema>;
+export type OrderAssistantAddress = z.infer<typeof OrderAssistantAddressSchema>;
+export type OrderAssistantCustomer = z.infer<typeof OrderAssistantCustomerSchema>;
+export type OrderAssistantVariant = z.infer<typeof OrderAssistantVariantSchema>;
+export type OrderAssistantShippingOption = z.infer<typeof OrderAssistantShippingOptionSchema>;
+export type SearchCustomersInput = z.infer<typeof SearchCustomersInputSchema>;
+export type SearchCustomersOutput = z.infer<typeof SearchCustomersOutputSchema>;
+export type SearchProductsInput = z.infer<typeof SearchProductsInputSchema>;
+export type SearchProductsOutput = z.infer<typeof SearchProductsOutputSchema>;
+export type ListShippingOptionsInput = z.infer<typeof ListShippingOptionsInputSchema>;
+export type ListShippingOptionsOutput = z.infer<typeof ListShippingOptionsOutputSchema>;
+export type CreateDraftOrderInput = z.infer<typeof CreateDraftOrderInputSchema>;
+export type CreateDraftOrderOutput = z.infer<typeof CreateDraftOrderOutputSchema>;

package/dist/order-assistant/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hartl-services/medusa-contracts",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "private": false,
   "sideEffects": false,
   "files": [
@@ -51,6 +51,11 @@
       "import": "./dist/esm/documents/admin-types.mjs",
       "require": "./dist/documents/admin-types.js"
     },
+    "./types/order-assistant": {
+      "types": "./dist/order-assistant/types.d.ts",
+      "import": "./dist/esm/order-assistant/types.mjs",
+      "require": "./dist/order-assistant/types.js"
+    },
     "./types/files": {
       "types": "./dist/files/types.d.ts",
       "import": "./dist/esm/files/types.mjs",
@@ -106,6 +111,11 @@
       "import": "./dist/esm/documents/schemas.mjs",
       "require": "./dist/documents/schemas.js"
     },
+    "./schemas/order-assistant": {
+      "types": "./dist/order-assistant/schemas.d.ts",
+      "import": "./dist/esm/order-assistant/schemas.mjs",
+      "require": "./dist/order-assistant/schemas.js"
+    },
     "./schemas/files": {
       "types": "./dist/files/schemas.d.ts",
       "import": "./dist/esm/files/schemas.mjs",
@@ -161,6 +171,11 @@
       "import": "./dist/esm/documents/paths.mjs",
       "require": "./dist/documents/paths.js"
     },
+    "./paths/order-assistant": {
+      "types": "./dist/order-assistant/paths.d.ts",
+      "import": "./dist/esm/order-assistant/paths.mjs",
+      "require": "./dist/order-assistant/paths.js"
+    },
     "./paths/files": {
       "types": "./dist/files/paths.d.ts",
       "import": "./dist/esm/files/paths.mjs",