Initial content

Chapter 20/Beginning of Chapter/sportsstore/src/authentication.ts

@@ -0,0 +1,46 @@
+import { Express } from "express";
+import { getConfig, getSecret } from "./config";
+import passport from "passport";
+import { Strategy as GoogleStrategy, Profile, VerifyCallback } 
+    from "passport-google-oauth20";
+import { customer_repository } from "./data";
+import { Customer } from "./data/customer_models";
+
+const callbackURL: string = getConfig("auth:openauth:redirectionUrl");
+const clientID = getSecret("GOOGLE_CLIENT_ID");
+const clientSecret = getSecret("GOOGLE_CLIENT_SECRET");
+
+declare global {
+    namespace Express {
+        interface User extends Customer {  }
+    }
+}
+
+export const createAuthentication = (app:Express) => {
+
+    passport.use(new GoogleStrategy({ 
+        clientID, clientSecret, callbackURL, 
+        scope: ["email", "profile"],
+        state: true
+    } , async (accessToken: string, refreshToken: string, 
+            profile: Profile, callback: VerifyCallback) => {
+        const emailAddr = profile.emails?.[0].value ?? "";            
+        const customer = await customer_repository.storeCustomer({
+            name: profile.displayName, email: emailAddr,
+            federatedId: profile.id
+        });
+        const { id, name, email } = customer;
+        return callback(null, { id, name, email });
+    }));
+
+    passport.serializeUser((user, callback) => {
+        callback(null, user.id);
+    });
+
+    passport.deserializeUser((id: number, callbackFunc) => {
+        customer_repository.getCustomer(id).then(user => 
+            callbackFunc(null, user));
+    });
+
+    app.use(passport.session());
+}

Chapter 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/Beginning of Chapter/sportsstore/src/data/customer_models.ts

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

Chapter 20/Beginning of Chapter/sportsstore/src/data/customer_repository.ts

@@ -0,0 +1,13 @@
+import { Customer } from "./customer_models";
+import { Address } from "./order_models";
+
+export interface CustomerRepository {
+
+    getCustomer(id: number) : Promise<Customer | null>;
+
+    getCustomerByFederatedId(id: string): Promise<Customer | null>;
+
+    getCustomerAddress(id: number): Promise<Address | null>;
+
+    storeCustomer(customer: Customer): Promise<Customer>;
+}

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

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

Chapter 20/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 20/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 20/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 20/Beginning of Chapter/sportsstore/src/data/orm/customers.ts

@@ -0,0 +1,51 @@
+import { Customer } from "../customer_models";
+import { CustomerRepository } from "../customer_repository";
+import { Address } from "../order_models";
+import { BaseRepo, Constructor } from "./core"
+import { CustomerModel } from "./models/customer_models";
+import { AddressModel, OrderModel } from "./models/order_models";
+
+export function AddCustomers<TBase extends 
+        Constructor<BaseRepo>>(Base: TBase)  {
+
+    return class extends Base implements CustomerRepository {
+
+        getCustomer(id: number): Promise<Customer | null> { 
+            return CustomerModel.findByPk(id, {
+                raw: true
+            });
+        }
+
+        getCustomerByFederatedId(id: string): Promise<Customer | null> {
+            return CustomerModel.findOne({
+                where: { federatedId: id },
+                raw: true
+            })
+        }
+
+        getCustomerAddress(id: number): Promise<Address | null> {
+            return AddressModel.findOne({
+                include: [{
+                    model: OrderModel, 
+                    where: { customerId: id },
+                    attributes: []
+                }], 
+                order: [["updatedAt", "DESC"]]
+            });
+        }
+
+        async storeCustomer(customer: Customer): Promise<Customer> {
+            const [data, created] = await CustomerModel.findOrCreate({
+                where: { email: customer.email }, 
+                defaults: customer,
+            });
+            if (!created) {
+                data.name = customer.name;
+                data.email = customer.email;
+                data.federatedId = customer.federatedId;
+                await data.save();
+            }
+            return data;
+        }
+    }
+}

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

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

Chapter 20/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 20/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 20/Beginning of Chapter/sportsstore/src/data/orm/models/customer_helpers.ts

@@ -0,0 +1,12 @@
+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 },
+        federatedId: { type: DataTypes.STRING }
+    }, { sequelize})
+}

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

@@ -0,0 +1,13 @@
+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;
+
+    declare federatedId?: string;
+}

Chapter 20/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 20/Beginning of Chapter/sportsstore/src/data/orm/models/order_helpers.ts

@@ -0,0 +1,37 @@
+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"});
+
+    AddressModel.hasMany(OrderModel, { foreignKey: "addressId"});
+}

Chapter 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/Beginning of Chapter/sportsstore/src/data/validation/order_rules.ts

@@ -0,0 +1,17 @@
+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, 
+    federatedId: no_op
+});
+
+export const AddressValidator = new Validator<Address>({
+    street: required,
+    city: required, 
+    state: required,
+    zip: no_op
+});

Chapter 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/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 20/Beginning of Chapter/sportsstore/src/routes/orders.ts

@@ -0,0 +1,74 @@
+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";
+import { customer_repository } from "../data";
+import passport from "passport";
+
+declare module "express-session" {
+    interface SessionData {
+       orderData?: {
+            customer?: ValidationResults<Customer>,
+            address?: ValidationResults<Address>
+       }, 
+       pageSize?: string;
+    }
+}
+
+export const createOrderRoutes = (app: Express) => {
+
+    app.get("/checkout/google", passport.authenticate("google"));
+
+    app.get("/signin-google", passport.authenticate("google", 
+        { successRedirect: "/checkout", keepSessionInfo: true }));
+
+    app.get("/checkout", async (req, resp) => {
+
+        if (!req.session.orderData && req.user) {
+            req.session.orderData = {
+                customer: await CustomerValidator.validate(req.user),
+                address: await AddressValidator.validate(
+                    await customer_repository.getCustomerAddress(
+                        req.user?.id ?? 0) ?? {})   
+            }
+        }
+
+        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 20/Beginning of Chapter/sportsstore/src/server.ts

@@ -0,0 +1,33 @@
+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";
+import { createAuthentication } from "./authentication";
+
+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);
+
+createAuthentication(expressApp);
+
+createRoutes(expressApp);
+createErrorHandlers(expressApp);
+
+const server = createServer(expressApp);
+
+server.listen(port, 
+    () => console.log(`HTTP Server listening on port ${port}`));

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

@@ -0,0 +1,38 @@
+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: false, saveUninitialized: true,
+        cookie: { 
+            maxAge: config.maxAgeHrs * 60 * 60 * 1000, 
+            sameSite: false, httpOnly: false, secure: false }
+    }));    
+}