@happyvertical/smrt-products 0.51.32 → 0.51.33

package/dist/lib/lib/collections/CategoryCollection.d.ts

@@ -1,3 +1,6 @@
+/**
+ * CategoryCollection — Collection manager for {@link Category} objects.
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Category } from '../models/Category';
 export declare class CategoryCollection extends SmrtCollection<Category> {

package/dist/lib/lib/collections/MaterialCollection.d.ts

@@ -1,5 +1,11 @@
+/**
+ * MaterialCollection — Collection manager for {@link Material} objects.
+ *
+ * STI framework auto-filters by `_meta_type` to return only Material rows
+ * from the shared `products` table.
+ */
 import { Material } from '../models/Material';
-import { MaterialKind } from '../models/types';
+import type { MaterialKind } from '../models/types';
 import { ProductCollection } from './ProductCollection';
 export declare class MaterialCollection extends ProductCollection {
     static readonly _itemClass: typeof Material;

package/dist/lib/lib/collections/ProductAssetCollection.d.ts

@@ -1,5 +1,6 @@
-import { Asset } from '@happyvertical/smrt-assets';
-import { SmrtCollectionOptions, SmrtJunction } from '@happyvertical/smrt-core';
+import type { Asset } from '@happyvertical/smrt-assets';
+import type { SmrtCollectionOptions } from '@happyvertical/smrt-core';
+import { SmrtJunction } from '@happyvertical/smrt-core';
 import { ProductAsset } from '../models/ProductAsset';
 export interface ProductAssetCollectionOptions extends SmrtCollectionOptions {
 }

package/dist/lib/lib/collections/ProductCollection.d.ts

@@ -1,4 +1,4 @@
-import { Asset } from '@happyvertical/smrt-assets';
+import type { Asset } from '@happyvertical/smrt-assets';
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Product } from '../models/Product';
 export declare class ProductCollection extends SmrtCollection<Product> {

package/dist/lib/lib/collections/ProductVariantCollection.d.ts

@@ -1,3 +1,11 @@
+/**
+ * ProductVariantCollection — read helpers for {@link ProductVariant} rows.
+ *
+ * {@link ProductVariant} is a standalone model (not a Product STI subtype),
+ * so this collection drives its own table (`product_variants`). Helper
+ * methods cover the two common query patterns: "what axes does this
+ * product vary along?" and "tell me about the size axis specifically."
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { ProductVariant } from '../models/ProductVariant';
 export declare class ProductVariantCollection extends SmrtCollection<ProductVariant> {

package/dist/lib/lib/collections/SkuCollection.d.ts

@@ -1,3 +1,8 @@
+/**
+ * SkuCollection — query helpers for {@link Sku} rows.
+ *
+ * @packageDocumentation
+ */
 import { SmrtCollection } from '@happyvertical/smrt-core';
 import { Sku } from '../models/Sku';
 export declare class SkuCollection extends SmrtCollection<Sku> {

package/dist/lib/lib/collections/index.d.ts

@@ -1,3 +1,4 @@
+import '../../__smrt-register__.js';
 export { CategoryCollection } from './CategoryCollection';
 export { MaterialCollection } from './MaterialCollection';
 export { ProductAssetCollection } from './ProductAssetCollection';

package/dist/lib/lib/generated/index.d.ts

@@ -1,2 +1,11 @@
+/**
+ * Auto-generated SMRT Components
+ *
+ * This file is automatically generated by the SMRT Vite plugin.
+ * It exports UI components that are auto-generated from @smrt() decorated classes.
+ *
+ * DO NOT EDIT THIS FILE MANUALLY - it will be overwritten.
+ */
+import '../../__smrt-register__.js';
 export declare const autoGeneratedComponents: {};
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/lib/mock-smrt-client.d.ts

@@ -1,4 +1,10 @@
-import { ProductData } from './types';
+/**
+ * Mock SMRT Client - Temporary implementation for demo purposes
+ *
+ * This replaces the missing @smrt/client virtual module with a working implementation
+ * that demonstrates the intended functionality.
+ */
+import type { ProductData } from './types';
 export type { ProductData } from './types';
 export interface ApiResponse<T> {
     data: T;

package/dist/lib/lib/models/Category.d.ts

@@ -1,4 +1,9 @@
-import { SmrtObject, SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Product knowledge base category model
+ *
+ * SMRT auto-generates REST APIs, MCP tools, and TypeScript clients from this class.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
 /**
  * Options for Category initialization
  */

package/dist/lib/lib/models/Material.d.ts

@@ -1,6 +1,17 @@
-import { Meta } from '@happyvertical/smrt-core';
-import { Product, ProductOptions } from './Product';
-import { MaterialKind, ProductType } from './types';
+/**
+ * Material — STI subtype of Product representing a raw input consumed by
+ * manufacturing: fabric, thread, trim, labels, packaging, components.
+ *
+ * Materials are first-class products in the catalog (the SAP/NetSuite pattern):
+ * they have a name, description, vendor, unit cost, and live in inventory just
+ * like finished goods. Bills of materials in `@happyvertical/smrt-manufacturing`
+ * reference Materials by id.
+ *
+ * @packageDocumentation
+ */
+import { type Meta } from '@happyvertical/smrt-core';
+import { Product, type ProductOptions } from './Product';
+import { type MaterialKind, ProductType } from './types';
 export interface MaterialOptions extends ProductOptions {
     materialKind?: MaterialKind;
     uom?: string;

package/dist/lib/lib/models/Product.d.ts

@@ -1,5 +1,10 @@
-import { Asset } from '@happyvertical/smrt-assets';
-import { SmrtObject, SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Product knowledge base model
+ *
+ * SMRT auto-generates REST APIs, MCP tools, and TypeScript clients from this class.
+ */
+import type { Asset } from '@happyvertical/smrt-assets';
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
 import { ProductType } from './types';
 /**
  * Options for Product initialization

package/dist/lib/lib/models/ProductAsset.d.ts

@@ -1,4 +1,5 @@
-import { SmrtObjectOptions, SmrtObject } from '@happyvertical/smrt-core';
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
 export interface ProductAssetOptions extends SmrtObjectOptions {
     tenantId?: string | null;
     productId?: string;

package/dist/lib/lib/models/ProductVariant.d.ts

@@ -1,4 +1,27 @@
-import { SmrtObject, SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * ProductVariant — declarative description of one axis along which a
+ * product's SKUs differ.
+ *
+ * A `ProductVariant` row says "for product X, axis Y has the following
+ * allowed values". The actual per-SKU value lives on `Sku.attributes`
+ * (also in this package — `Sku` was relocated to `@happyvertical/smrt-products`
+ * in Phase 1; inventory only holds stock motion now), keyed by `axisName`.
+ * This split keeps the axis catalog (form choices, UI grouping, ordering)
+ * separate from the per-unit instances.
+ *
+ * Deliberately generic. `axisName` is free-form — apparel teams might
+ * use `'size'` and `'color'`, automotive teams `'trim'` and `'engine'`,
+ * CPG teams `'packSize'` and `'flavor'`. The framework never inspects
+ * the axis name.
+ *
+ * NOT a Product STI subtype — it's its own model with its own table,
+ * because the shape (axis declaration) doesn't fit the Product schema
+ * (no name, no price, no category — it's metadata about a Product, not
+ * a Product itself).
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
 /**
  * Options accepted by the {@link ProductVariant} constructor.
  */

package/dist/lib/lib/models/Sku.d.ts

@@ -1,4 +1,25 @@
-import { SmrtObject, SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * Sku — smallest sellable and countable unit.
+ *
+ * A SKU is the concrete catalog row that downstream inventory counts.
+ * It references a higher-level concept in this same package (a
+ * {@link Product} or any of its STI subtypes) via the plain string
+ * `productId` field. The same pattern serves apparel (one SKU per
+ * size/color), furniture (one SKU per finish), automotive parts,
+ * grocery (one SKU per pack size), or any other vertical that needs
+ * to count discrete units.
+ *
+ * Axis values such as `{ size: 'M', color: 'navy' }`, `{ finish: 'walnut' }`,
+ * or `{ packSize: '12oz' }` are stored as opaque JSON in `attributes`;
+ * the declarative axis catalog lives in {@link ProductVariant} in this
+ * same package.
+ *
+ * Stock balance and movement history for a SKU live in
+ * `@happyvertical/smrt-inventory` as `StockLevel` and `StockMovement`.
+ *
+ * @packageDocumentation
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
 /**
  * Options accepted by the {@link Sku} constructor.
  */

package/dist/lib/lib/models/index.d.ts

@@ -1,3 +1,14 @@
+/**
+ * SMRT Template Models
+ *
+ * Domain models that demonstrate SMRT auto-generation capabilities.
+ * These classes are decorated with @smrt() and automatically generate:
+ * - REST APIs
+ * - TypeScript clients
+ * - MCP tools for AI
+ * - UI components
+ */
+import '../../__smrt-register__.js';
 export type { CategoryOptions } from './Category';
 export { Category } from './Category';
 export type { MaterialOptions } from './Material';

package/dist/lib/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-products",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.33",
   "objects": {
     "@happyvertical/smrt-products:CategoryCollection": {
       "name": "categorycollection",

package/dist/lib/models.js

@@ -1,3 +1,3 @@
 import { a as Product, i as Material, n as ProductVariant, o as ProductType, r as ProductAsset, s as Category, t as Sku } from "./chunks/Sku-Bq9Fr-2f.js";
-import "./chunks/models-CIZqZgKA.js";
+import "./chunks/models-DfljuffS.js";
 export { Category, Material, Product, ProductAsset, ProductType, ProductVariant, Sku };

package/dist/lib/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-products",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.33",
   "sourceManifestPath": "dist/lib/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "4548023529322c349ea4e892561facd074bee59a49f8f0256c18452a7722c8c9",
-    "packageJson": "6185da36b2d35d0efe5956f4527f0ca7b445b5f0fa7daa77811f5cca1885a79b",
+    "manifest": "d0f5a22585e5c717f5624b2337d5ca92462f714108059c2ee970ad9e7fddf2db",
+    "packageJson": "2419137cc53296034e50b868fdb1aa4dd778e8f981107f9ff0ac228dfc0b1a98",
     "agents": "4ddde01c48baf13de773cdb57353a148f3fe3b93d21e99d8ac57677cda809e26"
   },
   "exports": [
@@ -48,7 +48,7 @@
     "concurrently": "^10.0.5",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-products",
-  "version": "0.51.32",
+  "version": "0.51.33",
   "smrtJsdoc": "strict",
   "description": "SMRT products module: triple-purpose microservice template for standalone apps, federated modules, and NPM libraries",
   "author": "HappyVertical",
@@ -57,13 +57,13 @@
     "@happyvertical/ai": "^0.94.1",
     "@happyvertical/files": "^0.94.1",
     "@happyvertical/logger": "^0.94.1",
-    "@happyvertical/smrt-assets": "0.51.32",
-    "@happyvertical/smrt-core": "0.51.32",
-    "@happyvertical/smrt-scanner": "0.51.32",
-    "@happyvertical/smrt-svelte": "0.51.32",
-    "@happyvertical/smrt-tenancy": "0.51.32",
-    "@happyvertical/smrt-ui": "0.51.32",
-    "@happyvertical/smrt-web": "0.51.32",
+    "@happyvertical/smrt-assets": "0.51.33",
+    "@happyvertical/smrt-core": "0.51.33",
+    "@happyvertical/smrt-scanner": "0.51.33",
+    "@happyvertical/smrt-svelte": "0.51.33",
+    "@happyvertical/smrt-tenancy": "0.51.33",
+    "@happyvertical/smrt-ui": "0.51.33",
+    "@happyvertical/smrt-web": "0.51.33",
     "@happyvertical/sql": "^0.94.1",
     "@happyvertical/utils": "^0.94.1",
     "cors": "^2.8.6",
@@ -84,11 +84,11 @@
     "@types/cors": "2.8.19",
     "@types/express": "^5.0.6",
     "@types/node": "24.13.6",
-    "@happyvertical/smrt-vitest": "0.51.32",
+    "@happyvertical/smrt-vitest": "0.51.33",
     "concurrently": "^10.0.5",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/dist/lib/chunks/models-CIZqZgKA.js

@@ -1,2 +0,0 @@
-import "./__smrt-register__-BBA7MNne.js";
-import "./Sku-Bq9Fr-2f.js";