@hed-hog/catalog 0.0.276

package/hedhog/table/catalog_product_image.yaml

@@ -0,0 +1,34 @@
+columns:
+  - type: pk
+  - name: product_id
+    type: fk
+    references:
+      table: catalog_product
+      column: id
+      onDelete: CASCADE
+  - name: file_id
+    type: fk
+    references:
+      table: file
+      column: id
+      onDelete: CASCADE
+  - name: role
+    type: enum
+    values: [primary, gallery, thumbnail, lifestyle, technical]
+    default: gallery
+  - name: sort_order
+    type: int
+    default: 0
+  - name: is_primary
+    type: boolean
+    default: false
+  - name: alt_text
+    type: varchar
+    length: 255
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [product_id, sort_order]
+  - columns: [product_id, is_primary]
+  - columns: [file_id]

package/hedhog/table/catalog_product_score.yaml

@@ -0,0 +1,38 @@
+columns:
+  - type: pk
+  - name: product_id
+    type: fk
+    references:
+      table: catalog_product
+      column: id
+      onDelete: CASCADE
+  - name: criterion_id
+    type: fk
+    references:
+      table: catalog_score_criterion
+      column: id
+      onDelete: CASCADE
+  - name: score_value
+    type: decimal
+    precision: 5
+    scale: 2
+  - name: score_label
+    type: varchar
+    length: 255
+    isNullable: true
+  - name: summary
+    type: text
+    isNullable: true
+  - name: calculation_source
+    type: varchar
+    length: 255
+    isNullable: true
+  - name: is_manual_override
+    type: boolean
+    default: false
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [product_id, criterion_id]
+    isUnique: true
+  - columns: [criterion_id, score_value]

package/hedhog/table/catalog_product_site.yaml

@@ -0,0 +1,47 @@
+columns:
+  - type: pk
+  - name: product_id
+    type: fk
+    references:
+      table: catalog_product
+      column: id
+      onDelete: CASCADE
+  - name: site_id
+    type: fk
+    references:
+      table: catalog_site
+      column: id
+      onDelete: CASCADE
+  - name: publication_status
+    type: enum
+    values: [draft, published, hidden]
+    default: draft
+  - name: canonical_slug
+    type: varchar
+    length: 255
+  - name: is_featured
+    type: boolean
+    default: false
+  - name: visibility_score
+    type: int
+    default: 0
+  - name: override_brand_name
+    type: varchar
+    length: 255
+    isNullable: true
+  - name: seo_title
+    type: varchar
+    length: 255
+    isNullable: true
+  - name: seo_description
+    type: varchar
+    length: 500
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [site_id, product_id]
+    isUnique: true
+  - columns: [site_id, canonical_slug]
+    isUnique: true
+  - columns: [site_id, publication_status]

package/hedhog/table/catalog_product_tag.yaml

@@ -0,0 +1,19 @@
+columns:
+  - type: pk
+  - name: product_id
+    type: fk
+    references:
+      table: catalog_product
+      column: id
+      onDelete: CASCADE
+  - name: tag_id
+    type: fk
+    references:
+      table: tag
+      column: id
+      onDelete: CASCADE
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [product_id, tag_id]
+    isUnique: true

package/hedhog/table/catalog_score_criterion.yaml

@@ -0,0 +1,37 @@
+columns:
+  - type: pk
+  - name: category_id
+    type: fk
+    references:
+      table: category
+      column: id
+      onDelete: CASCADE
+  - name: slug
+    type: varchar
+    length: 255
+  - name: name
+    type: varchar
+    length: 255
+  - name: weight
+    type: int
+    default: 1
+  - name: score_type
+    type: enum
+    values: [manual, weighted, formula]
+    default: manual
+  - name: formula_json
+    type: json
+    isNullable: true
+  - name: display_order
+    type: int
+    default: 0
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [category_id, slug]
+    isUnique: true
+  - columns: [category_id, status]

package/hedhog/table/catalog_seo_page_rule.yaml

@@ -0,0 +1,51 @@
+columns:
+  - type: pk
+  - name: site_id
+    type: fk
+    references:
+      table: catalog_site
+      column: id
+      onDelete: CASCADE
+  - name: category_id
+    type: fk
+    isNullable: true
+    references:
+      table: category
+      column: id
+      onDelete: SET NULL
+  - name: page_type
+    type: enum
+    values: [comparison, best_of, cost_benefit, attribute, price_range, brand, use_case]
+    default: comparison
+  - name: rule_slug
+    type: varchar
+    length: 255
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - name: generation_query_json
+    type: json
+    isNullable: true
+  - name: min_product_count
+    type: int
+    default: 2
+  - name: min_attribute_coverage
+    type: int
+    default: 1
+  - name: canonical_strategy
+    type: enum
+    values: [self, parent, custom]
+    default: self
+  - name: priority
+    type: int
+    default: 0
+  - name: template_json
+    type: json
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [site_id, rule_slug]
+    isUnique: true
+  - columns: [site_id, page_type, status]

package/hedhog/table/catalog_similarity_rule.yaml

@@ -0,0 +1,28 @@
+columns:
+  - type: pk
+  - name: category_id
+    type: fk
+    references:
+      table: category
+      column: id
+      onDelete: CASCADE
+  - name: rule_type
+    type: enum
+    values: [same_category, compatible_category, shared_attribute, manual]
+    default: same_category
+  - name: rule_json
+    type: json
+    isNullable: true
+  - name: min_similarity_score
+    type: decimal
+    precision: 5
+    scale: 2
+    default: 0
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [category_id, status]

package/hedhog/table/catalog_site.yaml

@@ -0,0 +1,40 @@
+columns:
+  - type: pk
+  - name: slug
+    type: varchar
+    length: 255
+  - name: name
+    type: varchar
+    length: 255
+  - name: domain
+    type: varchar
+    length: 255
+  - name: status
+    type: enum
+    values: [active, inactive]
+    default: active
+  - name: site_type
+    type: enum
+    values: [portal, niche, tenant]
+    default: portal
+  - name: default_locale_id
+    type: fk
+    references:
+      table: locale
+      column: id
+      onDelete: RESTRICT
+  - name: theme_settings_json
+    type: json
+    isNullable: true
+  - name: seo_defaults_json
+    type: json
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [slug]
+    isUnique: true
+  - columns: [domain]
+    isUnique: true
+  - columns: [status]
+  - columns: [default_locale_id]

package/hedhog/table/catalog_site_category.yaml

@@ -0,0 +1,26 @@
+columns:
+  - type: pk
+  - name: site_id
+    type: fk
+    references:
+      table: catalog_site
+      column: id
+      onDelete: CASCADE
+  - name: category_id
+    type: fk
+    references:
+      table: category
+      column: id
+      onDelete: CASCADE
+  - name: is_primary
+    type: boolean
+    default: false
+  - name: visibility_status
+    type: enum
+    values: [visible, hidden]
+    default: visible
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns: [site_id, category_id]
+    isUnique: true

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@hed-hog/catalog",
+  "version": "0.0.276",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@nestjs/common": "*",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11",
+    "@nestjs/jwt": "^11",
+    "@nestjs/mapped-types": "*",
+    "@hed-hog/api-locale": "0.0.13",
+    "@hed-hog/api": "0.0.4",
+    "@hed-hog/core": "0.0.276",
+    "@hed-hog/api-pagination": "0.0.6",
+    "@hed-hog/api-prisma": "0.0.5",
+    "@hed-hog/category": "0.0.276",
+    "@hed-hog/content": "0.0.276",
+    "@hed-hog/tag": "0.0.276"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "hedhog"
+  ],
+  "scripts": {
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
+    "prebuild": "npx ts-node ../../scripts/build-dependencies.ts libraries/catalog",
+    "build": "tsc --project tsconfig.production.json",
+    "patch": "npx ts-node ../../scripts/patch.ts libraries/catalog",
+    "prod": "pnpm run patch && pnpm run build && pnpm publish --access public --no-git-checks"
+  }
+}

package/src/catalog-resource.config.ts

@@ -0,0 +1,218 @@
+export type CatalogResourceConfig = {
+  resource: string;
+  model: string;
+  searchFields: string[];
+  filterFields?: string[];
+  fields: string[];
+  defaultOrderBy?: Record<string, 'asc' | 'desc'>;
+  statusField?: string;
+};
+
+export const catalogResources: CatalogResourceConfig[] = [
+  {
+    resource: 'brands',
+    model: 'catalog_brand',
+    searchFields: ['slug', 'name', 'normalized_name'],
+    filterFields: ['status', 'logo_file_id'],
+    fields: ['slug', 'name', 'normalized_name', 'logo_file_id', 'status', 'website_url'],
+    statusField: 'status',
+  },
+  {
+    resource: 'sites',
+    model: 'catalog_site',
+    searchFields: ['slug', 'name', 'domain'],
+    filterFields: ['status', 'site_type', 'default_locale_id'],
+    fields: ['slug', 'name', 'domain', 'status', 'site_type', 'default_locale_id', 'theme_settings_json', 'seo_defaults_json'],
+    statusField: 'status',
+  },
+  {
+    resource: 'products',
+    model: 'catalog_product',
+    searchFields: ['slug', 'name', 'model_name', 'sku', 'gtin'],
+    filterFields: ['status', 'comparison_status', 'brand_id', 'category_id', 'primary_content_id', 'is_active'],
+    fields: ['brand_id', 'category_id', 'primary_content_id', 'slug', 'name', 'short_description', 'description', 'model_name', 'sku', 'gtin', 'status', 'comparison_status', 'release_date', 'spec_snapshot_json', 'comparison_snapshot_json', 'is_active'],
+    statusField: 'status',
+  },
+  {
+    resource: 'product-categories',
+    model: 'catalog_product_category',
+    searchFields: [],
+    filterFields: ['product_id', 'category_id', 'is_primary'],
+    fields: ['product_id', 'category_id', 'is_primary', 'sort_order'],
+  },
+  {
+    resource: 'product-images',
+    model: 'catalog_product_image',
+    searchFields: ['alt_text', 'role'],
+    filterFields: ['product_id', 'file_id', 'role', 'is_primary'],
+    fields: ['product_id', 'file_id', 'role', 'sort_order', 'is_primary', 'alt_text'],
+  },
+  {
+    resource: 'product-sites',
+    model: 'catalog_product_site',
+    searchFields: ['canonical_slug', 'override_brand_name', 'seo_title'],
+    filterFields: ['product_id', 'site_id', 'publication_status', 'is_featured'],
+    fields: ['product_id', 'site_id', 'publication_status', 'canonical_slug', 'is_featured', 'visibility_score', 'override_brand_name', 'seo_title', 'seo_description'],
+    statusField: 'publication_status',
+  },
+  {
+    resource: 'attribute-groups',
+    model: 'catalog_attribute_group',
+    searchFields: ['slug', 'name'],
+    filterFields: ['status'],
+    fields: ['slug', 'name', 'status'],
+    statusField: 'status',
+  },
+  {
+    resource: 'attributes',
+    model: 'catalog_attribute',
+    searchFields: ['slug', 'label', 'description', 'unit'],
+    filterFields: ['group_id', 'data_type', 'comparison_mode', 'is_filterable', 'is_sortable', 'is_required_for_comparison'],
+    fields: ['group_id', 'slug', 'label', 'description', 'data_type', 'unit', 'comparison_mode', 'is_filterable', 'is_sortable', 'is_required_for_comparison', 'normalization_rule_json', 'display_order'],
+  },
+  {
+    resource: 'category-attributes',
+    model: 'catalog_category_attribute',
+    searchFields: [],
+    filterFields: ['category_id', 'attribute_id', 'is_required', 'is_highlighted', 'facet_mode'],
+    fields: ['category_id', 'attribute_id', 'is_required', 'is_highlighted', 'display_order', 'weight', 'facet_mode'],
+  },
+  {
+    resource: 'product-attributes',
+    model: 'catalog_product_attribute_value',
+    searchFields: ['value_text', 'normalized_text', 'source_type'],
+    filterFields: ['product_id', 'attribute_id', 'is_verified'],
+    fields: ['product_id', 'attribute_id', 'value_text', 'value_number', 'value_boolean', 'value_json', 'value_unit', 'normalized_text', 'normalized_number', 'source_type', 'confidence_score', 'is_verified'],
+  },
+  {
+    resource: 'score-criteria',
+    model: 'catalog_score_criterion',
+    searchFields: ['slug', 'name'],
+    filterFields: ['category_id', 'status', 'score_type'],
+    fields: ['category_id', 'slug', 'name', 'weight', 'score_type', 'formula_json', 'display_order', 'status'],
+    statusField: 'status',
+  },
+  {
+    resource: 'product-scores',
+    model: 'catalog_product_score',
+    searchFields: ['score_label', 'summary', 'calculation_source'],
+    filterFields: ['product_id', 'criterion_id', 'is_manual_override'],
+    fields: ['product_id', 'criterion_id', 'score_value', 'score_label', 'summary', 'calculation_source', 'is_manual_override'],
+  },
+  {
+    resource: 'comparisons',
+    model: 'catalog_comparison',
+    searchFields: ['slug', 'title', 'summary', 'verdict', 'eligibility_hash'],
+    filterFields: ['category_id', 'site_id', 'primary_content_id', 'comparison_type', 'generation_mode', 'status'],
+    fields: ['category_id', 'site_id', 'primary_content_id', 'slug', 'comparison_type', 'generation_mode', 'status', 'title', 'summary', 'intro', 'verdict', 'spec_snapshot_json', 'eligibility_hash', 'published_at'],
+    statusField: 'status',
+  },
+  {
+    resource: 'comparison-items',
+    model: 'catalog_comparison_item',
+    searchFields: ['badge_label'],
+    filterFields: ['comparison_id', 'product_id', 'is_winner'],
+    fields: ['comparison_id', 'product_id', 'sort_order', 'is_winner', 'badge_label'],
+  },
+  {
+    resource: 'comparison-highlights',
+    model: 'catalog_comparison_highlight',
+    searchFields: ['highlight_type', 'title', 'body'],
+    filterFields: ['comparison_id', 'product_id', 'attribute_id', 'highlight_type'],
+    fields: ['comparison_id', 'product_id', 'attribute_id', 'highlight_type', 'title', 'body', 'sort_order'],
+  },
+  {
+    resource: 'similarity-rules',
+    model: 'catalog_similarity_rule',
+    searchFields: ['rule_type'],
+    filterFields: ['category_id', 'status'],
+    fields: ['category_id', 'rule_type', 'rule_json', 'min_similarity_score', 'status'],
+    statusField: 'status',
+  },
+  {
+    resource: 'merchants',
+    model: 'catalog_merchant',
+    searchFields: ['slug', 'name'],
+    filterFields: ['status', 'merchant_type', 'logo_file_id'],
+    fields: ['slug', 'name', 'status', 'merchant_type', 'logo_file_id'],
+    statusField: 'status',
+  },
+  {
+    resource: 'affiliate-programs',
+    model: 'catalog_affiliate_program',
+    searchFields: ['slug', 'name', 'network_type', 'commission_type'],
+    filterFields: ['merchant_id', 'status', 'network_type'],
+    fields: ['merchant_id', 'slug', 'name', 'network_type', 'tracking_template', 'commission_type', 'default_commission_value', 'status'],
+    statusField: 'status',
+  },
+  {
+    resource: 'offers',
+    model: 'catalog_offer',
+    searchFields: ['external_offer_id', 'title', 'availability_status'],
+    filterFields: ['product_id', 'merchant_id', 'affiliate_program_id', 'site_id', 'availability_status', 'is_featured'],
+    fields: ['product_id', 'merchant_id', 'affiliate_program_id', 'site_id', 'external_offer_id', 'title', 'price_amount', 'price_currency', 'original_price_amount', 'installment_json', 'availability_status', 'affiliate_url', 'deep_link_url', 'priority_score', 'is_featured', 'valid_from', 'valid_until', 'last_seen_at'],
+  },
+  {
+    resource: 'price-history',
+    model: 'catalog_price_history',
+    searchFields: ['availability_status'],
+    filterFields: ['offer_id', 'product_id', 'availability_status'],
+    fields: ['offer_id', 'product_id', 'captured_at', 'price_amount', 'original_price_amount', 'availability_status'],
+  },
+  {
+    resource: 'click-events',
+    model: 'catalog_click_event',
+    searchFields: ['placement', 'session_hash', 'referrer_host'],
+    filterFields: ['offer_id', 'product_id', 'site_id', 'comparison_id'],
+    fields: ['offer_id', 'product_id', 'site_id', 'comparison_id', 'clicked_at', 'placement', 'utm_json', 'session_hash', 'referrer_host'],
+  },
+  {
+    resource: 'site-categories',
+    model: 'catalog_site_category',
+    searchFields: ['visibility_status'],
+    filterFields: ['site_id', 'category_id', 'is_primary', 'visibility_status'],
+    fields: ['site_id', 'category_id', 'is_primary', 'visibility_status'],
+  },
+  {
+    resource: 'content-relations',
+    model: 'catalog_content_relation',
+    searchFields: ['relation_type'],
+    filterFields: ['site_id', 'content_id', 'product_id', 'comparison_id', 'relation_type'],
+    fields: ['site_id', 'content_id', 'product_id', 'comparison_id', 'relation_type', 'sort_order'],
+  },
+  {
+    resource: 'seo-rules',
+    model: 'catalog_seo_page_rule',
+    searchFields: ['page_type', 'rule_slug', 'canonical_strategy'],
+    filterFields: ['site_id', 'category_id', 'status', 'page_type'],
+    fields: ['site_id', 'category_id', 'page_type', 'rule_slug', 'status', 'generation_query_json', 'min_product_count', 'min_attribute_coverage', 'canonical_strategy', 'priority', 'template_json'],
+    statusField: 'status',
+  },
+  {
+    resource: 'import-sources',
+    model: 'catalog_import_source',
+    searchFields: ['slug', 'name', 'source_type'],
+    filterFields: ['source_type', 'status'],
+    fields: ['slug', 'name', 'source_type', 'config_json', 'status'],
+    statusField: 'status',
+  },
+  {
+    resource: 'import-runs',
+    model: 'catalog_import_run',
+    searchFields: ['status', 'idempotency_key'],
+    filterFields: ['source_id', 'status'],
+    fields: ['source_id', 'started_at', 'finished_at', 'status', 'stats_json', 'error_log', 'idempotency_key'],
+    statusField: 'status',
+  },
+  {
+    resource: 'product-tags',
+    model: 'catalog_product_tag',
+    searchFields: [],
+    filterFields: ['product_id', 'tag_id'],
+    fields: ['product_id', 'tag_id'],
+  }
+];
+
+export const catalogResourceMap = new Map(
+  catalogResources.map((resource) => [resource.resource, resource]),
+);

package/src/catalog.controller.ts

@@ -0,0 +1,82 @@
+import { Role } from '@hed-hog/api';
+import { Locale } from '@hed-hog/api-locale';
+import { Pagination } from '@hed-hog/api-pagination';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
+} from '@nestjs/common';
+import { CatalogService } from './catalog.service';
+
+@Role()
+@Controller('catalog')
+export class CatalogController {
+  constructor(private readonly catalogService: CatalogService) {}
+
+  @Get('products/:id/images')
+  async listProductImages(
+    @Param('id', ParseIntPipe) id: number,
+    @Pagination() paginationParams,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.listProductImages(id, locale, paginationParams);
+  }
+
+  @Get(':resource/stats')
+  async stats(@Param('resource') resource: string, @Locale() locale: string) {
+    return this.catalogService.stats(resource, locale);
+  }
+
+  @Get(':resource/:id')
+  async getById(
+    @Param('resource') resource: string,
+    @Param('id', ParseIntPipe) id: number,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.getById(resource, id, locale);
+  }
+
+  @Patch(':resource/:id')
+  async update(
+    @Param('resource') resource: string,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() body: Record<string, unknown>,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.update(resource, id, body, locale);
+  }
+
+  @Delete(':resource/:id')
+  async delete(
+    @Param('resource') resource: string,
+    @Param('id', ParseIntPipe) id: number,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.delete(resource, id, locale);
+  }
+
+  @Get(':resource')
+  async list(
+    @Param('resource') resource: string,
+    @Pagination() paginationParams,
+    @Query() query: Record<string, unknown>,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.list(resource, locale, paginationParams, query);
+  }
+
+  @Post(':resource')
+  async create(
+    @Param('resource') resource: string,
+    @Body() body: Record<string, unknown>,
+    @Locale() locale: string,
+  ) {
+    return this.catalogService.create(resource, body, locale);
+  }
+}

package/src/catalog.module.ts

@@ -0,0 +1,12 @@
+import { PaginationModule } from '@hed-hog/api-pagination';
+import { Module, forwardRef } from '@nestjs/common';
+import { CatalogController } from './catalog.controller';
+import { CatalogService } from './catalog.service';
+
+@Module({
+  imports: [forwardRef(() => PaginationModule)],
+  controllers: [CatalogController],
+  providers: [CatalogService],
+  exports: [CatalogService],
+})
+export class CatalogModule {}