Initial content

Chapter 19/Beginning of Chapter/sportsstore/development.env

@@ -0,0 +1,2 @@
+# secret used to sign session cookies
+COOKIE_SECRET="sportsstoresecret"

Chapter 19/Beginning of Chapter/sportsstore/dist/config/environment.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/config/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Env = exports.getEnvironment = exports.getSecret = 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 dotenv_1 = require("dotenv");
+const file = process.env.SERVER_CONFIG ?? "server.config.json";
+const data = JSON.parse((0, fs_1.readFileSync)(file).toString());
+(0, dotenv_1.config)({
+    path: (0, environment_1.getEnvironment)().toString() + ".env"
+});
+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;
+const getSecret = (name) => {
+    const secret = process.env[name];
+    if (secret === undefined) {
+        throw new Error(`Undefined secret: ${name}`);
+    }
+    return secret;
+};
+exports.getSecret = getSecret;

Chapter 19/Beginning of Chapter/sportsstore/dist/config/merge.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/config/nerge.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/cart_helpers.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCartDetail = void 0;
+const _1 = require(".");
+const getCartDetail = async (cart) => {
+    const ids = cart.lines.map(l => l.productId);
+    const db_data = await _1.catalog_repository.getProductDetails(ids);
+    const products = Object.fromEntries(db_data.map(p => [p.id, p]));
+    const lines = cart.lines.map(line => ({
+        product: products[line.productId],
+        quantity: line.quantity,
+        subtotal: products[line.productId].price * line.quantity
+    }));
+    const total = lines.reduce((total, line) => total + line.subtotal, 0);
+    return { lines, total };
+};
+exports.getCartDetail = getCartDetail;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/cart_models.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeLine = exports.addLine = exports.createCart = void 0;
+const createCart = () => ({ lines: [] });
+exports.createCart = createCart;
+const addLine = (cart, productId, quantity) => {
+    const line = cart.lines.find(l => l.productId == productId);
+    if (line !== undefined) {
+        line.quantity += quantity;
+    }
+    else {
+        cart.lines.push({ productId, quantity });
+    }
+};
+exports.addLine = addLine;
+const removeLine = (cart, productId) => {
+    cart.lines = cart.lines.filter(l => l.productId !== productId);
+};
+exports.removeLine = removeLine;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/catalog_models.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

Chapter 19/Beginning of Chapter/sportsstore/dist/data/catalog_repository.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

Chapter 19/Beginning of Chapter/sportsstore/dist/data/customer_models.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

Chapter 19/Beginning of Chapter/sportsstore/dist/data/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.order_repository = exports.catalog_repository = void 0;
+const orm_1 = require("./orm");
+const repo = new orm_1.CatalogRepoImpl();
+exports.catalog_repository = repo;
+exports.order_repository = repo;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/order_models.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

Chapter 19/Beginning of Chapter/sportsstore/dist/data/order_repository.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/core.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/index.js

@@ -0,0 +1,11 @@
+"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 order_queries_1 = require("./order_queries");
+const order_storage_1 = require("./order_storage");
+const CatalogRepo = (0, storage_1.AddStorage)((0, queries_1.AddQueries)(core_1.BaseRepo));
+const RepoWithOrders = (0, order_storage_1.AddOrderStorage)((0, order_queries_1.AddOrderQueries)(CatalogRepo));
+exports.CatalogRepoImpl = RepoWithOrders;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/catalog_helpers.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/catalog_models.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/customer_helpers.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeCustomerModels = void 0;
+const sequelize_1 = require("sequelize");
+const customer_models_1 = require("./customer_models");
+const initializeCustomerModels = (sequelize) => {
+    customer_models_1.CustomerModel.init({
+        id: { type: sequelize_1.DataTypes.INTEGER, autoIncrement: true, primaryKey: true },
+        name: { type: sequelize_1.DataTypes.STRING },
+        email: { type: sequelize_1.DataTypes.STRING }
+    }, { sequelize });
+};
+exports.initializeCustomerModels = initializeCustomerModels;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/customer_models.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerModel = void 0;
+const sequelize_1 = require("sequelize");
+class CustomerModel extends sequelize_1.Model {
+}
+exports.CustomerModel = CustomerModel;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/index.js

@@ -0,0 +1,16 @@
+"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");
+const customer_helpers_1 = require("./customer_helpers");
+const order_helpers_1 = require("./order_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);
+    (0, customer_helpers_1.initializeCustomerModels)(sequelize);
+    (0, order_helpers_1.initializeOrderModels)(sequelize);
+};
+exports.initializeModels = initializeModels;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/order_helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeOrderModels = void 0;
+const sequelize_1 = require("sequelize");
+const order_models_1 = require("./order_models");
+const customer_models_1 = require("./customer_models");
+const _1 = require(".");
+const primaryKey = {
+    id: { type: sequelize_1.DataTypes.INTEGER, autoIncrement: true, primaryKey: true }
+};
+const initializeOrderModels = (sequelize) => {
+    order_models_1.OrderModel.init({
+        ...primaryKey, shipped: sequelize_1.DataTypes.BOOLEAN
+    }, { sequelize });
+    order_models_1.ProductSelectionModel.init({
+        ...primaryKey,
+        quantity: sequelize_1.DataTypes.INTEGER, price: sequelize_1.DataTypes.DECIMAL(10, 2)
+    }, { sequelize });
+    order_models_1.AddressModel.init({
+        ...primaryKey,
+        street: sequelize_1.DataTypes.STRING, city: sequelize_1.DataTypes.STRING,
+        state: sequelize_1.DataTypes.STRING, zip: sequelize_1.DataTypes.STRING,
+    }, { sequelize });
+    order_models_1.OrderModel.belongsTo(customer_models_1.CustomerModel, { as: "customer" });
+    order_models_1.OrderModel.belongsTo(order_models_1.AddressModel, { foreignKey: "addressId", as: "address" });
+    order_models_1.OrderModel.belongsToMany(order_models_1.ProductSelectionModel, { through: "OrderProductJunction",
+        foreignKey: "orderId", as: "selections" });
+    order_models_1.ProductSelectionModel.belongsTo(_1.ProductModel, { as: "product" });
+};
+exports.initializeOrderModels = initializeOrderModels;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/models/order_models.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressModel = exports.ProductSelectionModel = exports.OrderModel = void 0;
+const sequelize_1 = require("sequelize");
+class OrderModel extends sequelize_1.Model {
+}
+exports.OrderModel = OrderModel;
+class ProductSelectionModel extends sequelize_1.Model {
+}
+exports.ProductSelectionModel = ProductSelectionModel;
+class AddressModel extends sequelize_1.Model {
+}
+exports.AddressModel = AddressModel;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/order_queries.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddOrderQueries = void 0;
+const order_models_1 = require("./models/order_models");
+const customer_models_1 = require("./models/customer_models");
+const queryConfig = {
+    include: [
+        { model: order_models_1.AddressModel, as: "address" },
+        { model: customer_models_1.CustomerModel, as: "customer" }
+    ],
+    raw: true, nest: true
+};
+function AddOrderQueries(Base) {
+    return class extends Base {
+        getOrder(id) {
+            return order_models_1.OrderModel.findByPk(id, queryConfig);
+        }
+        getOrders(excludeShipped) {
+            return order_models_1.OrderModel.findAll(excludeShipped ?
+                { ...queryConfig, where: { shipped: false } } : queryConfig);
+        }
+    };
+}
+exports.AddOrderQueries = AddOrderQueries;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/order_storage.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddOrderStorage = void 0;
+const order_models_1 = require("./models/order_models");
+const customer_models_1 = require("./models/customer_models");
+function AddOrderStorage(Base) {
+    return class extends Base {
+        storeOrder(order) {
+            return this.sequelize.transaction(async (transaction) => {
+                const { id, shipped } = order;
+                const [stored] = await order_models_1.OrderModel.upsert({ id, shipped }, { transaction });
+                if (order.customer) {
+                    const [{ id }] = await customer_models_1.CustomerModel.findOrCreate({
+                        where: { email: order.customer.email },
+                        defaults: order.customer,
+                        transaction
+                    });
+                    stored.customerId = id;
+                }
+                if (order.address) {
+                    const [{ id }] = await order_models_1.AddressModel.findOrCreate({
+                        where: { ...order.address },
+                        defaults: order.address,
+                        transaction
+                    });
+                    stored.addressId = id;
+                }
+                await stored.save({ transaction });
+                if (order.selections) {
+                    const sels = await order_models_1.ProductSelectionModel.bulkCreate(order.selections, { transaction });
+                    await stored.setSelections(sels, { transaction });
+                }
+                return stored;
+            });
+        }
+    };
+}
+exports.AddOrderStorage = AddOrderStorage;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/queries.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddQueries = void 0;
+const models_1 = require("./models");
+const sequelize_1 = require("sequelize");
+function AddQueries(Base) {
+    return class extends Base {
+        async getProducts(params) {
+            const opts = {};
+            if (params?.page && params.pageSize) {
+                opts.limit = params?.pageSize,
+                    opts.offset = (params.page - 1) * params.pageSize;
+            }
+            if (params?.searchTerm) {
+                const searchOp = { [sequelize_1.Op.like]: "%" + params.searchTerm + "%" };
+                opts.where = {
+                    [sequelize_1.Op.or]: { name: searchOp, description: searchOp }
+                };
+            }
+            if (params?.category) {
+                opts.where = {
+                    ...opts.where, categoryId: params.category
+                };
+            }
+            const result = await models_1.ProductModel.findAndCountAll({
+                include: [
+                    { model: models_1.SupplierModel, as: "supplier" },
+                    { model: models_1.CategoryModel, as: "category" }
+                ],
+                raw: true, nest: true,
+                ...opts
+            });
+            const categories = await this.getCategories();
+            return { products: result.rows, totalCount: result.count, categories };
+        }
+        getCategories() {
+            return models_1.CategoryModel.findAll({ raw: true, nest: true });
+        }
+        getSuppliers() {
+            return models_1.SupplierModel.findAll({ raw: true, nest: true });
+        }
+        getProductDetails(ids) {
+            return models_1.ProductModel.findAll({
+                where: { id: { [sequelize_1.Op.in]: ids } }, raw: true, nest: true,
+            });
+        }
+    };
+}
+exports.AddQueries = AddQueries;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/orm/storage.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/validation/basic_rules.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.no_op = exports.required = exports.email = exports.minLength = void 0;
+const validator_1 = __importDefault(require("validator"));
+const minLength = (min) => (status) => {
+    if (!validator_1.default.isLength(status.value, { min })) {
+        status.setInvalid(true);
+        status.messages.push(`Enter at least ${min} characters`);
+    }
+};
+exports.minLength = minLength;
+const email = (status) => {
+    if (!validator_1.default.isEmail(status.value)) {
+        status.setInvalid(true);
+        status.messages.push("Enter an email address");
+    }
+};
+exports.email = email;
+const required = (status) => {
+    if (validator_1.default.isEmpty(status.value.toString(), { ignore_whitespace: true })) {
+        status.setInvalid(true);
+        status.messages.push("A value is required");
+    }
+};
+exports.required = required;
+const no_op = (status) => { };
+exports.no_op = no_op;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/validation/index.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./validation_types"), exports);
+__exportStar(require("./validator"), exports);
+__exportStar(require("./basic_rules"), exports);
+__exportStar(require("./order_rules"), exports);

Chapter 19/Beginning of Chapter/sportsstore/dist/data/validation/order_rules.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressValidator = exports.CustomerValidator = void 0;
+const validator_1 = require("./validator");
+const basic_rules_1 = require("./basic_rules");
+exports.CustomerValidator = new validator_1.Validator({
+    name: [basic_rules_1.required, (0, basic_rules_1.minLength)(6)],
+    email: basic_rules_1.email
+});
+exports.AddressValidator = new validator_1.Validator({
+    street: basic_rules_1.required,
+    city: basic_rules_1.required,
+    state: basic_rules_1.required,
+    zip: basic_rules_1.no_op
+});

Chapter 19/Beginning of Chapter/sportsstore/dist/data/validation/validation_types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationStatus = void 0;
+class ValidationStatus {
+    value;
+    invalid = false;
+    constructor(value) {
+        this.value = value;
+    }
+    get isInvalid() {
+        return this.invalid;
+    }
+    setInvalid(newValue) {
+        this.invalid = newValue || this.invalid;
+    }
+    messages = [];
+}
+exports.ValidationStatus = ValidationStatus;

Chapter 19/Beginning of Chapter/sportsstore/dist/data/validation/validator.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getData = exports.isValid = exports.Validator = void 0;
+const validation_types_1 = require("./validation_types");
+class Validator {
+    rules;
+    breakOnInvalid;
+    constructor(rules, breakOnInvalid = true) {
+        this.rules = rules;
+        this.breakOnInvalid = breakOnInvalid;
+    }
+    async validate(data) {
+        const vdata = Object.entries(this.rules).map(async ([key, rules]) => {
+            const status = new validation_types_1.ValidationStatus(data?.[key] ?? "");
+            const rs = (Array.isArray(rules) ? rules : [rules]);
+            for (const r of rs) {
+                if (!status.isInvalid || !this.breakOnInvalid) {
+                    await r(status);
+                }
+            }
+            return [key, status];
+        });
+        const done = await Promise.all(vdata);
+        return Object.fromEntries(done);
+    }
+    validateOriginal(data) {
+        const vdata = Object.entries(this.rules).map(([key, rules]) => {
+            const status = new validation_types_1.ValidationStatus(data?.[key] ?? "");
+            (Array.isArray(rules) ? rules : [rules])
+                .forEach(async (rule) => {
+                if (!status.isInvalid || !this.breakOnInvalid) {
+                    await rule(status);
+                }
+            });
+            return [key, status];
+        });
+        return Object.fromEntries(vdata);
+    }
+}
+exports.Validator = Validator;
+function isValid(result) {
+    return Object.values(result)
+        .every(r => r.isInvalid === false);
+}
+exports.isValid = isValid;
+function getData(result) {
+    return Object.fromEntries(Object.entries(result)
+        .map(([key, status]) => [key, status.value]));
+}
+exports.getData = getData;

Chapter 19/Beginning of Chapter/sportsstore/dist/errors.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/helpers/cart_helpers.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countCartItems = void 0;
+const countCartItems = (cart) => cart.lines.reduce((total, line) => total + line.quantity, 0);
+exports.countCartItems = countCartItems;

Chapter 19/Beginning of Chapter/sportsstore/dist/helpers/catalog_helpers.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currency = exports.highlight = exports.categoryButtons = exports.pageSizeOptions = exports.pageButtons = exports.escapeUrl = exports.navigationUrl = void 0;
+const handlebars_1 = __importDefault(require("handlebars"));
+const querystring_1 = require("querystring");
+const querystring_2 = require("querystring");
+const getData = (options) => {
+    return { ...options.data.root, ...options.hash };
+};
+const navigationUrl = (options) => {
+    const { page, pageSize, category, searchTerm } = getData(options);
+    return "/?" + (0, querystring_1.stringify)({ page, pageSize, category, searchTerm });
+};
+exports.navigationUrl = navigationUrl;
+const escapeUrl = (url) => (0, querystring_2.escape)(url);
+exports.escapeUrl = escapeUrl;
+const pageButtons = (options) => {
+    const { page, pageCount } = getData(options);
+    let output = "";
+    for (let i = 1; i <= pageCount; i++) {
+        output += options.fn({
+            page, pageCount, index: i, selected: i === page
+        });
+    }
+    return output;
+};
+exports.pageButtons = pageButtons;
+const pageSizeOptions = (options) => {
+    const { pageSize } = getData(options);
+    let output = "";
+    [3, 6, 9].forEach(size => {
+        output += options.fn({ size,
+            selected: pageSize === size ? "selected" : "" });
+    });
+    return output;
+};
+exports.pageSizeOptions = pageSizeOptions;
+const categoryButtons = (options) => {
+    const { category, categories } = getData(options);
+    let output = "";
+    for (let i = 0; i < categories.length; i++) {
+        output += options.fn({
+            id: categories[i].id,
+            name: categories[i].name,
+            selected: category === categories[i].id
+        });
+    }
+    return output;
+};
+exports.categoryButtons = categoryButtons;
+const highlight = (value, options) => {
+    const { searchTerm } = getData(options);
+    if (searchTerm && searchTerm !== "") {
+        const regexp = new RegExp(searchTerm, "ig");
+        const mod = value.replaceAll(regexp, "<strong>$&</strong>");
+        return new handlebars_1.default.SafeString(mod);
+    }
+    return value;
+};
+exports.highlight = highlight;
+const formatter = new Intl.NumberFormat("en-us", {
+    style: "currency", currency: "USD"
+});
+const currency = (value) => {
+    return formatter.format(value);
+};
+exports.currency = currency;

Chapter 19/Beginning of Chapter/sportsstore/dist/helpers/env.js

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/dist/helpers/index.js

@@ -0,0 +1,44 @@
+"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 catalog_helpers = __importStar(require("./catalog_helpers"));
+const cart_helpers = __importStar(require("./cart_helpers"));
+const order_helpers = __importStar(require("./order_helpers"));
+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, ...catalog_helpers, ...cart_helpers,
+            ...order_helpers }
+    }));
+    app.set("view engine", "handlebars");
+};
+exports.createTemplates = createTemplates;

Chapter 19/Beginning of Chapter/sportsstore/dist/helpers/order_helpers.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get = exports.getValue = exports.lower = exports.toArray = void 0;
+const toArray = (...args) => args.slice(0, -1);
+exports.toArray = toArray;
+const lower = (val) => val.toLowerCase();
+exports.lower = lower;
+const getValue = (val, prop) => val?.[prop.toLowerCase()] ?? {};
+exports.getValue = getValue;
+const get = (val) => val ?? {};
+exports.get = get;

Chapter 19/Beginning of Chapter/sportsstore/dist/routes/cart.js

@@ -0,0 +1,61 @@
+"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.createCartRoutes = exports.createCartMiddleware = void 0;
+const querystring_1 = require("querystring");
+const cart_models_1 = require("../data/cart_models");
+const cart_helpers = __importStar(require("../data/cart_helpers"));
+const createCartMiddleware = (app) => {
+    app.use((req, resp, next) => {
+        resp.locals.cart = req.session.cart = req.session.cart ?? (0, cart_models_1.createCart)();
+        next();
+    });
+};
+exports.createCartMiddleware = createCartMiddleware;
+const createCartRoutes = (app) => {
+    app.post("/cart", (req, resp) => {
+        const productId = Number.parseInt(req.body.productId);
+        if (isNaN(productId)) {
+            throw new Error("ID  must be an integer");
+        }
+        (0, cart_models_1.addLine)(req.session.cart, productId, 1);
+        resp.redirect(`/cart?returnUrl=${(0, querystring_1.escape)(req.body.returnUrl ?? "/")}`);
+    });
+    app.get("/cart", async (req, resp) => {
+        const cart = req.session.cart;
+        resp.render("cart", {
+            cart: await cart_helpers.getCartDetail(cart),
+            returnUrl: (0, querystring_1.unescape)(req.query.returnUrl?.toString() ?? "/")
+        });
+    });
+    app.post("/cart/remove", (req, resp) => {
+        const id = Number.parseInt(req.body.id);
+        if (!isNaN(id)) {
+            (0, cart_models_1.removeLine)(req.session.cart, id);
+        }
+        resp.redirect(`/cart?returnUrl=${(0, querystring_1.escape)(req.body.returnUrl ?? "/")}`);
+    });
+};
+exports.createCartRoutes = createCartRoutes;

Chapter 19/Beginning of Chapter/sportsstore/dist/routes/catalog.js

@@ -0,0 +1,19 @@
+"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 page = Number.parseInt(req.query.page?.toString() ?? "1");
+        const pageSize = Number.parseInt(req.query.pageSize?.toString() ?? "3");
+        const searchTerm = req.query.searchTerm?.toString();
+        const category = Number.parseInt(req.query.category?.toString() ?? "");
+        const res = await data_1.catalog_repository.getProducts({ page, pageSize,
+            searchTerm, category });
+        resp.render("index", { ...res, page, pageSize,
+            pageCount: Math.ceil(res.totalCount / (pageSize ?? 1)),
+            searchTerm, category, show_cart: true
+        });
+    });
+};
+exports.createCatalogRoutes = createCatalogRoutes;

Chapter 19/Beginning of Chapter/sportsstore/dist/routes/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRoutes = void 0;
+const catalog_1 = require("./catalog");
+const cart_1 = require("./cart");
+const orders_1 = require("./orders");
+const createRoutes = (app) => {
+    (0, cart_1.createCartMiddleware)(app);
+    (0, catalog_1.createCatalogRoutes)(app);
+    (0, cart_1.createCartRoutes)(app);
+    (0, orders_1.createOrderRoutes)(app);
+};
+exports.createRoutes = createRoutes;

Chapter 19/Beginning of Chapter/sportsstore/dist/routes/order_helpers.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAndStoreOrder = void 0;
+const data_1 = require("../data");
+const createAndStoreOrder = async (customer, address, cart) => {
+    const product_ids = cart.lines.map(l => l.productId) ?? [];
+    const product_details = Object.fromEntries((await data_1.catalog_repository.getProductDetails(product_ids))
+        .map(p => [p.id ?? 0, p.price ?? 0]));
+    const selections = cart.lines.map(l => ({
+        productId: l.productId, quantity: l.quantity,
+        price: product_details[l.productId]
+    }));
+    return data_1.order_repository.storeOrder({
+        customer, address,
+        selections, shipped: false
+    });
+};
+exports.createAndStoreOrder = createAndStoreOrder;

Chapter 19/Beginning of Chapter/sportsstore/dist/routes/orders.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOrderRoutes = void 0;
+const validation_1 = require("../data/validation");
+const order_helpers_1 = require("./order_helpers");
+const createOrderRoutes = (app) => {
+    app.get("/checkout", (req, resp) => {
+        req.session.pageSize =
+            req.session.pageSize ?? req.query.pageSize?.toString() ?? "3";
+        resp.render("order_details", {
+            order: req.session.orderData,
+            page: 1,
+            pageSize: req.session.pageSize
+        });
+    });
+    app.post("/checkout", async (req, resp) => {
+        const { customer, address } = req.body;
+        const data = req.session.orderData = {
+            customer: await validation_1.CustomerValidator.validate(customer),
+            address: await validation_1.AddressValidator.validate(address)
+        };
+        if ((0, validation_1.isValid)(data.customer) && (0, validation_1.isValid)(data.address)
+            && req.session.cart) {
+            const order = await (0, order_helpers_1.createAndStoreOrder)((0, validation_1.getData)(data.customer), (0, validation_1.getData)(data.address), req.session.cart);
+            resp.redirect(`/checkout/${order.id}`);
+            req.session.cart = undefined;
+            req.session.orderData = undefined;
+        }
+        else {
+            resp.redirect("/checkout");
+        }
+    });
+    app.get("/checkout/:id", (req, resp) => {
+        resp.render("order_complete", {
+            id: req.params.id,
+            pageSize: req.session.pageSize ?? 3
+        });
+    });
+};
+exports.createOrderRoutes = createOrderRoutes;

Chapter 19/Beginning of Chapter/sportsstore/dist/server.js

@@ -0,0 +1,26 @@
+"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 sessions_1 = require("./sessions");
+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"));
+expressApp.use(express_1.default.static("node_modules/bootstrap-icons"));
+(0, helpers_1.createTemplates)(expressApp);
+(0, sessions_1.createSessions)(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}`));

Chapter 19/Beginning of Chapter/sportsstore/dist/sessions.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessions = void 0;
+const sequelize_1 = require("sequelize");
+const config_1 = require("./config");
+const express_session_1 = __importDefault(require("express-session"));
+const connect_session_sequelize_1 = __importDefault(require("connect-session-sequelize"));
+const config = (0, config_1.getConfig)("sessions");
+const secret = (0, config_1.getSecret)("COOKIE_SECRET");
+const logging = config.orm.logging
+    ? { logging: console.log, logQueryParameters: true }
+    : { logging: false };
+const createSessions = (app) => {
+    const sequelize = new sequelize_1.Sequelize({
+        ...config.orm.settings, ...logging
+    });
+    const store = new ((0, connect_session_sequelize_1.default)(express_session_1.default.Store))({
+        db: sequelize
+    });
+    if (config.reset_db === true) {
+        sequelize.drop().then(() => store.sync());
+    }
+    else {
+        store.sync();
+    }
+    app.use((0, express_session_1.default)({
+        secret, store,
+        resave: true, saveUninitialized: false,
+        cookie: { maxAge: config.maxAgeHrs * 60 * 60 * 1000,
+            sameSite: "strict" }
+    }));
+};
+exports.createSessions = createSessions;

Chapter 19/Beginning of Chapter/sportsstore/package.json

@@ -0,0 +1,46 @@
+{
+    "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/cookie-parser": "^1.4.6",
+        "@types/express": "^4.17.20",
+        "@types/express-session": "^1.17.10",
+        "@types/node": "^20.6.1",
+        "@types/validator": "^13.11.5",
+        "nodemon": "^3.0.3",
+        "tsc-watch": "^6.0.4",
+        "typescript": "^5.2.2"
+    },
+    "dependencies": {
+        "bootstrap": "^5.3.2",
+        "bootstrap-icons": "^1.11.3",
+        "connect-session-sequelize": "^7.1.7",
+        "dotenv": "^16.4.4",
+        "express": "^4.18.2",
+        "express-async-errors": "^3.1.1",
+        "express-handlebars": "^7.1.2",
+        "express-session": "^1.17.3",
+        "handlebars": "^4.7.8",
+        "helmet": "^7.1.0",
+        "sequelize": "^6.35.1",
+        "sqlite3": "^5.1.6",
+        "validator": "^13.11.0"
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/products.json

@@ -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 }            
+    ]
+}

Chapter 19/Beginning of Chapter/sportsstore/server.config.json

@@ -0,0 +1,39 @@
+{
+    "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"            
+        }
+    },
+    "sessions": {
+        "maxAgeHrs": 2,
+        "reset_db": true,
+        "orm": {
+            "settings": {
+                "dialect": "sqlite",
+                "storage": "sessions.db"
+            }, 
+            "logging": true
+        }
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/config/environment.ts

@@ -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;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/config/index.ts

@@ -0,0 +1,36 @@
+import { readFileSync } from "fs";
+import { getEnvironment, Env } from "./environment";
+import { merge } from "./merge";
+import { config as dotenvconfig } from "dotenv";
+
+const file = process.env.SERVER_CONFIG ?? "server.config.json"
+const data = JSON.parse(readFileSync(file).toString());
+
+dotenvconfig({
+    path: getEnvironment().toString() + ".env"
+})
+
+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) => {
+    const paths = path.split(":");
+    let val = data;
+    paths.forEach(p => val = val[p]);
+    return val ?? defaultVal;
+}
+
+export const getSecret = (name: string) => {
+    const secret = process.env[name];
+    if (secret === undefined) {
+        throw new Error(`Undefined secret: ${name}`);
+    }
+    return secret;
+} 
+
+export { getEnvironment, Env };

Chapter 19/Beginning of Chapter/sportsstore/src/config/merge.ts

@@ -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];
+        }
+    });
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/cart_helpers.ts

@@ -0,0 +1,30 @@
+import { catalog_repository } from ".";
+import { Cart } from "./cart_models";
+import { Product } from "./catalog_models"
+
+export interface CartDetail {
+    lines: {
+        product: Product,
+        quantity: number, 
+        subtotal: number
+    }[],
+    total: number;
+}
+
+export const getCartDetail = async (cart: Cart) : Promise<CartDetail> => {
+ 
+    const ids = cart.lines.map(l => l.productId);
+    const db_data = await catalog_repository.getProductDetails(ids);
+
+    const products = Object.fromEntries(db_data.map(p => [p.id, p]));
+
+    const lines = cart.lines.map(line => ({ 
+        product: products[line.productId],
+        quantity: line.quantity,
+        subtotal: products[line.productId].price * line.quantity
+    }));
+
+    const total = lines.reduce((total, line) => total + line.subtotal, 0);
+
+    return { lines, total }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/cart_models.ts

@@ -0,0 +1,23 @@
+export interface CartLine {
+    productId: number;
+    quantity: number;
+}
+
+export interface Cart {
+    lines: CartLine[];
+}
+
+export const createCart = () : Cart => ({ lines: [] });
+
+export const addLine = (cart: Cart, productId: number, quantity: number) => {
+    const line = cart.lines.find(l => l.productId == productId);
+    if (line !== undefined) {
+        line.quantity += quantity;
+    } else {
+        cart.lines.push({ productId, quantity })
+    }
+}
+
+export const removeLine = (cart: Cart, productId: number) => {
+    cart.lines = cart.lines.filter(l => l.productId !== productId);
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/catalog_models.ts

@@ -0,0 +1,36 @@
+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[];
+}
+
+export interface ProductQueryParameters {
+    pageSize?: number;
+    page?: number;
+    category?: number;
+    searchTerm?: string;
+}
+
+export interface ProductQueryResult {
+    products: Product[];
+    totalCount: number;
+    categories: Category[];
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/catalog_repository.ts

@@ -0,0 +1,19 @@
+import { Category, Product, Supplier, ProductQueryParameters,
+    ProductQueryResult } from "./catalog_models";
+
+export interface CatalogRepository {
+
+    getProducts(params?: ProductQueryParameters): Promise<ProductQueryResult>;
+
+    getProductDetails(ids: number[]): Promise<Product[]>;
+
+    storeProduct(p: Product): Promise<Product>;
+
+    getCategories() : Promise<Category[]>;
+
+    storeCategory(c: Category): Promise<Category>;
+
+    getSuppliers(): Promise<Supplier[]>;
+
+    storeSupplier(s: Supplier): Promise<Supplier>;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/customer_models.ts

@@ -0,0 +1,5 @@
+export interface Customer {
+    id?: number;
+    name: string;
+    email: string;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/index.ts

@@ -0,0 +1,8 @@
+import { CatalogRepository } from "./catalog_repository";
+import { CatalogRepoImpl} from "./orm";
+import { OrderRepository } from "./order_repository";
+
+const repo = new CatalogRepoImpl();
+
+export const catalog_repository: CatalogRepository = repo;
+export const order_repository: OrderRepository = repo;

Chapter 19/Beginning of Chapter/sportsstore/src/data/order_models.ts

@@ -0,0 +1,27 @@
+import { Product } from "./catalog_models";
+import { Customer } from "./customer_models";
+
+export interface Order {
+    id?: number;
+
+    customer?: Customer;
+    selections?: ProductSelection[];
+    address?: Address;
+
+    shipped: boolean;
+}
+
+export interface ProductSelection {
+    id?: number;
+    productId?: number;
+    quantity: number;
+    price: number;
+}
+
+export interface Address {
+    id?: number;
+    street: string;
+    city: string;
+    state: string;
+    zip: string;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/order_repository.ts

@@ -0,0 +1,10 @@
+import { Order } from "./order_models";
+
+export interface OrderRepository {
+
+    getOrder(id: number): Promise<Order| null>;
+
+    getOrders(excludeShipped: boolean): Promise<Order[]>;
+
+    storeOrder(order: Order): Promise<Order>;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/core.ts

@@ -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;

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/index.ts

@@ -0,0 +1,10 @@
+import { BaseRepo } from "./core";
+import { AddQueries } from "./queries";
+import { AddStorage } from "./storage";
+import { AddOrderQueries } from "./order_queries";
+import { AddOrderStorage } from "./order_storage";
+
+const CatalogRepo = AddStorage(AddQueries(BaseRepo));
+const RepoWithOrders = AddOrderStorage(AddOrderQueries(CatalogRepo));
+
+export const CatalogRepoImpl = RepoWithOrders;

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/catalog_helpers.ts

@@ -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"});
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/catalog_models.ts

@@ -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>[];
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/customer_helpers.ts

@@ -0,0 +1,11 @@
+import { DataTypes, Sequelize } from "sequelize";
+import { CustomerModel } from "./customer_models";
+
+export const initializeCustomerModels = (sequelize: Sequelize) => {
+
+    CustomerModel.init({
+        id: { type: DataTypes.INTEGER, autoIncrement: true, primaryKey: true},
+        name: { type: DataTypes.STRING},        
+        email: { type: DataTypes.STRING }
+    }, { sequelize})
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/customer_models.ts

@@ -0,0 +1,11 @@
+import { Model, CreationOptional, InferAttributes, InferCreationAttributes } 
+    from "sequelize";
+import { Customer } from "../../customer_models";
+
+export class CustomerModel extends Model<InferAttributes<CustomerModel>, 
+        InferCreationAttributes<CustomerModel>> implements Customer {
+
+    declare id?: CreationOptional<number>;
+    declare name: string;
+    declare email: string;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/index.ts

@@ -0,0 +1,12 @@
+import { Sequelize } from "sequelize";
+import { initializeCatalogModels } from "./catalog_helpers";
+import { initializeCustomerModels } from "./customer_helpers";
+import { initializeOrderModels } from "./order_helpers";
+
+export { ProductModel, CategoryModel, SupplierModel } from "./catalog_models";
+
+export const initializeModels = (sequelize: Sequelize) => {
+    initializeCatalogModels(sequelize);
+    initializeCustomerModels(sequelize);
+    initializeOrderModels(sequelize);
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/order_helpers.ts

@@ -0,0 +1,35 @@
+import { DataTypes, Sequelize } from "sequelize";
+import { OrderModel, ProductSelectionModel, AddressModel } 
+    from "./order_models";
+import { CustomerModel } from "./customer_models";
+import { ProductModel } from ".";
+
+const primaryKey = {
+    id: { type: DataTypes.INTEGER, autoIncrement: true, primaryKey: true }
+};
+    
+export const initializeOrderModels = (sequelize: Sequelize) => {
+
+    OrderModel.init({
+        ...primaryKey, shipped: DataTypes.BOOLEAN
+    }, {sequelize});
+
+    ProductSelectionModel.init({
+        ...primaryKey,
+        quantity: DataTypes.INTEGER, price: DataTypes.DECIMAL(10, 2) 
+    }, {sequelize});
+
+    AddressModel.init({
+        ...primaryKey,
+        street: DataTypes.STRING, city: DataTypes.STRING,
+        state: DataTypes.STRING, zip: DataTypes.STRING,
+    }, {sequelize});
+
+    OrderModel.belongsTo(CustomerModel, { as: "customer"});
+    OrderModel.belongsTo(AddressModel, 
+        {foreignKey: "addressId", as: "address"});
+    OrderModel.belongsToMany(ProductSelectionModel, 
+        { through: "OrderProductJunction", 
+            foreignKey: "orderId", as: "selections" });
+    ProductSelectionModel.belongsTo(ProductModel, { as: "product"});
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/models/order_models.ts

@@ -0,0 +1,52 @@
+import { Model, CreationOptional, ForeignKey, InferAttributes, 
+    InferCreationAttributes,  
+    HasManySetAssociationsMixin} from "sequelize";
+import { ProductModel } from "./catalog_models";
+import { CustomerModel } from "./customer_models";
+import { Address, Order, ProductSelection } from "../../order_models";
+
+export class OrderModel extends Model<InferAttributes<OrderModel>, 
+        InferCreationAttributes<OrderModel>> implements Order {
+
+    declare id?: CreationOptional<number>;
+    declare shipped: boolean;
+
+    declare customerId: ForeignKey<CustomerModel["id"]>;
+    declare customer?: InferAttributes<CustomerModel>
+
+    declare addressId: ForeignKey<AddressModel["id"]>;
+    declare address?: InferAttributes<AddressModel>;
+    
+    declare selections?:  InferAttributes<ProductSelectionModel>[];
+
+    declare setSelections: 
+        HasManySetAssociationsMixin<ProductSelectionModel, number>;
+}
+
+export class ProductSelectionModel extends 
+        Model<InferAttributes<ProductSelectionModel>, 
+            InferCreationAttributes<ProductSelectionModel>>
+        implements ProductSelection { 
+
+    declare id?: CreationOptional<number>;
+    
+    declare productId: ForeignKey<ProductModel["id"]>;
+    declare product?: InferAttributes<ProductModel>
+
+    declare quantity: number;
+    declare price: number;
+
+    declare orderId: ForeignKey<OrderModel["id"]>;
+    declare order?: InferAttributes<OrderModel>;
+}
+
+export class AddressModel extends Model<InferAttributes<AddressModel>, 
+    InferCreationAttributes<AddressModel>> implements Address {
+
+    declare id?: CreationOptional<number>;
+
+    declare street: string;
+    declare city: string;
+    declare state: string;
+    declare zip: string;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/order_queries.ts

@@ -0,0 +1,31 @@
+import { Attributes, FindOptions } from "sequelize";
+import { Order } from "../order_models"
+import { BaseRepo, Constructor } from "./core"
+import { AddressModel, OrderModel } from "./models/order_models";
+import { CustomerModel } from "./models/customer_models";
+
+const queryConfig: FindOptions<Attributes<OrderModel>> = {
+    include: [
+        { model: AddressModel, as: "address"}, 
+        { model: CustomerModel, as: "customer" }
+    ], 
+    raw: true, nest: true
+}
+
+export function AddOrderQueries<TBase 
+        extends Constructor<BaseRepo>>(Base: TBase)  {
+
+    return class extends Base {
+
+        getOrder(id: number) : Promise<Order | null> {
+            return OrderModel.findByPk(id, queryConfig);
+        }
+
+        getOrders(excludeShipped: boolean): Promise<Order[]> {
+            return OrderModel.findAll(
+                excludeShipped ? 
+                    { ...queryConfig, where: { shipped: false}} : queryConfig
+            )            
+        }
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/order_storage.ts

@@ -0,0 +1,47 @@
+import { Order } from "../order_models"
+import { BaseRepo, Constructor } from "./core"
+import { AddressModel, OrderModel, ProductSelectionModel } 
+    from "./models/order_models";
+import { CustomerModel } from "./models/customer_models";
+
+export function AddOrderStorage<TBase extends 
+        Constructor<BaseRepo>>(Base: TBase)  {
+
+    return class extends Base {
+
+        storeOrder(order: Order): Promise<Order> {
+            return  this.sequelize.transaction(async (transaction) => {
+                const { id, shipped } = order;
+                const [stored] = 
+                    await OrderModel.upsert({ id, shipped }, {transaction});
+                
+                if (order.customer) {
+
+                    const [{id}] = await CustomerModel.findOrCreate({
+                        where: { email: order.customer.email}, 
+                        defaults: order.customer,
+                        transaction
+                    });
+                    stored.customerId = id;
+                }
+                if (order.address) {
+                    
+                    const [{id}] = await AddressModel.findOrCreate({
+                        where: { ...order.address },
+                        defaults: order.address,
+                        transaction
+                    });
+                    stored.addressId = id;
+                }
+                await stored.save({transaction});
+                if (order.selections) {
+                    const sels = await ProductSelectionModel.bulkCreate(
+                        order.selections, { transaction});
+                    await stored.setSelections(
+                        sels, { transaction });
+                }
+                return stored;
+            });
+        }
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/queries.ts

@@ -0,0 +1,51 @@
+import { CategoryModel, ProductModel, SupplierModel } from "./models";
+import { BaseRepo, Constructor } from "./core"
+import { ProductQueryParameters } from "../catalog_models";
+import { Op } from "sequelize";
+
+export function AddQueries<TBase extends Constructor<BaseRepo>>(Base: TBase) {
+    return class extends Base {
+    
+        async getProducts(params?: ProductQueryParameters) {
+            const opts: any = {};
+            if (params?.page && params.pageSize) {
+                opts.limit = params?.pageSize,
+                opts.offset = (params.page -1) * params.pageSize                
+            }
+            if(params?.searchTerm) {
+                const searchOp = { [Op.like]: "%" + params.searchTerm + "%"};
+                opts.where = {
+                    [Op.or]: { name: searchOp, description: searchOp }
+                }
+            }
+            if (params?.category) {
+                opts.where = { 
+                    ...opts.where,  categoryId: params.category
+                }
+            }
+            const result = await ProductModel.findAndCountAll({                
+                include: [
+                    {model: SupplierModel, as: "supplier" },
+                    {model: CategoryModel, as: "category"}],
+                raw: true, nest: true,
+                ...opts
+            });               
+            const categories = await this.getCategories();
+            return { products: result.rows, totalCount: result.count, categories };
+        }
+
+        getCategories() {
+            return CategoryModel.findAll({raw: true, nest: true})
+        }
+    
+        getSuppliers() {
+            return SupplierModel.findAll({raw: true, nest: true});
+        }        
+
+        getProductDetails(ids: number[]) {
+            return ProductModel.findAll({
+                where: { id: { [Op.in]: ids }}, raw: true, nest: true, 
+            });
+        }
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/orm/storage.ts

@@ -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;
+        }       
+    }
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/validation/basic_rules.ts

@@ -0,0 +1,25 @@
+import validator from "validator";
+import { ValidationStatus } from "./validation_types";
+
+export const minLength = (min: number) => (status: ValidationStatus) => {
+    if (!validator.isLength(status.value, { min })) {
+        status.setInvalid(true);
+        status.messages.push(`Enter at least ${min} characters`);
+    } 
+};
+
+export const email = (status: ValidationStatus) => {
+    if (!validator.isEmail(status.value)) {
+        status.setInvalid(true);
+        status.messages.push("Enter an email address");
+    }
+};
+
+export const required = (status: ValidationStatus) => {
+    if (validator.isEmpty(status.value.toString(), { ignore_whitespace: true})) {
+        status.setInvalid(true);
+        status.messages.push("A value is required");
+    }
+};
+
+export const no_op = (status: ValidationStatus) => { /* do nothing */ }

Chapter 19/Beginning of Chapter/sportsstore/src/data/validation/index.ts

@@ -0,0 +1,4 @@
+export * from "./validation_types";
+export * from "./validator";
+export * from "./basic_rules";
+export * from "./order_rules";

Chapter 19/Beginning of Chapter/sportsstore/src/data/validation/order_rules.ts

@@ -0,0 +1,16 @@
+import { Validator } from "./validator";
+import { required, minLength, email, no_op } from "./basic_rules";
+import { Address } from "../order_models";
+import { Customer } from "../customer_models";
+
+export const CustomerValidator = new Validator<Customer>({
+    name: [required, minLength(6)],
+    email: email
+});
+
+export const AddressValidator = new Validator<Address>({
+    street: required,
+    city: required, 
+    state: required,
+    zip: no_op
+});

Chapter 19/Beginning of Chapter/sportsstore/src/data/validation/validation_types.ts

@@ -0,0 +1,26 @@
+export class ValidationStatus {
+    private invalid: boolean = false;
+
+    constructor(public readonly value: any) {}
+
+    get isInvalid() : boolean  {
+        return this.invalid
+    }
+
+    setInvalid(newValue: boolean) {
+        this.invalid = newValue || this.invalid;
+    }
+    
+    messages: string[] = [];
+}
+
+export type ValidationRule = (status: ValidationStatus) 
+    => void | Promise<void>;
+
+export type ValidationRuleSet<T> = {
+    [key in keyof Omit<Required<T>, "id">]: ValidationRule | ValidationRule[];
+}
+
+export type ValidationResults<T> = {
+    [key in keyof Omit<Required<T>, "id">]: ValidationStatus;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/data/validation/validator.ts

@@ -0,0 +1,47 @@
+import { ValidationResults, ValidationRule, ValidationRuleSet, 
+    ValidationStatus } from "./validation_types";
+
+export class Validator<T>{
+
+    constructor(public rules: ValidationRuleSet<T>, 
+        public breakOnInvalid = true) {}
+
+        async validate(data: any): Promise<ValidationResults<T>> {
+            const vdata = Object.entries(this.rules).map(async ([key, rules]) => {
+                const status = new ValidationStatus(data?.[key] ?? "");
+                const rs = (Array.isArray(rules) ? rules: [rules]);
+                for (const r of rs) {
+                    if (!status.isInvalid || !this.breakOnInvalid) {
+                        await r(status);
+                    }
+                }
+                return [key, status];
+            });
+            const done = await Promise.all(vdata);
+            return Object.fromEntries(done);
+        }
+
+    validateOriginal(data: any): ValidationResults<T> {
+        const vdata = Object.entries(this.rules).map(([key, rules]) => {
+            const status = new ValidationStatus(data?.[key] ?? "");
+            (Array.isArray(rules) ? rules: [rules])
+                .forEach(async (rule: ValidationRule) => {
+                    if (!status.isInvalid || !this.breakOnInvalid) {
+                        await rule(status);
+                    }
+            });
+            return [key, status];
+        });
+        return Object.fromEntries(vdata);
+    }
+}
+
+export function isValid<T>(result: ValidationResults<T>) {
+    return Object.values<ValidationStatus>(result)
+        .every(r => r.isInvalid === false);
+}
+
+export function getData<T>(result: ValidationResults<T>): T {
+    return Object.fromEntries (Object.entries<ValidationStatus>(result)
+        .map(([key, status]) => [key, status.value])) as T;
+}

Chapter 19/Beginning of Chapter/sportsstore/src/errors.ts

@@ -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);
+}

Chapter 19/Beginning of Chapter/sportsstore/src/helpers/cart_helpers.ts

@@ -0,0 +1,4 @@
+import { Cart } from "../data/cart_models";
+
+export const countCartItems = (cart: Cart) : number => 
+    cart.lines.reduce((total, line) => total + line.quantity, 0);

Chapter 19/Beginning of Chapter/sportsstore/src/helpers/catalog_helpers.ts

@@ -0,0 +1,68 @@
+import Handlebars, { HelperOptions }  from "handlebars";
+import { stringify } from "querystring";
+import { escape } from "querystring";
+
+const getData = (options:HelperOptions) => {
+     return {...options.data.root, ...options.hash}
+};
+
+export const navigationUrl = (options: HelperOptions) => {
+    const { page, pageSize, category, searchTerm } = getData(options);
+    return "/?" + stringify({ page, pageSize, category, searchTerm  });
+}
+
+export const escapeUrl = (url: string) => escape(url);
+
+export const pageButtons = (options: HelperOptions) => {
+    const { page, pageCount } = getData(options);
+
+    let output = "";
+    for (let i = 1; i <= pageCount; i++) {
+        output += options.fn({
+            page, pageCount, index: i, selected: i === page
+        });
+    }
+    return output;
+}
+
+export const pageSizeOptions = (options: HelperOptions) => {
+    const { pageSize } = getData(options);
+    let output = "";
+    [3, 6, 9].forEach(size => {
+        output += options.fn({ size, 
+            selected: pageSize === size ? "selected": ""})
+    })
+    return output;
+}
+
+export const categoryButtons = (options: HelperOptions) => {
+    const { category, categories } = getData(options);
+
+    let output = "";
+    for (let i = 0; i < categories.length; i++) {
+        output += options.fn({
+            id: categories[i].id,
+            name: categories[i].name, 
+            selected: category === categories[i].id
+        })
+    }
+    return output;
+}
+
+export const highlight = (value: string, options: HelperOptions) => {
+    const { searchTerm } = getData(options);
+    if (searchTerm && searchTerm !== "") {
+        const regexp = new RegExp(searchTerm, "ig");
+        const mod = value.replaceAll(regexp, "<strong>$&</strong>");
+        return new Handlebars.SafeString(mod);       
+    }
+    return value; 
+}
+
+const formatter = new Intl.NumberFormat("en-us", {
+    style: "currency", currency: "USD"
+})
+
+export const currency = (value: number) => {
+    return formatter.format(value);
+}

Chapter 19/Beginning of Chapter/sportsstore/src/helpers/env.ts

@@ -0,0 +1,5 @@
+import { Env, getEnvironment } from "../config";
+
+export const isDevelopment = (value: any) => {
+    return getEnvironment() === Env.Development
+}

Chapter 19/Beginning of Chapter/sportsstore/src/helpers/index.ts

@@ -0,0 +1,21 @@
+import { Express } from "express";
+import { getConfig } from "../config";
+import { engine } from "express-handlebars";
+import * as env_helpers from "./env";
+import * as catalog_helpers from "./catalog_helpers";
+import * as cart_helpers from "./cart_helpers";
+import * as order_helpers from "./order_helpers";
+
+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, ...catalog_helpers, ...cart_helpers, 
+                    ...order_helpers}
+    }));
+    app.set("view engine", "handlebars");
+}

Chapter 19/Beginning of Chapter/sportsstore/src/helpers/order_helpers.ts

@@ -0,0 +1,8 @@
+export const toArray = (...args: any[]) => args.slice(0, -1);
+
+export const lower = (val: string) => val.toLowerCase();
+
+export const getValue = (val: any, prop: string) => 
+    val?.[prop.toLowerCase()] ?? {};
+
+export const get = (val: any) => val ?? {};

Chapter 19/Beginning of Chapter/sportsstore/src/routes/cart.ts

@@ -0,0 +1,45 @@
+import { Express } from "express";
+import { escape, unescape } from "querystring";
+import { Cart, addLine, createCart, removeLine } from "../data/cart_models";
+import * as cart_helpers from "../data/cart_helpers";
+
+declare module "express-session" {
+    interface SessionData {
+       cart?: Cart;
+    }
+}
+
+export const createCartMiddleware = (app: Express) => {
+    app.use((req, resp, next) => {
+        resp.locals.cart = req.session.cart = req.session.cart ?? createCart()
+        next();
+    })
+}
+
+export const createCartRoutes = (app: Express) => {
+    
+    app.post("/cart", (req, resp) => {
+        const productId = Number.parseInt(req.body.productId);
+        if (isNaN(productId)) {
+            throw new Error("ID  must be an integer");
+        }
+        addLine(req.session.cart as Cart, productId, 1);
+        resp.redirect(`/cart?returnUrl=${escape(req.body.returnUrl ?? "/")}`);
+    });
+
+    app.get("/cart", async (req, resp) => {
+        const cart = req.session.cart as Cart;
+        resp.render("cart", {
+            cart: await cart_helpers.getCartDetail(cart),
+            returnUrl: unescape(req.query.returnUrl?.toString() ?? "/")
+        });
+    });
+
+    app.post("/cart/remove", (req, resp) => {
+        const id = Number.parseInt(req.body.id);
+        if (!isNaN(id)) {
+            removeLine(req.session.cart as Cart, id);
+        }
+        resp.redirect(`/cart?returnUrl=${escape(req.body.returnUrl ?? "/")}`);
+    });
+}

Chapter 19/Beginning of Chapter/sportsstore/src/routes/catalog.ts

@@ -0,0 +1,20 @@
+import { Express } from "express";
+import { catalog_repository } from "../data";
+
+export const createCatalogRoutes = (app: Express) => {
+
+    app.get("/", async (req, resp) => {
+        const page = Number.parseInt(req.query.page?.toString() ?? "1");
+        const pageSize =Number.parseInt(req.query.pageSize?.toString() ?? "3")
+        const searchTerm = req.query.searchTerm?.toString();
+        const category = Number.parseInt(req.query.category?.toString() ?? "")
+
+        const res = await catalog_repository.getProducts({ page, pageSize, 
+            searchTerm, category});
+
+        resp.render("index", { ...res, page, pageSize, 
+            pageCount: Math.ceil(res.totalCount / (pageSize ?? 1)), 
+            searchTerm, category, show_cart: true
+        });
+    });
+}

Chapter 19/Beginning of Chapter/sportsstore/src/routes/index.ts

@@ -0,0 +1,13 @@
+import { Express } from "express";
+import { createCatalogRoutes } from "./catalog";
+import { createCartMiddleware, createCartRoutes } from "./cart";
+import { createOrderRoutes } from "./orders";
+
+export const createRoutes = (app: Express) => {
+
+    createCartMiddleware(app);
+
+    createCatalogRoutes(app);
+    createCartRoutes(app);
+    createOrderRoutes(app);
+}

Chapter 19/Beginning of Chapter/sportsstore/src/routes/order_helpers.ts

@@ -0,0 +1,23 @@
+import { catalog_repository, order_repository } from "../data";
+import { Cart } from "../data/cart_models"
+import { Customer } from "../data/customer_models"
+import { Address, Order } from "../data/order_models"
+
+export const createAndStoreOrder = async (customer: Customer, 
+        address: Address, cart: Cart): Promise<Order> => {
+
+    const product_ids = cart.lines.map(l => l.productId) ?? [];
+
+    const product_details = Object.fromEntries((await 
+        catalog_repository.getProductDetails(product_ids))
+            .map(p => [p.id ?? 0, p.price ?? 0]));
+
+    const selections = cart.lines.map(l => ({ 
+        productId: l.productId, quantity: l.quantity, 
+        price: product_details[l.productId]}));
+
+    return order_repository.storeOrder({    
+        customer,address,
+        selections, shipped: false
+    });
+}

Chapter 19/Beginning of Chapter/sportsstore/src/routes/orders.ts

@@ -0,0 +1,58 @@
+import { Express } from "express";
+import { Address } from "../data/order_models";
+import { AddressValidator, CustomerValidator, ValidationResults, getData, isValid } 
+    from "../data/validation";
+import { Customer } from "../data/customer_models";
+import { createAndStoreOrder } from "./order_helpers";
+
+declare module "express-session" {
+    interface SessionData {
+       orderData?: {
+            customer?: ValidationResults<Customer>,
+            address?: ValidationResults<Address>
+       }, 
+       pageSize?: string;
+    }
+}
+
+export const createOrderRoutes = (app: Express) => {
+
+    app.get("/checkout", (req, resp) => {
+
+        req.session.pageSize = 
+            req.session.pageSize ?? req.query.pageSize?.toString() ?? "3";
+
+        resp.render("order_details", {
+            order: req.session.orderData,
+            page: 1,
+            pageSize: req.session.pageSize
+        });
+    });
+
+    app.post("/checkout", async (req, resp) => {
+        const { customer, address } = req.body;
+        const data = req.session.orderData = {
+            customer: await CustomerValidator.validate(customer),
+            address: await AddressValidator.validate(address)
+        };
+        if (isValid(data.customer) && isValid(data.address) 
+                && req.session.cart) {
+            const order = await createAndStoreOrder(
+                getData(data.customer), getData(data.address), 
+                    req.session.cart
+            )
+            resp.redirect(`/checkout/${order.id}`);
+            req.session.cart = undefined;
+            req.session.orderData = undefined;
+        } else {
+            resp.redirect("/checkout");
+        }
+    });
+
+    app.get("/checkout/:id", (req, resp) => {
+        resp.render("order_complete", {
+            id: req.params.id,
+            pageSize: req.session.pageSize ?? 3
+        });
+    })
+}

Chapter 19/Beginning of Chapter/sportsstore/src/server.ts

@@ -0,0 +1,30 @@
+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";
+import { createSessions } from "./sessions";
+
+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"));
+expressApp.use(express.static("node_modules/bootstrap-icons"));
+
+createTemplates(expressApp);
+createSessions(expressApp);
+
+createRoutes(expressApp);
+createErrorHandlers(expressApp);
+
+const server = createServer(expressApp);
+
+server.listen(port, 
+    () => console.log(`HTTP Server listening on port ${port}`));

Chapter 19/Beginning of Chapter/sportsstore/src/sessions.ts

@@ -0,0 +1,37 @@
+import { Express } from "express";
+import { Sequelize } from "sequelize";
+import { getConfig, getSecret } from "./config";
+import session from "express-session";
+import sessionStore from "connect-session-sequelize";
+
+const config = getConfig("sessions");
+
+const secret = getSecret("COOKIE_SECRET");
+
+const logging = config.orm.logging 
+        ? { logging: console.log, logQueryParameters: true}
+        : { logging: false };
+
+export const createSessions = (app: Express) => {
+
+    const sequelize = new Sequelize({
+        ...config.orm.settings, ...logging
+    });
+
+    const store = new (sessionStore(session.Store))({
+        db: sequelize
+    });
+
+    if (config.reset_db === true) {
+        sequelize.drop().then(() => store.sync());
+    } else {
+        store.sync();
+    }
+
+    app.use(session({
+        secret, store,
+        resave: true, saveUninitialized: false,
+        cookie: { maxAge: config.maxAgeHrs * 60 * 60 * 1000, 
+            sameSite: "strict" }
+    }));
+}

Chapter 19/Beginning of Chapter/sportsstore/templates/cart.handlebars

@@ -0,0 +1,32 @@
+<h2>Your cart</h2>
+<table class="table table-bordered table-striped">
+    <thead>
+        <tr>
+            <th class="text-end">Quantity</th><th>Item</th>
+            <th class="text-end">Price</th><th class="text-end">Subtotal</th>
+            <th></th>
+        </tr>
+    </thead>
+    <tbody>
+        {{#unless cart.lines}}
+            <tr><td colspan="5" class="text-center">Cart is empty</td></tr>
+        {{/unless}}
+        {{#each cart.lines}}
+            {{> cart_line returnUrl=../returnUrl }}        
+        {{/each }}
+    </tbody>
+    <tfoot>
+        <tr>
+            <td colspan="3" class="text-end">Total:</td>
+            <td class="text-end">{{ currency cart.total }}</td>
+        </tr>
+    </tfoot>
+</table>
+<div class="text-center">
+    <a class="btn btn-primary" href="{{ returnUrl }}">Continue Shopping</a>
+    {{#if cart.lines}}
+        <a class="btn btn-primary" href="/checkout{{returnUrl}}">Checkout</a>
+    {{else}}
+        <button class="btn btn-primary" disabled>Checkout</button>
+    {{/if}}
+</div>

Chapter 19/Beginning of Chapter/sportsstore/templates/cart_line.handlebars

@@ -0,0 +1,15 @@
+<tr>
+    <td class="text-end">{{ quantity }} </td>    
+    <td class="text-left">{{ product.name }}</td>
+    <td class="text-end">{{ currency product.price }}</td>
+    <td class="text-end">{{ currency subtotal }}</td>
+    <td class="text-center">
+        <form method="post" action="/cart/remove">
+            <input type="hidden" name="id" value="{{ product.id }}">
+            <input type="hidden" name="returnUrl" value="{{ returnUrl }}">
+            <button type="submit" class="btn btn-sm btn-danger">
+                Remove
+            </button>
+        </form>
+    </td>
+</tr>

Chapter 19/Beginning of Chapter/sportsstore/templates/cart_summary.handlebars

@@ -0,0 +1,10 @@
+{{#if cart.lines}}
+    <small class="navbar-text">{{ countCartItems cart }} item(s)</small>
+{{else}}
+    <small class="navbar-text">(Empty)</small>
+{{/if}}
+
+<a class="btn btn-sm btn-secondary navbar-btn"  
+    href="/cart?returnUrl={{ escapeUrl ( navigationUrl ) }}">
+    <i class="bi-cart"></i>
+</a>

Chapter 19/Beginning of Chapter/sportsstore/templates/category_controls.handlebars

@@ -0,0 +1,16 @@
+<div class="d-grid gap-2 py-2">
+    <a class="btn btn-outline-secondary"
+        href="{{navigationUrl category="" page=1 searchTerm="" }}">
+            Home
+    </a>
+    {{#categoryButtons  }}
+        {{#if selected }}
+            <a class="btn btn-secondary">{{ name }}</a>
+        {{else }}
+            <a class="btn btn-outline-secondary"
+                href="{{navigationUrl category=id page=1}}">
+                {{ name }}
+            </a>
+        {{/if }}
+    {{/categoryButtons }}
+</div>

Chapter 19/Beginning of Chapter/sportsstore/templates/error.handlebars

@@ -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 }}

Chapter 19/Beginning of Chapter/sportsstore/templates/index.handlebars

@@ -0,0 +1,15 @@
+<div class="container-fluid">
+    <div class="row">
+        <div class="col-2">
+            {{> category_controls }}
+        </div>
+        <div class="col">
+            {{> search_controls }}    
+            {{#unless products}}<h4>No products</h4>{{/unless}}
+            {{#each products }}
+                {{> product this }}
+            {{/each}}
+            {{> page_controls }}
+        </div>
+    </div>
+</div>

Chapter 19/Beginning of Chapter/sportsstore/templates/main_layout.handlebars

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <link href="/css/bootstrap.min.css" rel="stylesheet" />
+        <link href="/font/bootstrap-icons.min.css" rel="stylesheet">
+    </head>
+    <body>
+        <div class="bg-dark text-white py-2 px-1">
+            <div class="container-fluid">
+                <div class="row">
+                    <div class="col align-baseline pt-1">SPORTS STORE</div>
+                    <div class="col-auto text-end">
+                        {{#if show_cart}}
+                            {{> cart_summary }}
+                        {{/if}}
+                    </div>
+                </div>
+            </div>
+        </div>
+        {{{ body }}}
+    </body>
+</html>

Chapter 19/Beginning of Chapter/sportsstore/templates/not_found.handlebars

@@ -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>