@revealui/contracts 1.0.0

package/dist/entities/product.d.ts

@@ -0,0 +1,753 @@
+/**
+ * Product Schema
+ *
+ * Products represent Stripe-backed product information with associated pricing.
+ * They support content management and integrate with RevealUI's CMS.
+ *
+ * This schema provides:
+ * - Stripe product validation (prod_xxx format)
+ * - Stripe product data structure validation
+ * - Business rules (published products require valid Stripe data)
+ * - Type-safe relationship handling
+ * - Runtime validation with Zod
+ */
+import { z } from 'zod/v4';
+export declare const PRODUCT_SCHEMA_VERSION = 1;
+/**
+ * Stripe Product ID format: prod_xxxxx
+ * @example "prod_MowQVLkdIwHu7ixraBm864M"
+ */
+export declare const StripeProductIDSchema: z.ZodString;
+export type StripeProductID = z.infer<typeof StripeProductIDSchema>;
+/**
+ * Stripe Product object structure (subset of fields from Stripe API)
+ * Stored as JSON in product metadata
+ */
+export declare const StripeProductDataSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"product">;
+    active: z.ZodBoolean;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    default_price: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shippable: z.ZodOptional<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type StripeProductData = z.infer<typeof StripeProductDataSchema>;
+/**
+ * Stripe Price List (stored in priceJSON)
+ */
+export declare const StripePriceListSchema: z.ZodObject<{
+    object: z.ZodLiteral<"list">;
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        object: z.ZodLiteral<"price">;
+        active: z.ZodOptional<z.ZodBoolean>;
+        currency: z.ZodString;
+        unit_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            one_time: "one_time";
+            recurring: "recurring";
+        }>>;
+        recurring: z.ZodOptional<z.ZodObject<{
+            interval: z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+                year: "year";
+            }>;
+            interval_count: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    has_more: z.ZodBoolean;
+}, z.core.$strip>;
+export type StripePriceList = z.infer<typeof StripePriceListSchema>;
+export declare const ProductStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+}>;
+export type ProductStatus = z.infer<typeof ProductStatusSchema>;
+declare const ProductBaseSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodNumber;
+    title: z.ZodString;
+    publishedOn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layout: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    stripeProductID: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceJSON: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<unknown, string | null | undefined>>, z.ZodNullable<z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"price">;
+            active: z.ZodOptional<z.ZodBoolean>;
+            currency: z.ZodString;
+            unit_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            type: z.ZodOptional<z.ZodEnum<{
+                one_time: "one_time";
+                recurring: "recurring";
+            }>>;
+            recurring: z.ZodOptional<z.ZodObject<{
+                interval: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    year: "year";
+                }>;
+                interval_count: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        has_more: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    enablePaywall: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paywall: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{}, z.core.$loose>]>>>>;
+    relatedProducts: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{}, z.core.$loose>]>>>>;
+    skipSync: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    updatedAt: z.ZodString;
+    createdAt: z.ZodString;
+    _status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>>;
+}, z.core.$strip>;
+export type Product = z.infer<typeof ProductBaseSchema>;
+/** Main schema export */
+export declare const ProductSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodNumber;
+    title: z.ZodString;
+    publishedOn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layout: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    stripeProductID: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceJSON: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<unknown, string | null | undefined>>, z.ZodNullable<z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"price">;
+            active: z.ZodOptional<z.ZodBoolean>;
+            currency: z.ZodString;
+            unit_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            type: z.ZodOptional<z.ZodEnum<{
+                one_time: "one_time";
+                recurring: "recurring";
+            }>>;
+            recurring: z.ZodOptional<z.ZodObject<{
+                interval: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    year: "year";
+                }>;
+                interval_count: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        has_more: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    enablePaywall: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paywall: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{}, z.core.$loose>]>>>>;
+    relatedProducts: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{}, z.core.$loose>]>>>>;
+    skipSync: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    updatedAt: z.ZodString;
+    createdAt: z.ZodString;
+    _status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>>;
+}, z.core.$strip>;
+export declare const CreateProductInputSchema: z.ZodObject<{
+    title: z.ZodString;
+    stripeProductID: z.ZodOptional<z.ZodString>;
+    enablePaywall: z.ZodOptional<z.ZodBoolean>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    relatedProducts: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    _status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>;
+}, z.core.$strip>;
+export type CreateProductInput = z.infer<typeof CreateProductInputSchema>;
+export declare const UpdateProductInputSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    stripeProductID: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    enablePaywall: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    categories: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+    relatedProducts: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+    _status: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>>;
+}, z.core.$strip>;
+export type UpdateProductInput = z.infer<typeof UpdateProductInputSchema>;
+/**
+ * Product with categories populated
+ */
+export declare const ProductWithCategoriesSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodNumber;
+    title: z.ZodString;
+    publishedOn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layout: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    stripeProductID: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceJSON: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<unknown, string | null | undefined>>, z.ZodNullable<z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"price">;
+            active: z.ZodOptional<z.ZodBoolean>;
+            currency: z.ZodString;
+            unit_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            type: z.ZodOptional<z.ZodEnum<{
+                one_time: "one_time";
+                recurring: "recurring";
+            }>>;
+            recurring: z.ZodOptional<z.ZodObject<{
+                interval: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    year: "year";
+                }>;
+                interval_count: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        has_more: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    enablePaywall: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paywall: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    relatedProducts: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{}, z.core.$loose>]>>>>;
+    skipSync: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    updatedAt: z.ZodString;
+    createdAt: z.ZodString;
+    _status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>>;
+    categories: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$strip>;
+export type ProductWithCategories = z.infer<typeof ProductWithCategoriesSchema>;
+/**
+ * Product with all relationships populated
+ */
+export declare const ProductWithRelatedSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    human: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        preview: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        helpText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        semanticType: z.ZodString;
+        embedding: z.ZodOptional<z.ZodObject<{
+            model: z.ZodString;
+            vector: z.ZodArray<z.ZodNumber>;
+            dimension: z.ZodNumber;
+            generatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                custom: "custom";
+                readonly: "readonly";
+                pattern: "pattern";
+                required: "required";
+                immutable: "immutable";
+                range: "range";
+                dependency: "dependency";
+                capability: "capability";
+                permission: "permission";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodString;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            returns: z.ZodOptional<z.ZodObject<{
+                type: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sideEffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            destructive: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                dependency: "dependency";
+                parent: "parent";
+                child: "child";
+                sibling: "sibling";
+                reference: "reference";
+                related: "related";
+            }>;
+            targetId: z.ZodString;
+            targetType: z.ZodString;
+            weight: z.ZodDefault<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodNumber;
+    title: z.ZodString;
+    publishedOn: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layout: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    stripeProductID: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priceJSON: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<unknown, string | null | undefined>>, z.ZodNullable<z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            object: z.ZodLiteral<"price">;
+            active: z.ZodOptional<z.ZodBoolean>;
+            currency: z.ZodString;
+            unit_amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            type: z.ZodOptional<z.ZodEnum<{
+                one_time: "one_time";
+                recurring: "recurring";
+            }>>;
+            recurring: z.ZodOptional<z.ZodObject<{
+                interval: z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    year: "year";
+                }>;
+                interval_count: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        has_more: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    enablePaywall: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paywall: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        blockType: z.ZodString;
+        blockName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    skipSync: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    updatedAt: z.ZodString;
+    createdAt: z.ZodString;
+    _status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>>;
+    categories: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+    }, z.core.$loose>>>;
+    relatedProducts: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        title: z.ZodString;
+        stripeProductID: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ProductWithRelated = z.infer<typeof ProductWithRelatedSchema>;
+/**
+ * Check if product has a valid Stripe product configured
+ */
+export declare function hasStripeProduct(product: Product): product is Product & {
+    stripeProductID: string;
+};
+/**
+ * Check if product is published
+ */
+export declare function isPublishedProduct(product: Product): boolean;
+/**
+ * Check if product has prices
+ */
+export declare function hasProductPrices(product: Product): product is Product & {
+    priceJSON: StripePriceList;
+};
+/**
+ * Check if product has images
+ */
+export declare function hasProductImages(product: Product): boolean;
+/**
+ * Get available prices for a product
+ */
+export declare function getAvailablePrices(product: Product): StripePriceList['data'];
+/**
+ * Get price count for product
+ */
+export declare function getPriceCount(product: Product): number;
+/**
+ * Get price range for product (lowest to highest)
+ */
+export declare function getPriceRange(product: Product): {
+    min: number | null;
+    max: number | null;
+    currency: string | null;
+} | null;
+/**
+ * Get default price ID for product
+ */
+export declare function getDefaultPriceId(product: Product): string | null;
+/**
+ * Format price range for display
+ */
+export declare function formatPriceRange(product: Product): string | null;
+export declare const ProductContract: import("../index.js").Contract<{
+    version: number;
+    schemaVersion: number;
+    id: number;
+    title: string;
+    priceJSON: {
+        object: "list";
+        data: {
+            id: string;
+            object: "price";
+            currency: string;
+            active?: boolean | undefined;
+            unit_amount?: number | null | undefined;
+            type?: "one_time" | "recurring" | undefined;
+            recurring?: {
+                interval: "day" | "week" | "month" | "year";
+                interval_count: number;
+            } | undefined;
+        }[];
+        has_more: boolean;
+    } | null;
+    updatedAt: string;
+    createdAt: string;
+    human?: {
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        color?: string | undefined;
+        preview?: string | undefined;
+        suggestions?: string[] | undefined;
+        helpText?: string | undefined;
+    } | undefined;
+    agent?: {
+        semanticType: string;
+        embedding?: {
+            model: string;
+            vector: number[];
+            dimension: number;
+            generatedAt: string;
+        } | undefined;
+        constraints?: {
+            type: "custom" | "readonly" | "pattern" | "required" | "immutable" | "range" | "dependency" | "capability" | "permission";
+            params: Record<string, unknown>;
+            field?: string | undefined;
+            message?: string | undefined;
+        }[] | undefined;
+        actions?: {
+            name: string;
+            description: string;
+            params: Record<string, {
+                type: string;
+                required?: boolean | undefined;
+                description?: string | undefined;
+                default?: unknown;
+                enum?: string[] | undefined;
+            }>;
+            returns?: {
+                type: string;
+                description?: string | undefined;
+            } | undefined;
+            requiredCapabilities?: string[] | undefined;
+            sideEffects?: string[] | undefined;
+            destructive?: boolean | undefined;
+        }[] | undefined;
+        relations?: {
+            type: "dependency" | "parent" | "child" | "sibling" | "reference" | "related";
+            targetId: string;
+            targetType: string;
+            weight: number;
+            metadata?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        keywords?: string[] | undefined;
+        priority?: number | undefined;
+    } | undefined;
+    publishedOn?: string | null | undefined;
+    layout?: {
+        [x: string]: unknown;
+        blockType: string;
+        blockName?: string | undefined;
+    }[] | null | undefined;
+    stripeProductID?: string | null | undefined;
+    enablePaywall?: boolean | null | undefined;
+    paywall?: {
+        [x: string]: unknown;
+        blockType: string;
+        blockName?: string | undefined;
+    }[] | null | undefined;
+    categories?: (number | {
+        [x: string]: unknown;
+    })[] | null | undefined;
+    relatedProducts?: (number | {
+        [x: string]: unknown;
+    })[] | null | undefined;
+    skipSync?: boolean | null | undefined;
+    _status?: "draft" | "published" | null | undefined;
+}>;
+export declare const CreateProductContract: import("../index.js").Contract<{
+    title: string;
+    stripeProductID?: string | undefined;
+    enablePaywall?: boolean | undefined;
+    categories?: number[] | undefined;
+    relatedProducts?: number[] | undefined;
+    _status?: "draft" | "published" | undefined;
+}>;
+export declare const UpdateProductContract: import("../index.js").Contract<{
+    title?: string | undefined;
+    stripeProductID?: string | undefined;
+    enablePaywall?: boolean | undefined;
+    categories?: number[] | undefined;
+    relatedProducts?: number[] | undefined;
+    _status?: "draft" | "published" | undefined;
+}>;
+export {};
+//# sourceMappingURL=product.d.ts.map