@vitrine-kit/contracts 1.2.2 → 1.3.0

package/dist/index.cjs

@@ -240,6 +240,11 @@ var themeSchema = import_zod3.z.object({
 var siteConfigSchema = import_zod3.z.object({
   backend: backendSchema,
   tier: tierSchema,
+  /**
+   * Storefront display name (header, metadata, footer). Set by `vitrine init`
+   * from the project name; optional for older clients.
+   */
+  name: import_zod3.z.string().min(1).optional(),
   /** Feature flags: { 'reviews': true }. Set by the install primitive. */
   features: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.boolean()).default({}),
   layout: import_zod3.z.object({ sections: import_zod3.z.array(layoutSectionSchema).default([]) }).default({ sections: [] }),

package/dist/index.d.cts

@@ -109,6 +109,15 @@ interface ProductQuery {
     perPage?: number;
     /** Filter facets: { color: ['red','blue'], size: ['M'] }. */
     filters?: Record<string, string[]>;
+    /** Inclusive lower bound on variant/list price (minor units, e.g. cents). */
+    priceMin?: number;
+    /** Inclusive upper bound on variant/list price (minor units, e.g. cents). */
+    priceMax?: number;
+    /**
+     * CMS / storefront locale (path cookie or explicit). Adapters that support
+     * localized fields pass this through to the backend; others ignore it.
+     */
+    locale?: string;
 }
 interface CartLine {
     id: string;
@@ -156,9 +165,10 @@ interface Order {
  */
 interface CatalogSource {
     listProducts(query: ProductQuery): Promise<Product[]>;
-    getProduct(slug: string): Promise<Product | null>;
-    listCategories(): Promise<Category[]>;
-    search(term: string): Promise<Product[]>;
+    /** Optional locale selects localized CMS fields when the backend supports them. */
+    getProduct(slug: string, locale?: string): Promise<Product | null>;
+    listCategories(locale?: string): Promise<Category[]>;
+    search(term: string, locale?: string): Promise<Product[]>;
 }
 /**
  * Commerce backend. Only simple-store / full-store.
@@ -278,6 +288,11 @@ declare const themeSchema: z.ZodDefault<z.ZodObject<{
 declare const siteConfigSchema: z.ZodObject<{
     backend: z.ZodEnum<["payload", "vendure"]>;
     tier: z.ZodEnum<["catalog", "simple-store", "full-store"]>;
+    /**
+     * Storefront display name (header, metadata, footer). Set by `vitrine init`
+     * from the project name; optional for older clients.
+     */
+    name: z.ZodOptional<z.ZodString>;
     /** Feature flags: { 'reviews': true }. Set by the install primitive. */
     features: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     layout: z.ZodDefault<z.ZodObject<{
@@ -382,9 +397,11 @@ declare const siteConfigSchema: z.ZodObject<{
         currency: string;
         priceFormat?: string | undefined;
     };
+    name?: string | undefined;
 }, {
     backend: "payload" | "vendure";
     tier: "catalog" | "simple-store" | "full-store";
+    name?: string | undefined;
     features?: Record<string, boolean> | undefined;
     layout?: {
         sections?: {

package/dist/index.d.ts

@@ -109,6 +109,15 @@ interface ProductQuery {
     perPage?: number;
     /** Filter facets: { color: ['red','blue'], size: ['M'] }. */
     filters?: Record<string, string[]>;
+    /** Inclusive lower bound on variant/list price (minor units, e.g. cents). */
+    priceMin?: number;
+    /** Inclusive upper bound on variant/list price (minor units, e.g. cents). */
+    priceMax?: number;
+    /**
+     * CMS / storefront locale (path cookie or explicit). Adapters that support
+     * localized fields pass this through to the backend; others ignore it.
+     */
+    locale?: string;
 }
 interface CartLine {
     id: string;
@@ -156,9 +165,10 @@ interface Order {
  */
 interface CatalogSource {
     listProducts(query: ProductQuery): Promise<Product[]>;
-    getProduct(slug: string): Promise<Product | null>;
-    listCategories(): Promise<Category[]>;
-    search(term: string): Promise<Product[]>;
+    /** Optional locale selects localized CMS fields when the backend supports them. */
+    getProduct(slug: string, locale?: string): Promise<Product | null>;
+    listCategories(locale?: string): Promise<Category[]>;
+    search(term: string, locale?: string): Promise<Product[]>;
 }
 /**
  * Commerce backend. Only simple-store / full-store.
@@ -278,6 +288,11 @@ declare const themeSchema: z.ZodDefault<z.ZodObject<{
 declare const siteConfigSchema: z.ZodObject<{
     backend: z.ZodEnum<["payload", "vendure"]>;
     tier: z.ZodEnum<["catalog", "simple-store", "full-store"]>;
+    /**
+     * Storefront display name (header, metadata, footer). Set by `vitrine init`
+     * from the project name; optional for older clients.
+     */
+    name: z.ZodOptional<z.ZodString>;
     /** Feature flags: { 'reviews': true }. Set by the install primitive. */
     features: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     layout: z.ZodDefault<z.ZodObject<{
@@ -382,9 +397,11 @@ declare const siteConfigSchema: z.ZodObject<{
         currency: string;
         priceFormat?: string | undefined;
     };
+    name?: string | undefined;
 }, {
     backend: "payload" | "vendure";
     tier: "catalog" | "simple-store" | "full-store";
+    name?: string | undefined;
     features?: Record<string, boolean> | undefined;
     layout?: {
         sections?: {

package/dist/index.js

@@ -179,6 +179,11 @@ var themeSchema = z3.object({
 var siteConfigSchema = z3.object({
   backend: backendSchema,
   tier: tierSchema,
+  /**
+   * Storefront display name (header, metadata, footer). Set by `vitrine init`
+   * from the project name; optional for older clients.
+   */
+  name: z3.string().min(1).optional(),
   /** Feature flags: { 'reviews': true }. Set by the install primitive. */
   features: z3.record(z3.string(), z3.boolean()).default({}),
   layout: z3.object({ sections: z3.array(layoutSectionSchema).default([]) }).default({ sections: [] }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitrine-kit/contracts",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Vitrine — the five stable contracts: Tokens, Data, Slots, Config, Blueprint.",
   "license": "MIT",
   "type": "module",