Initial content

2024-05-29 18:54:49 +01:00
parent 2dbc1a8088
commit 5215a1d919
1944 changed files with 203378 additions and 0 deletions
@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvironment = exports.Env = void 0;
+var Env;
+(function (Env) {
+    Env["Development"] = "development";
+    Env["Production"] = "production";
+})(Env || (exports.Env = Env = {}));
+const getEnvironment = () => {
+    const env = process.env.NODE_ENV;
+    return env === undefined || env === Env.Development
+        ? Env.Development : Env.Production;
+};
+exports.getEnvironment = getEnvironment;
@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Env = exports.getEnvironment = exports.getConfig = void 0;
+const fs_1 = require("fs");
+const environment_1 = require("./environment");
+Object.defineProperty(exports, "getEnvironment", { enumerable: true, get: function () { return environment_1.getEnvironment; } });
+Object.defineProperty(exports, "Env", { enumerable: true, get: function () { return environment_1.Env; } });
+const merge_1 = require("./merge");
+const file = process.env.SERVER_CONFIG ?? "server.config.json";
+const data = JSON.parse((0, fs_1.readFileSync)(file).toString());
+try {
+    const envFile = (0, environment_1.getEnvironment)().toString() + "." + file;
+    const envData = JSON.parse((0, fs_1.readFileSync)(envFile).toString());
+    (0, merge_1.merge)(data, envData);
+}
+catch {
+    // do nothing - file doesn't exist or isn't readable
+}
+const getConfig = (path, defaultVal = undefined) => {
+    const paths = path.split(":");
+    let val = data;
+    paths.forEach(p => val = val[p]);
+    return val ?? defaultVal;
+};
+exports.getConfig = getConfig;
@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.merge = void 0;
+const merge = (target, source) => {
+    Object.keys(source).forEach(key => {
+        if (typeof source[key] === "object"
+            && !Array.isArray(source[key])) {
+            if (Object.hasOwn(target, key)) {
+                (0, exports.merge)(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, source[key]);
+            }
+        }
+        else {
+            target[key] = source[key];
+        }
+    });
+};
+exports.merge = merge;
@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.merge = void 0;
+const merge = (target, source) => {
+    Object.keys(source).forEach(key => {
+        if (typeof source[key] === "object"
+            && !Array.isArray(source[key])) {
+            if (Object.hasOwn(target, key)) {
+                (0, exports.merge)(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, source[key]);
+            }
+        }
+        else {
+            target[key] = source[key];
+        }
+    });
+};
+exports.merge = merge;
@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.catalog_repository = void 0;
+const orm_1 = require("./orm");
+exports.catalog_repository = new orm_1.CatalogRepoImpl();
@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRepo = void 0;
+const sequelize_1 = require("sequelize");
+const config_1 = require("../../config");
+const models_1 = require("./models");
+const fs_1 = require("fs");
+const config = (0, config_1.getConfig)("catalog:orm_repo");
+const logging = config.logging
+    ? { logging: console.log, logQueryParameters: true }
+    : { logging: false };
+class BaseRepo {
+    sequelize;
+    constructor() {
+        this.sequelize = new sequelize_1.Sequelize({ ...config.settings, ...logging });
+        this.initModelsAndDatabase();
+    }
+    async initModelsAndDatabase() {
+        (0, models_1.initializeModels)(this.sequelize);
+        if (config.reset_db) {
+            await this.sequelize.drop();
+            await this.sequelize.sync();
+            await this.addSeedData();
+        }
+        else {
+            await this.sequelize.sync();
+        }
+    }
+    async addSeedData() {
+        const data = JSON.parse((0, fs_1.readFileSync)(config.seed_file).toString());
+        await this.sequelize.transaction(async (transaction) => {
+            await models_1.SupplierModel.bulkCreate(data.suppliers, { transaction });
+            await models_1.CategoryModel.bulkCreate(data.categories, { transaction });
+            await models_1.ProductModel.bulkCreate(data.products, { transaction });
+        });
+    }
+}
+exports.BaseRepo = BaseRepo;
@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CatalogRepoImpl = void 0;
+const core_1 = require("./core");
+const queries_1 = require("./queries");
+const storage_1 = require("./storage");
+const RepoWithQueries = (0, queries_1.AddQueries)(core_1.BaseRepo);
+const CompleteRepo = (0, storage_1.AddStorage)(RepoWithQueries);
+exports.CatalogRepoImpl = CompleteRepo;
@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeCatalogModels = void 0;
+const sequelize_1 = require("sequelize");
+const catalog_models_1 = require("./catalog_models");
+const primaryKey = {
+    id: { type: sequelize_1.DataTypes.INTEGER, autoIncrement: true, primaryKey: true }
+};
+const initializeCatalogModels = (sequelize) => {
+    catalog_models_1.ProductModel.init({
+        ...primaryKey,
+        name: { type: sequelize_1.DataTypes.STRING },
+        description: { type: sequelize_1.DataTypes.STRING },
+        price: { type: sequelize_1.DataTypes.DECIMAL(10, 2) }
+    }, { sequelize });
+    catalog_models_1.CategoryModel.init({
+        ...primaryKey,
+        name: { type: sequelize_1.DataTypes.STRING }
+    }, { sequelize });
+    catalog_models_1.SupplierModel.init({
+        ...primaryKey,
+        name: { type: sequelize_1.DataTypes.STRING }
+    }, { sequelize });
+    catalog_models_1.ProductModel.belongsTo(catalog_models_1.CategoryModel, { foreignKey: "categoryId", as: "category" });
+    catalog_models_1.ProductModel.belongsTo(catalog_models_1.SupplierModel, { foreignKey: "supplierId", as: "supplier" });
+    catalog_models_1.CategoryModel.hasMany(catalog_models_1.ProductModel, { foreignKey: "categoryId", as: "products" });
+    catalog_models_1.SupplierModel.hasMany(catalog_models_1.ProductModel, { foreignKey: "supplierId", as: "products" });
+};
+exports.initializeCatalogModels = initializeCatalogModels;
@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupplierModel = exports.CategoryModel = exports.ProductModel = void 0;
+const sequelize_1 = require("sequelize");
+class ProductModel extends sequelize_1.Model {
+}
+exports.ProductModel = ProductModel;
+class CategoryModel extends sequelize_1.Model {
+}
+exports.CategoryModel = CategoryModel;
+class SupplierModel extends sequelize_1.Model {
+}
+exports.SupplierModel = SupplierModel;
@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeModels = exports.SupplierModel = exports.CategoryModel = exports.ProductModel = void 0;
+const catalog_helpers_1 = require("./catalog_helpers");
+var catalog_models_1 = require("./catalog_models");
+Object.defineProperty(exports, "ProductModel", { enumerable: true, get: function () { return catalog_models_1.ProductModel; } });
+Object.defineProperty(exports, "CategoryModel", { enumerable: true, get: function () { return catalog_models_1.CategoryModel; } });
+Object.defineProperty(exports, "SupplierModel", { enumerable: true, get: function () { return catalog_models_1.SupplierModel; } });
+const initializeModels = (sequelize) => {
+    (0, catalog_helpers_1.initializeCatalogModels)(sequelize);
+};
+exports.initializeModels = initializeModels;
@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddQueries = void 0;
+const models_1 = require("./models");
+function AddQueries(Base) {
+    return class extends Base {
+        getProducts() {
+            return models_1.ProductModel.findAll({
+                include: [
+                    { model: models_1.SupplierModel, as: "supplier" },
+                    { model: models_1.CategoryModel, as: "category" }
+                ],
+                raw: true, nest: true
+            });
+        }
+        getCategories() {
+            return models_1.CategoryModel.findAll({
+                raw: true, nest: true
+            });
+        }
+        getSuppliers() {
+            return models_1.SupplierModel.findAll({
+                raw: true, nest: true
+            });
+        }
+    };
+}
+exports.AddQueries = AddQueries;
@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddStorage = void 0;
+const models_1 = require("./models");
+function AddStorage(Base) {
+    return class extends Base {
+        storeProduct(p) {
+            return this.sequelize.transaction(async (transaction) => {
+                if (p.category) {
+                    p.category = await this.storeCategory(p.category);
+                }
+                if (p.supplier) {
+                    p.supplier = await this.storeSupplier(p.supplier);
+                }
+                const [stored] = await models_1.ProductModel.upsert({
+                    id: p.id, name: p.name, description: p.description,
+                    price: p.price, categoryId: p.category?.id,
+                    supplierId: p.supplier?.id
+                }, { transaction });
+                return stored;
+            });
+        }
+        async storeCategory(c, transaction) {
+            const [stored] = await models_1.CategoryModel.upsert({
+                id: c.id, name: c.name
+            }, { transaction });
+            return stored;
+        }
+        async storeSupplier(s, transaction) {
+            const [stored] = await models_1.SupplierModel.upsert({
+                id: s.id, name: s.name
+            }, { transaction });
+            return stored;
+        }
+    };
+}
+exports.AddStorage = AddStorage;
@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorHandlers = void 0;
+const config_1 = require("./config");
+require("express-async-errors");
+const template400 = (0, config_1.getConfig)("errors:400");
+const template500 = (0, config_1.getConfig)("errors:500");
+const createErrorHandlers = (app) => {
+    app.use((req, resp) => {
+        resp.statusCode = 404;
+        resp.render(template400);
+    });
+    const handler = (error, req, resp, next) => {
+        console.log(error);
+        if (resp.headersSent) {
+            return next(error);
+        }
+        try {
+            resp.statusCode = 500;
+            resp.render(template500, { error });
+        }
+        catch (newErr) {
+            next(error);
+        }
+    };
+    app.use(handler);
+};
+exports.createErrorHandlers = createErrorHandlers;
@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDevelopment = void 0;
+const config_1 = require("../config");
+const isDevelopment = (value) => {
+    return (0, config_1.getEnvironment)() === config_1.Env.Development;
+};
+exports.isDevelopment = isDevelopment;
@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTemplates = void 0;
+const config_1 = require("../config");
+const express_handlebars_1 = require("express-handlebars");
+const env_helpers = __importStar(require("./env"));
+const location = (0, config_1.getConfig)("templates:location");
+const config = (0, config_1.getConfig)("templates:config");
+const createTemplates = (app) => {
+    app.set("views", location);
+    app.engine("handlebars", (0, express_handlebars_1.engine)({
+        ...config, helpers: { ...env_helpers }
+    }));
+    app.set("view engine", "handlebars");
+};
+exports.createTemplates = createTemplates;
@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCatalogRoutes = void 0;
+const data_1 = require("../data");
+const createCatalogRoutes = (app) => {
+    app.get("/", async (req, resp) => {
+        const products = await data_1.catalog_repository.getProducts();
+        resp.render("index", { products });
+    });
+    // app.get("/err", (req, resp) => {
+    //     throw new Error ("Something bad happened");
+    // });
+    // app.get("/asyncerr", async (req, resp) => {
+    //     throw new Error ("Something bad happened asynchronously");
+    // });
+};
+exports.createCatalogRoutes = createCatalogRoutes;
@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRoutes = void 0;
+const catalog_1 = require("./catalog");
+const createRoutes = (app) => {
+    (0, catalog_1.createCatalogRoutes)(app);
+};
+exports.createRoutes = createRoutes;
@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const http_1 = require("http");
+const express_1 = __importDefault(require("express"));
+const helmet_1 = __importDefault(require("helmet"));
+const config_1 = require("./config");
+const routes_1 = require("./routes");
+const helpers_1 = require("./helpers");
+const errors_1 = require("./errors");
+const port = (0, config_1.getConfig)("http:port", 5000);
+const expressApp = (0, express_1.default)();
+expressApp.use((0, helmet_1.default)());
+expressApp.use(express_1.default.json());
+expressApp.use(express_1.default.urlencoded({ extended: true }));
+expressApp.use(express_1.default.static("node_modules/bootstrap/dist"));
+(0, helpers_1.createTemplates)(expressApp);
+(0, routes_1.createRoutes)(expressApp);
+(0, errors_1.createErrorHandlers)(expressApp);
+const server = (0, http_1.createServer)(expressApp);
+server.listen(port, () => console.log(`HTTP Server listening on port ${port}`));
@@ -0,0 +1,38 @@
+{
+    "name": "sportsstore",
+    "version": "1.0.0",
+    "description": "",
+    "main": "index.js",
+    "scripts": {
+        "watch": "tsc-watch --noClear --onsuccess \"node dist/server.js\"",
+        "start": "nodemon --exec npm run watch"
+    },
+    "nodemonConfig": {
+        "ext": "js,handlebars,json",
+        "ignore": [
+            "dist/**",
+            "node_modules/**"
+        ]
+    },
+    "keywords": [],
+    "author": "",
+    "license": "ISC",
+    "devDependencies": {
+        "@tsconfig/node20": "^20.1.2",
+        "@types/express": "^4.17.20",
+        "@types/node": "^20.6.1",
+        "nodemon": "^3.0.3",
+        "tsc-watch": "^6.0.4",
+        "typescript": "^5.2.2"
+    },
+    "dependencies": {
+        "bootstrap": "^5.3.2",
+        "express": "^4.18.2",
+        "express-async-errors": "^3.1.1",
+        "express-handlebars": "^7.1.2",
+        "handlebars": "^4.7.8",
+        "helmet": "^7.1.0",
+        "sequelize": "^6.35.1",
+        "sqlite3": "^5.1.6"
+    }
+}
@@ -0,0 +1,40 @@
+{
+    "suppliers": [
+        { "id": 1, "name": "Acme Industries"},
+        { "id": 2, "name": "Big Boat Co"},
+        { "id": 3, "name": "London Chess"}
+    ],
+    "categories": [
+        { "id": 1, "name": "Watersports"},
+        { "id": 2, "name": "Soccer"},
+        { "id": 3, "name": "Chess"}
+    ],
+    "products": [
+        {"id": 1, "name": "Kayak", "description": "A boat for one person", 
+         "price": 275.00, "categoryId": 1, "supplierId": 2 },
+        {"id": 2, "name": "Lifejacket", 
+            "description": "Protective and fashionable", 
+            "price": 48.95, "categoryId": 1, "supplierId": 2 },
+        { "id": 3, "name": "Soccer Ball", 
+            "description": "FIFA-approved size and weight",
+            "price": 19.50, "categoryId": 2, "supplierId": 1 },
+        { "id": 4, "name": "Corner Flags",
+            "description": "Give your playing field a professional touch",
+            "price": 34.95, "categoryId": 2, "supplierId": 1 },
+        { "id": 5, "name": "Stadium",
+            "description": "Flat-packed 35,000-seat stadium",
+            "price": 79500, "categoryId": 2, "supplierId": 1 },
+        { "id": 6, "name": "Thinking Cap", 
+            "description": "Improve brain efficiency by 75%", "price": 16,
+            "categoryId": 3, "supplierId": 3 },            
+        { "id": 7, "name": "Unsteady Chair", 
+            "description": "Secretly give your opponent a disadvantage",
+            "price": 29.95, "categoryId": 3, "supplierId": 3 },            
+        { "id": 8, "name": "Human Chess Board", 
+            "description": "A fun game for the family", "price": 75,
+            "categoryId": 3, "supplierId": 3 },
+        { "id": 9, "name": "Bling King", 
+            "description": "Gold-plated, diamond-studded King",
+            "price": 1200, "categoryId": 3, "supplierId": 3 }            
+    ]
+}
@@ -0,0 +1,28 @@
+{
+    "http": {
+        "port": 5000
+    },
+    "templates": {
+        "location": "templates",
+        "config": {
+            "layoutsDir": "templates",
+            "defaultLayout": "main_layout.handlebars",
+            "partialsDir": "templates"
+        }
+    },
+    "errors": {
+        "400": "not_found",
+        "500": "error"
+    }, 
+    "catalog": {
+        "orm_repo": {
+            "settings": {
+                "dialect": "sqlite",
+                "storage": "catalog.db"
+            },
+            "logging": true,
+            "reset_db": true,
+            "seed_file": "products.json"            
+        }
+    }
+}
@@ -0,0 +1,9 @@
+export enum Env {
+    Development = "development", Production = "production"
+}
+
+export const getEnvironment = () : Env => {
+    const env = process.env.NODE_ENV;
+    return  env === undefined || env === Env.Development 
+        ? Env.Development : Env.Production;
+}
@@ -0,0 +1,23 @@
+import { readFileSync } from "fs";
+import { getEnvironment, Env } from "./environment";
+import { merge } from "./merge";
+
+const file = process.env.SERVER_CONFIG ?? "server.config.json"
+const data = JSON.parse(readFileSync(file).toString());
+
+try {
+    const envFile = getEnvironment().toString() + "." + file;
+    const envData = JSON.parse(readFileSync(envFile).toString());
+    merge(data, envData);
+} catch {
+    // do nothing - file doesn't exist or isn't readable
+}
+
+export const getConfig = (path: string, defaultVal: any = undefined) : any => {
+    const paths = path.split(":");
+    let val = data;
+    paths.forEach(p => val = val[p]);
+    return val ?? defaultVal;
+}
+
+export { getEnvironment, Env };
@@ -0,0 +1,14 @@
+export const merge = (target: any, source: any) : any => {
+    Object.keys(source).forEach(key => {
+        if (typeof source[key] === "object" 
+                && !Array.isArray(source[key])) {
+            if (Object.hasOwn(target, key)) {
+                merge(target[key], source[key]);
+            } else {
+                Object.assign(target, source[key])
+            }
+        } else {
+            target[key] = source[key];
+        }
+    });
+}
@@ -0,0 +1,23 @@
+export interface  Product {
+    id?: number;
+    name: string;
+    description: string;
+    price: number;
+    
+    category?: Category;
+    supplier?: Supplier;
+}
+
+export interface Category {
+    id?: number;
+    name: string;
+
+    products?: Product[];
+}
+
+export interface Supplier {
+    id?: number;
+    name: string;
+    
+    products?: Product[];
+}
@@ -0,0 +1,16 @@
+import { Category, Product, Supplier } from "./catalog_models";
+
+export interface CatalogRepository {
+
+    getProducts(): Promise<Product[]>;
+
+    storeProduct(p: Product): Promise<Product>;
+
+    getCategories() : Promise<Category[]>;
+
+    storeCategory(c: Category): Promise<Category>;
+
+    getSuppliers(): Promise<Supplier[]>;
+
+    storeSupplier(s: Supplier): Promise<Supplier>;
+}
@@ -0,0 +1,4 @@
+import { CatalogRepository } from "./catalog_repository";
+import { CatalogRepoImpl} from "./orm";
+
+export const catalog_repository: CatalogRepository = new CatalogRepoImpl();
@@ -0,0 +1,41 @@
+import { Sequelize } from "sequelize";
+import { getConfig } from "../../config";
+import { initializeModels, CategoryModel, ProductModel, SupplierModel } 
+    from "./models";
+import { readFileSync } from "fs";
+
+const config = getConfig("catalog:orm_repo");
+const logging = config.logging 
+        ? { logging: console.log, logQueryParameters: true}
+        : { logging: false };
+
+export class BaseRepo {
+    sequelize: Sequelize; 
+    
+    constructor() {
+        this.sequelize = new Sequelize({ ...config.settings, ...logging })
+        this.initModelsAndDatabase();
+    }
+
+    async initModelsAndDatabase() : Promise<void> {
+        initializeModels(this.sequelize);
+        if (config.reset_db) {
+            await this.sequelize.drop();
+            await this.sequelize.sync();
+            await this.addSeedData();
+        } else {
+            await this.sequelize.sync();            
+        }
+    }    
+
+    async addSeedData() {
+        const data = JSON.parse(readFileSync(config.seed_file).toString());
+        await this.sequelize.transaction(async (transaction) => {
+            await SupplierModel.bulkCreate(data.suppliers, { transaction });
+            await CategoryModel.bulkCreate(data.categories, { transaction });
+            await ProductModel.bulkCreate(data.products, { transaction });
+        });
+    }    
+}
+
+export type Constructor<T = {}> = new (...args: any[]) => T;
@@ -0,0 +1,9 @@
+import { CatalogRepository } from "../catalog_repository";
+import { BaseRepo } from "./core";
+import { AddQueries } from "./queries";
+import { AddStorage } from "./storage";
+
+const RepoWithQueries = AddQueries(BaseRepo);
+const CompleteRepo = AddStorage(RepoWithQueries);
+
+export const CatalogRepoImpl = CompleteRepo;
@@ -0,0 +1,35 @@
+import { DataTypes, Sequelize } from "sequelize";
+import { CategoryModel, ProductModel, SupplierModel } from "./catalog_models";
+
+const primaryKey = {
+    id: { type: DataTypes.INTEGER, autoIncrement: true, primaryKey: true }
+};
+
+export const initializeCatalogModels = (sequelize: Sequelize) => {
+
+    ProductModel.init({
+        ...primaryKey,
+        name: { type: DataTypes.STRING},        
+        description: { type: DataTypes.STRING},
+        price: { type: DataTypes.DECIMAL(10, 2) }
+    }, { sequelize })
+
+    CategoryModel.init({
+        ...primaryKey,
+        name: { type: DataTypes.STRING}
+    }, { sequelize });
+
+    SupplierModel.init({
+        ...primaryKey,
+        name: { type: DataTypes.STRING}
+    }, { sequelize})
+
+    ProductModel.belongsTo(CategoryModel, 
+        { foreignKey: "categoryId", as: "category"});    
+    ProductModel.belongsTo(SupplierModel, 
+        { foreignKey: "supplierId", as: "supplier"});
+    CategoryModel.hasMany(ProductModel, 
+        { foreignKey: "categoryId", as: "products"});
+    SupplierModel.hasMany(ProductModel, 
+        { foreignKey: "supplierId", as: "products"});
+}
@@ -0,0 +1,36 @@
+import { Model, CreationOptional, ForeignKey, InferAttributes, 
+    InferCreationAttributes  } from "sequelize";
+
+export class ProductModel extends Model<InferAttributes<ProductModel>, 
+        InferCreationAttributes<ProductModel>> {
+
+    declare id?: CreationOptional<number>;
+
+    declare name: string;
+    declare description: string;
+    declare price: number;
+
+    declare categoryId: ForeignKey<CategoryModel["id"]>;
+    declare supplierId: ForeignKey<SupplierModel["id"]>;
+
+    declare category?: InferAttributes<CategoryModel>
+    declare supplier?: InferAttributes<SupplierModel>
+}
+
+export class CategoryModel extends Model<InferAttributes<CategoryModel>, 
+        InferCreationAttributes<CategoryModel>>   {
+
+    declare id?: CreationOptional<number>;
+    declare name: string;
+    
+    declare products?:  InferAttributes<ProductModel>[];
+}
+
+export class SupplierModel extends Model<InferAttributes<SupplierModel>, 
+        InferCreationAttributes<SupplierModel>>  {
+
+    declare id?: CreationOptional<number>;   
+    declare name: string;
+
+    declare products?:  InferAttributes<ProductModel>[];
+}
@@ -0,0 +1,8 @@
+import { Sequelize } from "sequelize";
+import { initializeCatalogModels } from "./catalog_helpers";
+
+export { ProductModel, CategoryModel, SupplierModel } from "./catalog_models";
+
+export const initializeModels = (sequelize: Sequelize) => {
+    initializeCatalogModels(sequelize);
+}
@@ -0,0 +1,28 @@
+import { CategoryModel, ProductModel, SupplierModel } from "./models";
+import { BaseRepo, Constructor } from "./core"
+
+export function AddQueries<TBase extends Constructor<BaseRepo>>(Base: TBase) {
+    return class extends Base {
+
+        getProducts() {
+            return ProductModel.findAll({
+                include: [
+                    {model: SupplierModel, as: "supplier" },
+                    {model: CategoryModel, as: "category"}],
+                raw: true, nest: true
+            });
+        }
+    
+        getCategories() {
+            return CategoryModel.findAll({
+                raw: true, nest: true
+            })
+        }
+    
+        getSuppliers() {
+            return SupplierModel.findAll({
+                raw: true, nest:true
+            });
+        }        
+    }
+}
@@ -0,0 +1,42 @@
+import { Transaction } from "sequelize";
+import { Category, Product, Supplier } from "../catalog_models";
+import { CategoryModel, ProductModel, SupplierModel } from "./models";
+import { BaseRepo, Constructor } from "./core"
+
+export function AddStorage<TBase extends Constructor<BaseRepo>>(Base: TBase)  {
+    return class extends Base {
+
+        storeProduct(p: Product) {
+            return  this.sequelize.transaction(async (transaction) => {
+    
+                if (p.category) {
+                    p.category = await this.storeCategory(p.category)
+                }
+                if (p.supplier) {
+                    p.supplier = await this.storeSupplier(p.supplier);
+                }
+                
+                const [stored] = await ProductModel.upsert({
+                    id: p.id, name: p.name, description: p.description,
+                    price: p.price, categoryId: p.category?.id,
+                    supplierId: p.supplier?.id
+                }, { transaction });
+                return stored;
+            });
+        }
+    
+        async storeCategory(c: Category, transaction?: Transaction) {
+            const [stored] = await CategoryModel.upsert({
+                id: c.id, name: c.name
+            }, { transaction});
+            return stored;
+        }
+    
+        async storeSupplier(s: Supplier, transaction?: Transaction) {
+            const [stored] = await SupplierModel.upsert({
+                id: s.id, name: s.name
+            }, {transaction});
+            return stored;
+        }       
+    }
+}
@@ -0,0 +1,28 @@
+import { Express, ErrorRequestHandler } from "express";
+import { getConfig } from "./config";
+import "express-async-errors";
+
+const template400 = getConfig("errors:400");
+const template500 = getConfig("errors:500");
+
+export const createErrorHandlers = (app: Express) => {
+
+    app.use((req, resp) => {
+        resp.statusCode = 404;
+        resp.render(template400);
+    });
+
+    const handler: ErrorRequestHandler = (error, req, resp, next) => {
+        console.log(error);
+        if (resp.headersSent) {
+            return next(error);
+        }
+        try {
+            resp.statusCode = 500;
+            resp.render(template500, { error} );
+        } catch (newErr) {
+            next(error);
+        }
+    }
+    app.use(handler);
+}
@@ -0,0 +1,5 @@
+import { Env, getEnvironment } from "../config";
+
+export const isDevelopment = (value: any) => {
+    return getEnvironment() === Env.Development
+}
@@ -0,0 +1,16 @@
+import { Express } from "express";
+import { getConfig } from "../config";
+import { engine } from "express-handlebars";
+import * as env_helpers from "./env";
+
+const location = getConfig("templates:location");
+const config = getConfig("templates:config");
+
+export const createTemplates = (app: Express) => {
+
+    app.set("views", location);
+    app.engine("handlebars", engine({
+        ...config, helpers: {...env_helpers }
+    }));
+    app.set("view engine", "handlebars");
+}
@@ -0,0 +1,18 @@
+import { Express } from "express";
+import { catalog_repository } from "../data";
+
+export const createCatalogRoutes = (app: Express) => {
+
+    app.get("/", async (req, resp) => {
+        const products = await catalog_repository.getProducts();
+        resp.render("index", { products });
+    })
+
+    // app.get("/err", (req, resp) => {
+    //     throw new Error ("Something bad happened");
+    // });
+    
+    // app.get("/asyncerr", async (req, resp) => {
+    //     throw new Error ("Something bad happened asynchronously");
+    // });
+}
@@ -0,0 +1,7 @@
+import { Express } from "express";
+import { createCatalogRoutes } from "./catalog";
+
+export const createRoutes = (app: Express) => {
+
+    createCatalogRoutes(app);
+}
@@ -0,0 +1,26 @@
+import { createServer } from "http";
+import express, { Express } from "express";
+import helmet from "helmet";
+import { getConfig } from "./config";
+import { createRoutes } from "./routes";
+import { createTemplates } from "./helpers";
+import { createErrorHandlers } from "./errors";
+
+const port = getConfig("http:port", 5000);
+
+const expressApp: Express = express();
+
+expressApp.use(helmet());
+expressApp.use(express.json());
+expressApp.use(express.urlencoded({extended: true}))
+
+expressApp.use(express.static("node_modules/bootstrap/dist"));
+createTemplates(expressApp);
+
+createRoutes(expressApp);
+createErrorHandlers(expressApp);
+
+const server = createServer(expressApp);
+
+server.listen(port, 
+    () => console.log(`HTTP Server listening on port ${port}`));
@@ -0,0 +1,12 @@
+<div class="h2 bg-danger text-white text-center p-2 my-2">
+    500 - Error
+</div>
+<div class="text-center">
+    <a class="btn btn-secondary" href="/">OK</a>
+</div>
+
+{{#if (isDevelopment) }} 
+    <div class="h4 bg-danger text-white p-1 mt-2">Error Details</div>
+    <div class="h5 p-1">Message: {{ error.message }}</div>
+    <div class="font-monospace p-1">{{error.stack}}</div>
+ {{/if }}
@@ -0,0 +1,17 @@
+<table class="table table-sm table-striped">
+    <thead>
+        <tr>
+            <th>ID</th><th>Name</th><th>Description</th>
+            <th>Price</th><th>Category</th><th>Supplier</th>
+        </tr>
+    </thead>
+    <tbody>
+        {{#each products }}
+            <tr>
+                <td>{{id}}</td><td>{{name}}</td>
+                <td>{{description}}</td><td>{{price}}</td>
+                <td>{{category.name}}</td><td>{{supplier.name}}</td>
+            </tr>
+        {{/each}}
+    </tbody>
+</table>
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <link href="/css/bootstrap.min.css" rel="stylesheet" />
+    </head>
+    <body>
+        <div class="bg-dark text-white p-2">
+            <span class="navbar-brand ml-2">SPORTS STORE</span>
+        </div>
+        {{{ body }}}
+    </body>
+</html>
@@ -0,0 +1,6 @@
+<div class="h2 bg-danger text-white text-center p-2 my-2">
+    404 - Not Found
+</div>
+<div class="text-center">
+    <a class="btn btn-secondary" href="/">OK</a>
+</div>
@@ -0,0 +1,8 @@
+{
+    "extends": "@tsconfig/node20/tsconfig.json",
+     "compilerOptions": {                       
+         "rootDir": "src/",   
+         "outDir": "dist/"        
+     },
+     "include": ["src/**/*"]
+}