@marianmeres/collection-types 1.31.0 → 1.32.0

package/dist/country.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Country type definitions for geographic reference data.
+ *
+ * Countries are stored in the project domain and referenced
+ * via weak relations from customer addresses.
+ */
+import type { MaybeLocalized } from "./utils.js";
+/** Country data field schema */
+export interface CountryData {
+    /** ISO 3166-1 alpha-2 code (e.g., "US", "GB") - used as path for uniqueness */
+    code: string;
+    /** Display name - can be a plain string or localized object (e.g., { en: "United States", de: "Vereinigte Staaten" }) */
+    name: MaybeLocalized<string>;
+    /** Phone prefix with + (e.g., "+1", "+44") */
+    phone_prefix?: string;
+    /** Flag emoji (e.g., "🇺🇸") */
+    flag?: string;
+    /** Extensible metadata for future fields */
+    custom?: Record<string, unknown>;
+    /** Index signature for Model<T> compatibility */
+    [key: string]: unknown;
+}
+/** Country type identifier */
+export type CountryType = "default";

package/dist/country.js

@@ -0,0 +1,7 @@
+/**
+ * Country type definitions for geographic reference data.
+ *
+ * Countries are stored in the project domain and referenced
+ * via weak relations from customer addresses.
+ */
+export {};

package/dist/customer.d.ts

@@ -13,14 +13,25 @@
 export interface CustomerData {
     /** Customer email */
     email: string;
-    /** Customer display name */
-    name: string;
+    /** Customer first name */
+    first_name: string;
+    /** Customer last name */
+    last_name: string;
     /** Phone number */
     phone?: string;
     /** True if customer has no linked account */
     guest: boolean;
     /** Marketing consent */
     accepts_marketing: boolean;
+    /** Company name for B2B customers */
+    company_name?: string;
+    /** Tax identification number */
+    tax_id?: string;
+    /** VAT number for EU businesses */
+    vat_number?: string;
+    /** Project-specific customer preferences */
+    custom?: Record<string, unknown>;
+    addresses?: never;
     /** Index signature for compatibility with UserData */
     [key: string]: unknown;
 }
@@ -36,12 +47,14 @@ export interface AddressData {
     city: string;
     /** Postal/ZIP code */
     postal_code: string;
-    /** Country code or name */
+    /** Country code or name (legacy/fallback) */
     country: string;
     /** Contact phone */
     phone?: string;
     /** Whether this is the default address for its type */
     is_default: boolean;
+    /** Country relation (UI-only, stored in relations table) */
+    country_rel?: never;
     /** Index signature for compatibility with UserData */
     [key: string]: unknown;
 }

package/dist/mod.d.ts

@@ -43,6 +43,7 @@ export * from "./external-domain.js";
 export * from "./account.js";
 export * from "./product.js";
 export * from "./project.js";
+export * from "./country.js";
 export * from "./template.js";
 export * from "./email.js";
 export * from "./example.js";

package/dist/mod.js

@@ -55,6 +55,8 @@ export * from "./account.js";
 export * from "./product.js";
 // Project/config domain types
 export * from "./project.js";
+// Country domain types (geographic reference data)
+export * from "./country.js";
 // Template domain types
 export * from "./template.js";
 // Email domain types

package/dist/order.d.ts

@@ -13,6 +13,8 @@ import type { AddressData } from "./customer.js";
 import type { UUID } from "./utils.js";
 /** Order status progression */
 export type OrderStatus = "pending" | "paid" | "processing" | "shipped" | "delivered" | "cancelled";
+/** Checkout stages for tracking progress */
+export type CheckoutStage = "cart" | "addresses" | "delivery" | "confirm" | "payment" | "complete";
 /** Single order line item (snapshot at purchase time) */
 export interface OrderLineItem {
     /** Product model_id for reference */
@@ -39,6 +41,13 @@ export interface OrderTotals {
     /** Final total */
     total: number;
 }
+/** Delivery option snapshot at checkout time */
+export interface DeliveryOptionSnapshot {
+    id: string;
+    name: string;
+    price: number;
+    estimated_time?: string;
+}
 /** Order data field schema */
 export interface OrderData {
     /** Current order status */
@@ -55,6 +64,14 @@ export interface OrderData {
     billing_address: AddressData;
     /** Order notes */
     notes?: string;
+    /** Selected delivery option ID */
+    delivery_option_id?: string;
+    /** Delivery option snapshot at checkout time */
+    delivery_option?: DeliveryOptionSnapshot;
+    /** Customer email (for tracking, especially guest checkout) */
+    customer_email?: string;
+    /** Current checkout stage */
+    checkout_stage?: CheckoutStage;
     /** Index signature for compatibility with UserData */
     [key: string]: unknown;
 }

package/dist/project.d.ts

@@ -37,3 +37,33 @@ export interface ConfigDataRbac extends ConfigDataDefault {
 }
 /** Union of all config data types */
 export type ConfigData = ConfigDataDefault | ConfigDataRbac;
+/** Single delivery option */
+export interface DeliveryOption {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description shown to customer */
+    description?: string;
+    /** Base price in cents */
+    price: number;
+    /** Estimated delivery time (e.g., "2-3 business days") */
+    estimated_time?: string;
+    /** Whether this option is currently available */
+    is_active: boolean;
+    /** Sort order for display */
+    sort_order: number;
+    /** Optional: minimum order amount for this option (in cents) */
+    min_order_amount?: number;
+    /** Optional: free shipping threshold (in cents) */
+    free_above?: number;
+}
+/** Delivery options configuration (stored in project config) */
+export interface DeliveryOptionsConfig {
+    /** Default currency for prices */
+    currency: string;
+    /** Available delivery options */
+    options: DeliveryOption[];
+    /** Default option ID when none selected */
+    default_option_id?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@marianmeres/collection-types",
-	"version": "1.31.0",
+	"version": "1.32.0",
 	"type": "module",
 	"main": "dist/mod.js",
 	"types": "dist/mod.d.ts",