@fjell/express-router 4.4.23 → 4.4.24

package/dist/ItemRouter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/ItemRouter.ts"],
-  "sourcesContent": ["import {\n  ComKey,\n  cPK,\n  Item,\n  ItemEvent,\n  LocKey,\n  LocKeyArray,\n  PriKey,\n  validatePK\n} from \"@fjell/core\";\nimport { NotFoundError } from \"@fjell/lib\";\nimport { Instance } from \"./Instance.js\";\nimport deepmerge from \"deepmerge\";\nimport { Request, Response, Router } from \"express\";\nimport LibLogger from \"./logger.js\";\n\nexport type ItemRouterOptions = Record<string, never>;\n\nexport class ItemRouter<\n  S extends string,\n  L1 extends string = never,\n  L2 extends string = never,\n  L3 extends string = never,\n  L4 extends string = never,\n  L5 extends string = never\n> {\n\n  protected lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>;\n  private keyType: S;\n  protected options: ItemRouterOptions;\n  private childRouters: Record<string, Router> = {};\n  protected logger;\n\n  constructor(\n    lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>,\n    keyType: S,\n    options: ItemRouterOptions = {}\n  ) {\n    this.lib = lib;\n    this.keyType = keyType;\n    this.options = options;\n    this.logger = LibLogger.get(\"ItemRouter\", keyType);\n  }\n\n  public getPkType = (): S => {\n    return this.keyType;\n  }\n\n  protected getPkParam = (): string => {\n    return `${this.getPkType()}Pk`;\n  }\n\n  protected getLk(res: Response): LocKey<S> {\n    return { kt: this.keyType, lk: res.locals[this.getPkParam()] };\n  }\n\n  // this is meant to be consumed by children routers\n  public getLKA(res: Response): LocKeyArray<S, L1, L2, L3, L4> {\n    return [this.getLk(res)] as LocKeyArray<S, L1, L2, L3, L4>;\n  }\n\n  public getPk(res: Response): PriKey<S> {\n    return cPK<S>(res.locals[this.getPkParam()], this.getPkType());\n  }\n\n  // Unless this is a contained router, the locations will always be an empty array.\n  /* eslint-disable */\n  protected getLocations(res: Response): LocKeyArray<L1, L2, L3, L4, L5> | [] {\n    throw new Error('Method not implemented in an abstract router');\n  }\n  /* eslint-enable */\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  protected getIk(res: Response): PriKey<S> | ComKey<S, L1, L2, L3, L4, L5> {\n    throw new Error('Method not implemented in an abstract router');\n  }\n\n  protected postAllAction = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Posting All Action', { query: req?.query, params: req?.params, locals: res?.locals });\n    const allActionKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n    if (!libOptions.allActions) {\n      this.logger.error('Item Actions are not configured');\n      res.status(500).json({ error: 'Item Actions are not configured' });\n      return;\n    }\n    const allAction = libOptions.allActions[allActionKey];\n    if (!allAction) {\n      this.logger.error('All Action is not configured', { allActionKey });\n      res.status(500).json({ error: 'Item Action is not configured' });\n      return;\n    }\n    try {\n      res.json(await libOperations.allAction(allActionKey, req.body));\n    } catch (err: any) {\n      this.logger.error('Error in All Action', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected getAllFacet = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting All Facet', { query: req?.query, params: req?.params, locals: res?.locals });\n    const facetKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n    if (!libOptions.allFacets) {\n      this.logger.error('Item Facets are not configured');\n      res.status(500).json({ error: 'Item Facets are not configured' });\n      return;\n    }\n    const facet = libOptions.allFacets[facetKey];\n    if (!facet) {\n      this.logger.error('Item Facet is not configured', { facetKey });\n      res.status(500).json({ error: 'Item Facet is not configured' });\n      return;\n    }\n    try {\n      const combinedQueryParams = { ...req.query, ...req.params } as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>;\n      res.json(await libOperations.allFacet(facetKey, combinedQueryParams));\n    } catch (err: any) {\n      this.logger.error('Error in All Facet', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected postItemAction = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting Item', { query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    const actionKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n    if (!libOptions.actions) {\n      this.logger.error('Item Actions are not configured');\n      res.status(500).json({ error: 'Item Actions are not configured' });\n      return;\n    }\n    const action = libOptions.actions[actionKey];\n    if (!action) {\n      this.logger.error('Item Action is not configured', { actionKey });\n      res.status(500).json({ error: 'Item Action is not configured' });\n      return;\n    }\n    try {\n      res.json(await libOperations.action(ik, actionKey, req.body));\n    } catch (err: any) {\n      this.logger.error('Error in Item Action', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected getItemFacet = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting Item', { query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    const facetKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n    if (!libOptions.facets) {\n      this.logger.error('Item Facets are not configured');\n      res.status(500).json({ error: 'Item Facets are not configured' });\n      return;\n    }\n    const facet = libOptions.facets[facetKey];\n    if (!facet) {\n      this.logger.error('Item Facet is not configured', { facetKey });\n      res.status(500).json({ error: 'Item Facet is not configured' });\n      return;\n    }\n    try {\n      const combinedQueryParams = { ...req.query, ...req.params } as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>;\n      res.json(await libOperations.facet(ik, facetKey, combinedQueryParams));\n    } catch (err: any) {\n      this.logger.error('Error in Item Facet', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  private configure = (router: Router) => {\n    const libOptions = this.lib.options;\n    this.logger.debug('Configuring Router', { pkType: this.getPkType() });\n    router.get('/', this.findItems);\n    router.post('/', this.createItem);\n\n    this.logger.default('All Actions supplied to Router', { allActions: libOptions.allActions });\n    if (libOptions.allActions) {\n      Object.keys(libOptions.allActions).forEach((actionKey) => {\n        this.logger.debug('Configuring All Action %s', actionKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        router.post(`/${actionKey}`, this.postAllAction);\n      });\n    }\n\n    this.logger.default('All Facets supplied to Router', { allFacets: libOptions.allFacets });\n    if (libOptions.allFacets) {\n      Object.keys(libOptions.allFacets).forEach((facetKey) => {\n        this.logger.debug('Configuring All Facet %s', facetKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        router.get(`/${facetKey}`, this.getAllFacet);\n      });\n    }\n\n    const itemRouter = Router();\n    itemRouter.get('/', this.getItem);\n    itemRouter.put('/', this.updateItem);\n    itemRouter.delete('/', this.deleteItem);\n\n    this.logger.default('Item Actions supplied to Router', { itemActions: libOptions.actions });\n    if (libOptions.actions) {\n      Object.keys(libOptions.actions).forEach((actionKey) => {\n        this.logger.debug('Configuring Item Action %s', actionKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        itemRouter.post(`/${actionKey}`, this.postItemAction)\n      });\n    }\n\n    this.logger.default('Item Facets supplied to Router', { itemFacets: libOptions.facets });\n    if (libOptions.facets) {\n      Object.keys(libOptions.facets).forEach((facetKey) => {\n        this.logger.debug('Configuring Item Facet %s', facetKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        itemRouter.get(`/${facetKey}`, this.getItemFacet)\n      });\n    }\n\n    this.logger.debug('Configuring Item Operations under PK Param %s', this.getPkParam());\n    router.use(`/:${this.getPkParam()}`, this.validatePrimaryKeyValue, itemRouter);\n\n    if (this.childRouters) {\n      this.configureChildRouters(itemRouter, this.childRouters);\n    }\n    return router;\n  }\n\n  private validatePrimaryKeyValue = (req: Request, res: Response, next: any) => {\n    const pkParamValue = req.params[this.getPkParam()];\n    if (this.validatePKParam(pkParamValue)) {\n      res.locals[this.getPkParam()] = pkParamValue;\n      next();\n    } else {\n      this.logger.error('Invalid Primary Key', { pkParamValue, path: req?.originalUrl });\n      res.status(500).json({ error: 'Invalid Primary Key', path: req?.originalUrl });\n    }\n  }\n\n  private configureChildRouters = (router: Router, childRouters: Record<string, Router>) => {\n    for (const path in childRouters) {\n      this.logger.debug('Configuring Child Router at Path %s', path);\n\n      router.use(`/${path}`, childRouters[path]);\n    }\n    return router;\n  }\n\n  public addChildRouter = (path: string, router: Router) => {\n    this.childRouters[path] = router;\n  }\n\n  /* istanbul ignore next */\n  public getRouter(): Router {\n    const router = Router();\n    this.configure(router);\n    return router;\n  }\n\n  /* istanbul ignore next */\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  protected createItem = async (req: Request, res: Response): Promise<void> => {\n    throw new Error('Method not implemented in an abstract router');\n  };\n\n  // TODO: Probably a better way to do this, but this postCreate hook only needs the item.\n  /* istanbul ignore next */\n  public postCreateItem = async (item: Item<S, L1, L2, L3, L4, L5>): Promise<Item<S, L1, L2, L3, L4, L5>> => {\n    this.logger.debug('Post Create Item', { item });\n    return item;\n  };\n\n  protected deleteItem = async (req: Request, res: Response): Promise<void> => {\n    const libOperations = this.lib.operations;\n\n    this.logger.debug('Deleting Item', { query: req.query, params: req.params, locals: res.locals });\n    const ik = this.getIk(res);\n    const removedItem = await libOperations.remove(ik);\n    const item = validatePK(removedItem, this.getPkType());\n    res.json(item);\n  };\n\n  /* eslint-disable */\n  /* istanbul ignore next */\n  protected findItems = async (req: Request, res: Response): Promise<void> => {\n    throw new Error('Method not implemented in an abstract router');\n  };\n  /* eslint-enable */\n\n  protected getItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting Item', { query: req.query, params: req.params, locals: res.locals });\n    const ik = this.getIk(res);\n    try {\n      // TODO: What error does validate PK throw, when can that fail?\n      const item = validatePK(await libOperations.get(ik), this.getPkType());\n      res.json(item);\n    } catch (err: any) {\n      if (err instanceof NotFoundError) {\n        this.logger.error('Item Not Found', { ik, message: err?.message, stack: err?.stack });\n        res.status(404).json({\n          ik,\n          message: \"Item Not Found\",\n        });\n      } else {\n        this.logger.error('General Error', { ik, message: err?.message, stack: err?.stack });\n        res.status(500).json({\n          ik,\n          message: \"General Error\",\n        });\n      }\n    }\n  }\n\n  protected updateItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.debug('Updating Item',\n      { body: req?.body, query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    const itemToUpdate = this.convertDates(req.body as Partial<Item<S, L1, L2, L3, L4, L5>>);\n    const retItem = validatePK(await libOperations.update(ik, itemToUpdate), this.getPkType());\n    res.json(retItem);\n  };\n\n  public convertDates = (item: Partial<Item<S, L1, L2, L3, L4, L5>>): Partial<Item<S, L1, L2, L3, L4, L5>> => {\n    const events = item.events as Record<string, ItemEvent>;\n    this.logger.debug('Converting Dates', { item });\n    if (events) {\n      Object.keys(events).forEach((key: string) => {\n        Object.assign(events, {\n          [key]: deepmerge(events[key], { at: events[key].at ? new Date(events[key].at) : null })\n        });\n      });\n    }\n    Object.assign(item, { events });\n    return item;\n  };\n\n  // TODO: Maybe just simplify this and require that everything is a UUID?\n  /**\n   * This method might be an annoyance, but we need to capture a few cases where someone passes\n   * a PK parameter that has an odd string in it.\n   *\n   * @param pkParamValue The value of the primary key parameter\n   * @returns if the value is valid.\n   */\n  protected validatePKParam = (pkParamValue: string): boolean => {\n    let validPkParam = true;\n    if (pkParamValue.length <= 0) {\n      this.logger.error('Primary Key is an Empty String', { pkParamValue });\n      validPkParam = false;\n    } else if (pkParamValue === 'undefined') {\n      this.logger.error('Primary Key is the string \\'undefined\\'', { pkParamValue });\n      validPkParam = false;\n    }\n    return validPkParam;\n  }\n\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  ComKey,\n  cPK,\n  Item,\n  ItemEvent,\n  LocKey,\n  LocKeyArray,\n  PriKey,\n  validatePK\n} from \"@fjell/core\";\nimport { NotFoundError } from \"@fjell/lib\";\nimport { Instance } from \"./Instance.js\";\nimport deepmerge from \"deepmerge\";\nimport { Request, Response, Router } from \"express\";\nimport LibLogger from \"./logger.js\";\n\nexport type ItemRouterOptions<\n  S extends string = string,\n  L1 extends string = never,\n  L2 extends string = never,\n  L3 extends string = never,\n  L4 extends string = never,\n  L5 extends string = never\n> = {\n  /** Handlers for item actions */\n  actions?: Record<string, (req: Request, res: Response, ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>) => Promise<void>>;\n  /** Handlers for item facets */\n  facets?: Record<string, (req: Request, res: Response, ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>) => Promise<void>>;\n  /** Handlers for all actions */\n  allActions?: Record<string, (req: Request, res: Response) => Promise<void>>;\n  /** Handlers for all facets */\n  allFacets?: Record<string, (req: Request, res: Response) => Promise<void>>;\n};\n\nexport class ItemRouter<\n  S extends string,\n  L1 extends string = never,\n  L2 extends string = never,\n  L3 extends string = never,\n  L4 extends string = never,\n  L5 extends string = never\n> {\n\n  protected lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>;\n  private keyType: S;\n  protected options: ItemRouterOptions<S, L1, L2, L3, L4, L5>;\n  private childRouters: Record<string, Router> = {};\n  protected logger;\n\n  constructor(\n    lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>,\n    keyType: S,\n    options: ItemRouterOptions<S, L1, L2, L3, L4, L5> = {}\n  ) {\n    this.lib = lib;\n    this.keyType = keyType;\n    this.options = options;\n    this.logger = LibLogger.get(\"ItemRouter\", keyType);\n  }\n\n  public getPkType = (): S => {\n    return this.keyType;\n  }\n\n  protected getPkParam = (): string => {\n    return `${this.getPkType()}Pk`;\n  }\n\n  protected getLk(res: Response): LocKey<S> {\n    return { kt: this.keyType, lk: res.locals[this.getPkParam()] };\n  }\n\n  // this is meant to be consumed by children routers\n  public getLKA(res: Response): LocKeyArray<S, L1, L2, L3, L4> {\n    return [this.getLk(res)] as LocKeyArray<S, L1, L2, L3, L4>;\n  }\n\n  public getPk(res: Response): PriKey<S> {\n    return cPK<S>(res.locals[this.getPkParam()], this.getPkType());\n  }\n\n  // Unless this is a contained router, the locations will always be an empty array.\n  /* eslint-disable */\n  protected getLocations(res: Response): LocKeyArray<L1, L2, L3, L4, L5> | [] {\n    throw new Error('Method not implemented in an abstract router');\n  }\n  /* eslint-enable */\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  protected getIk(res: Response): PriKey<S> | ComKey<S, L1, L2, L3, L4, L5> {\n    throw new Error('Method not implemented in an abstract router');\n  }\n\n  protected postAllAction = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Posting All Action', { query: req?.query, params: req?.params, locals: res?.locals });\n    const allActionKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n\n    // Check for router-level handler first\n    if (this.options.allActions && this.options.allActions[allActionKey]) {\n      this.logger.debug('Using router-level all action handler', { allActionKey });\n      try {\n        await this.options.allActions[allActionKey](req, res);\n        return;\n      } catch (err: any) {\n        this.logger.error('Error in router-level all action', { message: err?.message, stack: err?.stack });\n        res.status(500).json(err);\n        return;\n      }\n    }\n\n    // Fallback to library handler\n    if (!libOptions.allActions) {\n      this.logger.error('All Actions are not configured');\n      res.status(500).json({ error: 'All Actions are not configured' });\n      return;\n    }\n    const allAction = libOptions.allActions[allActionKey];\n    if (!allAction) {\n      this.logger.error('All Action is not configured', { allActionKey });\n      res.status(500).json({ error: 'All Action is not configured' });\n      return;\n    }\n    try {\n      res.json(await libOperations.allAction(allActionKey, req.body));\n    } catch (err: any) {\n      this.logger.error('Error in All Action', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected getAllFacet = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting All Facet', { query: req?.query, params: req?.params, locals: res?.locals });\n    const facetKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n\n    // Check for router-level handler first\n    if (this.options.allFacets && this.options.allFacets[facetKey]) {\n      this.logger.debug('Using router-level all facet handler', { facetKey });\n      try {\n        await this.options.allFacets[facetKey](req, res);\n        return;\n      } catch (err: any) {\n        this.logger.error('Error in router-level all facet', { message: err?.message, stack: err?.stack });\n        res.status(500).json(err);\n        return;\n      }\n    }\n\n    // Fallback to library handler\n    if (!libOptions.allFacets) {\n      this.logger.error('All Facets are not configured');\n      res.status(500).json({ error: 'All Facets are not configured' });\n      return;\n    }\n    const facet = libOptions.allFacets[facetKey];\n    if (!facet) {\n      this.logger.error('All Facet is not configured', { facetKey });\n      res.status(500).json({ error: 'All Facet is not configured' });\n      return;\n    }\n    try {\n      const combinedQueryParams = { ...req.query, ...req.params } as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>;\n      res.json(await libOperations.allFacet(facetKey, combinedQueryParams));\n    } catch (err: any) {\n      this.logger.error('Error in All Facet', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected postItemAction = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Posting Item Action', { query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    const actionKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n\n    // Check for router-level handler first\n    if (this.options.actions && this.options.actions[actionKey]) {\n      this.logger.debug('Using router-level action handler', { actionKey });\n      try {\n        await this.options.actions[actionKey](req, res, ik);\n        return;\n      } catch (err: any) {\n        this.logger.error('Error in router-level action', { message: err?.message, stack: err?.stack });\n        res.status(500).json(err);\n        return;\n      }\n    }\n\n    // Fallback to library handler\n    if (!libOptions.actions) {\n      this.logger.error('Item Actions are not configured');\n      res.status(500).json({ error: 'Item Actions are not configured' });\n      return;\n    }\n    const action = libOptions.actions[actionKey];\n    if (!action) {\n      this.logger.error('Item Action is not configured', { actionKey });\n      res.status(500).json({ error: 'Item Action is not configured' });\n      return;\n    }\n    try {\n      res.json(await libOperations.action(ik, actionKey, req.body));\n    } catch (err: any) {\n      this.logger.error('Error in Item Action', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  protected getItemFacet = async (req: Request, res: Response) => {\n    const libOptions = this.lib.options;\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting Item Facet', { query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    const facetKey = req.path.substring(req.path.lastIndexOf('/') + 1);\n\n    // Check for router-level handler first\n    if (this.options.facets && this.options.facets[facetKey]) {\n      this.logger.debug('Using router-level facet handler', { facetKey });\n      try {\n        await this.options.facets[facetKey](req, res, ik);\n        return;\n      } catch (err: any) {\n        this.logger.error('Error in router-level facet', { message: err?.message, stack: err?.stack });\n        res.status(500).json(err);\n        return;\n      }\n    }\n\n    // Fallback to library handler\n    if (!libOptions.facets) {\n      this.logger.error('Item Facets are not configured');\n      res.status(500).json({ error: 'Item Facets are not configured' });\n      return;\n    }\n    const facet = libOptions.facets[facetKey];\n    if (!facet) {\n      this.logger.error('Item Facet is not configured', { facetKey });\n      res.status(500).json({ error: 'Item Facet is not configured' });\n      return;\n    }\n    try {\n      const combinedQueryParams = { ...req.query, ...req.params } as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>;\n      res.json(await libOperations.facet(ik, facetKey, combinedQueryParams));\n    } catch (err: any) {\n      this.logger.error('Error in Item Facet', { message: err?.message, stack: err?.stack });\n      res.status(500).json(err);\n    }\n  }\n\n  private configure = (router: Router) => {\n    const libOptions = this.lib.options;\n    this.logger.debug('Configuring Router', { pkType: this.getPkType() });\n    router.get('/', this.findItems);\n    router.post('/', this.createItem);\n\n    this.logger.default('All Actions supplied to Router', { allActions: libOptions.allActions });\n    if (libOptions.allActions) {\n      Object.keys(libOptions.allActions).forEach((actionKey) => {\n        this.logger.debug('Configuring All Action %s', actionKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        router.post(`/${actionKey}`, this.postAllAction);\n      });\n    }\n\n    this.logger.default('All Facets supplied to Router', { allFacets: libOptions.allFacets });\n    if (libOptions.allFacets) {\n      Object.keys(libOptions.allFacets).forEach((facetKey) => {\n        this.logger.debug('Configuring All Facet %s', facetKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        router.get(`/${facetKey}`, this.getAllFacet);\n      });\n    }\n\n    const itemRouter = Router();\n    itemRouter.get('/', this.getItem);\n    itemRouter.put('/', this.updateItem);\n    itemRouter.delete('/', this.deleteItem);\n\n    this.logger.default('Item Actions supplied to Router', { itemActions: libOptions.actions });\n    if (libOptions.actions) {\n      Object.keys(libOptions.actions).forEach((actionKey) => {\n        this.logger.debug('Configuring Item Action %s', actionKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        itemRouter.post(`/${actionKey}`, this.postItemAction)\n      });\n    }\n\n    this.logger.default('Item Facets supplied to Router', { itemFacets: libOptions.facets });\n    if (libOptions.facets) {\n      Object.keys(libOptions.facets).forEach((facetKey) => {\n        this.logger.debug('Configuring Item Facet %s', facetKey);\n        // TODO: Ok, this is a bit of a hack, but we need to customize the types of the request handlers\n        itemRouter.get(`/${facetKey}`, this.getItemFacet)\n      });\n    }\n\n    this.logger.debug('Configuring Item Operations under PK Param %s', this.getPkParam());\n    router.use(`/:${this.getPkParam()}`, this.validatePrimaryKeyValue, itemRouter);\n\n    if (this.childRouters) {\n      this.configureChildRouters(itemRouter, this.childRouters);\n    }\n    return router;\n  }\n\n  private validatePrimaryKeyValue = (req: Request, res: Response, next: any) => {\n    const pkParamValue = req.params[this.getPkParam()];\n    if (this.validatePKParam(pkParamValue)) {\n      res.locals[this.getPkParam()] = pkParamValue;\n      next();\n    } else {\n      this.logger.error('Invalid Primary Key', { pkParamValue, path: req?.originalUrl });\n      res.status(500).json({ error: 'Invalid Primary Key', path: req?.originalUrl });\n    }\n  }\n\n  private configureChildRouters = (router: Router, childRouters: Record<string, Router>) => {\n    for (const path in childRouters) {\n      this.logger.debug('Configuring Child Router at Path %s', path);\n\n      router.use(`/${path}`, childRouters[path]);\n    }\n    return router;\n  }\n\n  public addChildRouter = (path: string, router: Router) => {\n    this.childRouters[path] = router;\n  }\n\n  /* istanbul ignore next */\n  public getRouter(): Router {\n    const router = Router();\n    this.configure(router);\n    return router;\n  }\n\n  /* istanbul ignore next */\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  protected createItem = async (req: Request, res: Response): Promise<void> => {\n    throw new Error('Method not implemented in an abstract router');\n  };\n\n  // TODO: Probably a better way to do this, but this postCreate hook only needs the item.\n  /* istanbul ignore next */\n  public postCreateItem = async (item: Item<S, L1, L2, L3, L4, L5>): Promise<Item<S, L1, L2, L3, L4, L5>> => {\n    this.logger.debug('Post Create Item', { item });\n    return item;\n  };\n\n  protected deleteItem = async (req: Request, res: Response): Promise<void> => {\n    const libOperations = this.lib.operations;\n\n    this.logger.debug('Deleting Item', { query: req.query, params: req.params, locals: res.locals });\n    const ik = this.getIk(res);\n    try {\n      const removedItem = await libOperations.remove(ik);\n      const item = validatePK(removedItem, this.getPkType());\n      res.json(item);\n    } catch (err: any) {\n      if (err instanceof NotFoundError) {\n        this.logger.error('Item Not Found for Delete', { ik, message: err?.message, stack: err?.stack });\n        res.status(404).json({\n          ik,\n          message: \"Item Not Found\",\n        });\n      } else {\n        this.logger.error('General Error in Delete', { ik, message: err?.message, stack: err?.stack });\n        res.status(500).json({\n          ik,\n          message: \"General Error\",\n        });\n      }\n    }\n  };\n\n  /* eslint-disable */\n  /* istanbul ignore next */\n  protected findItems = async (req: Request, res: Response): Promise<void> => {\n    throw new Error('Method not implemented in an abstract router');\n  };\n  /* eslint-enable */\n\n  protected getItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.debug('Getting Item', { query: req.query, params: req.params, locals: res.locals });\n    const ik = this.getIk(res);\n    try {\n      // TODO: What error does validate PK throw, when can that fail?\n      const item = validatePK(await libOperations.get(ik), this.getPkType());\n      res.json(item);\n    } catch (err: any) {\n      if (err instanceof NotFoundError) {\n        this.logger.error('Item Not Found', { ik, message: err?.message, stack: err?.stack });\n        res.status(404).json({\n          ik,\n          message: \"Item Not Found\",\n        });\n      } else {\n        this.logger.error('General Error', { ik, message: err?.message, stack: err?.stack });\n        res.status(500).json({\n          ik,\n          message: \"General Error\",\n        });\n      }\n    }\n  }\n\n  protected updateItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.debug('Updating Item',\n      { body: req?.body, query: req?.query, params: req?.params, locals: res?.locals });\n    const ik = this.getIk(res);\n    try {\n      const itemToUpdate = this.convertDates(req.body as Partial<Item<S, L1, L2, L3, L4, L5>>);\n      const retItem = validatePK(await libOperations.update(ik, itemToUpdate), this.getPkType());\n      res.json(retItem);\n    } catch (err: any) {\n      if (err instanceof NotFoundError) {\n        this.logger.error('Item Not Found for Update', { ik, message: err?.message, stack: err?.stack });\n        res.status(404).json({\n          ik,\n          message: \"Item Not Found\",\n        });\n      } else {\n        this.logger.error('General Error in Update', { ik, message: err?.message, stack: err?.stack });\n        res.status(500).json({\n          ik,\n          message: \"General Error\",\n        });\n      }\n    }\n  };\n\n  public convertDates = (item: Partial<Item<S, L1, L2, L3, L4, L5>>): Partial<Item<S, L1, L2, L3, L4, L5>> => {\n    const events = item.events as Record<string, ItemEvent>;\n    this.logger.debug('Converting Dates', { item });\n    if (events) {\n      Object.keys(events).forEach((key: string) => {\n        Object.assign(events, {\n          [key]: deepmerge(events[key], { at: events[key].at ? new Date(events[key].at) : null })\n        });\n      });\n    }\n    Object.assign(item, { events });\n    return item;\n  };\n\n  // TODO: Maybe just simplify this and require that everything is a UUID?\n  /**\n   * This method might be an annoyance, but we need to capture a few cases where someone passes\n   * a PK parameter that has an odd string in it.\n   *\n   * @param pkParamValue The value of the primary key parameter\n   * @returns if the value is valid.\n   */\n  protected validatePKParam = (pkParamValue: string): boolean => {\n    let validPkParam = true;\n    if (pkParamValue.length <= 0) {\n      this.logger.error('Primary Key is an Empty String', { pkParamValue });\n      validPkParam = false;\n    } else if (pkParamValue === 'undefined') {\n      this.logger.error('Primary Key is the string \\'undefined\\'', { pkParamValue });\n      validPkParam = false;\n    }\n    return validPkParam;\n  }\n\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/PItemRouter.d.ts

@@ -3,7 +3,7 @@ import { ItemRouter, ItemRouterOptions } from "./ItemRouter.js";
 import { Instance } from "./Instance.js";
 import { Request, Response } from "express";
 export declare class PItemRouter<T extends Item<S>, S extends string> extends ItemRouter<S> {
-    constructor(lib: Instance<T, S>, keyType: S, options?: ItemRouterOptions);
+    constructor(lib: Instance<T, S>, keyType: S, options?: ItemRouterOptions<S, never, never, never, never, never>);
     getIk(res: Response): PriKey<S>;
     createItem: (req: Request, res: Response) => Promise<void>;
     protected findItems: (req: Request, res: Response) => Promise<void>;

package/dist/PItemRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PItemRouter.d.ts","sourceRoot":"","sources":["../src/PItemRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA4B,MAAM,EAA2B,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM5C,qBAAa,WAAW,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;gBAErE,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAE,iBAAsB;IAIrE,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IAK/B,UAAU,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBAQpD;IAEF,SAAS,CAAC,SAAS,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBA6BtD;CAEH"}
+{"version":3,"file":"PItemRouter.d.ts","sourceRoot":"","sources":["../src/PItemRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA4B,MAAM,EAA2B,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM5C,qBAAa,WAAW,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;gBAErE,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAE,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAM;IAI3G,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IAK/B,UAAU,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBAQpD;IAEF,SAAS,CAAC,SAAS,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBA6BtD;CAEH"}

package/dist/PItemRouter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/PItemRouter.ts"],
-  "sourcesContent": ["import { Item, ItemQuery, paramsToQuery, PriKey, QueryParams, validatePK } from \"@fjell/core\";\nimport { ItemRouter, ItemRouterOptions } from \"./ItemRouter.js\";\nimport { Instance } from \"./Instance.js\";\nimport { Request, Response } from \"express\";\n\ninterface ParsedQuery {\n  [key: string]: undefined | string | string[] | ParsedQuery | ParsedQuery[];\n}\n\nexport class PItemRouter<T extends Item<S>, S extends string> extends ItemRouter<S> {\n\n  constructor(lib: Instance<T, S>, keyType: S, options: ItemRouterOptions = {}) {\n    super(lib as any, keyType, options);\n  }\n\n  public getIk(res: Response): PriKey<S> {\n    const pri = this.getPk(res) as PriKey<S>;\n    return pri\n  }\n\n  public createItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.default('Creating Item', { body: req.body, query: req.query, params: req.params, locals: res.locals });\n    const itemToCreate = this.convertDates(req.body as Item<S>);\n    let item = validatePK(await libOperations.create(itemToCreate), this.getPkType()) as Item<S>;\n    item = await this.postCreateItem(item);\n    this.logger.default('Created Item %j', item);\n    res.json(item);\n  };\n\n  protected findItems = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.default('Finding Items', { query: req.query, params: req.params, locals: res.locals });\n\n    let items: Item<S>[] = [];\n\n    const query: ParsedQuery = req.query as unknown as ParsedQuery;\n    const finder = query['finder'] as string;\n    const finderParams = query['finderParams'] as string;\n    const one = query['one'] as string;\n\n    if (finder) {\n      // If finder is defined?  Call a finder.\n      this.logger.default('Finding Items with Finder %s %j one:%s', finder, finderParams, one);\n\n      if (one === 'true') {\n        const item = await (this.lib as any).findOne(finder, JSON.parse(finderParams));\n        items = item ? [item] : [];\n      } else {\n        items = await libOperations.find(finder, JSON.parse(finderParams));\n      }\n    } else {\n      // TODO: This is once of the more important places to perform some validaation and feedback\n      const itemQuery: ItemQuery = paramsToQuery(req.query as QueryParams);\n      this.logger.default('Finding Items with a query %j', itemQuery);\n      items = await libOperations.all(itemQuery);\n    }\n\n    res.json(items.map((item: Item<S>) => validatePK(item, this.getPkType())));\n  };\n\n}\n"],
-  "mappings": "AAAA,SAA0B,eAAoC,kBAAkB;AAChF,SAAS,kBAAqC;AAQvC,MAAM,oBAAyD,WAAc;AAAA,EAElF,YAAY,KAAqB,SAAY,UAA6B,CAAC,GAAG;AAC5E,UAAM,KAAY,SAAS,OAAO;AAAA,EACpC;AAAA,EAEO,MAAM,KAA0B;AACrC,UAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AAAA,EAEO,aAAa,OAAO,KAAc,QAAkB;AACzD,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,MAAM,IAAI,MAAM,OAAO,IAAI,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI,OAAO,CAAC;AACjH,UAAM,eAAe,KAAK,aAAa,IAAI,IAAe;AAC1D,QAAI,OAAO,WAAW,MAAM,cAAc,OAAO,YAAY,GAAG,KAAK,UAAU,CAAC;AAChF,WAAO,MAAM,KAAK,eAAe,IAAI;AACrC,SAAK,OAAO,QAAQ,mBAAmB,IAAI;AAC3C,QAAI,KAAK,IAAI;AAAA,EACf;AAAA,EAEU,YAAY,OAAO,KAAc,QAAkB;AAC3D,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,OAAO,IAAI,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI,OAAO,CAAC;AAEjG,QAAI,QAAmB,CAAC;AAExB,UAAM,QAAqB,IAAI;AAC/B,UAAM,SAAS,MAAM,QAAQ;AAC7B,UAAM,eAAe,MAAM,cAAc;AACzC,UAAM,MAAM,MAAM,KAAK;AAEvB,QAAI,QAAQ;AAEV,WAAK,OAAO,QAAQ,0CAA0C,QAAQ,cAAc,GAAG;AAEvF,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAO,KAAK,IAAY,QAAQ,QAAQ,KAAK,MAAM,YAAY,CAAC;AAC7E,gBAAQ,OAAO,CAAC,IAAI,IAAI,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,MAAM,cAAc,KAAK,QAAQ,KAAK,MAAM,YAAY,CAAC;AAAA,MACnE;AAAA,IACF,OAAO;AAEL,YAAM,YAAuB,cAAc,IAAI,KAAoB;AACnE,WAAK,OAAO,QAAQ,iCAAiC,SAAS;AAC9D,cAAQ,MAAM,cAAc,IAAI,SAAS;AAAA,IAC3C;AAEA,QAAI,KAAK,MAAM,IAAI,CAAC,SAAkB,WAAW,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;AAAA,EAC3E;AAEF;",
+  "sourcesContent": ["import { Item, ItemQuery, paramsToQuery, PriKey, QueryParams, validatePK } from \"@fjell/core\";\nimport { ItemRouter, ItemRouterOptions } from \"./ItemRouter.js\";\nimport { Instance } from \"./Instance.js\";\nimport { Request, Response } from \"express\";\n\ninterface ParsedQuery {\n  [key: string]: undefined | string | string[] | ParsedQuery | ParsedQuery[];\n}\n\nexport class PItemRouter<T extends Item<S>, S extends string> extends ItemRouter<S> {\n\n  constructor(lib: Instance<T, S>, keyType: S, options: ItemRouterOptions<S, never, never, never, never, never> = {}) {\n    super(lib as any, keyType, options);\n  }\n\n  public getIk(res: Response): PriKey<S> {\n    const pri = this.getPk(res) as PriKey<S>;\n    return pri\n  }\n\n  public createItem = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.default('Creating Item', { body: req.body, query: req.query, params: req.params, locals: res.locals });\n    const itemToCreate = this.convertDates(req.body as Item<S>);\n    let item = validatePK(await libOperations.create(itemToCreate), this.getPkType()) as Item<S>;\n    item = await this.postCreateItem(item);\n    this.logger.default('Created Item %j', item);\n    res.json(item);\n  };\n\n  protected findItems = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\n    this.logger.default('Finding Items', { query: req.query, params: req.params, locals: res.locals });\n\n    let items: Item<S>[] = [];\n\n    const query: ParsedQuery = req.query as unknown as ParsedQuery;\n    const finder = query['finder'] as string;\n    const finderParams = query['finderParams'] as string;\n    const one = query['one'] as string;\n\n    if (finder) {\n      // If finder is defined?  Call a finder.\n      this.logger.default('Finding Items with Finder %s %j one:%s', finder, finderParams, one);\n\n      if (one === 'true') {\n        const item = await (this.lib as any).findOne(finder, JSON.parse(finderParams));\n        items = item ? [item] : [];\n      } else {\n        items = await libOperations.find(finder, JSON.parse(finderParams));\n      }\n    } else {\n      // TODO: This is once of the more important places to perform some validaation and feedback\n      const itemQuery: ItemQuery = paramsToQuery(req.query as QueryParams);\n      this.logger.default('Finding Items with a query %j', itemQuery);\n      items = await libOperations.all(itemQuery);\n    }\n\n    res.json(items.map((item: Item<S>) => validatePK(item, this.getPkType())));\n  };\n\n}\n"],
+  "mappings": "AAAA,SAA0B,eAAoC,kBAAkB;AAChF,SAAS,kBAAqC;AAQvC,MAAM,oBAAyD,WAAc;AAAA,EAElF,YAAY,KAAqB,SAAY,UAAmE,CAAC,GAAG;AAClH,UAAM,KAAY,SAAS,OAAO;AAAA,EACpC;AAAA,EAEO,MAAM,KAA0B;AACrC,UAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AAAA,EAEO,aAAa,OAAO,KAAc,QAAkB;AACzD,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,MAAM,IAAI,MAAM,OAAO,IAAI,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI,OAAO,CAAC;AACjH,UAAM,eAAe,KAAK,aAAa,IAAI,IAAe;AAC1D,QAAI,OAAO,WAAW,MAAM,cAAc,OAAO,YAAY,GAAG,KAAK,UAAU,CAAC;AAChF,WAAO,MAAM,KAAK,eAAe,IAAI;AACrC,SAAK,OAAO,QAAQ,mBAAmB,IAAI;AAC3C,QAAI,KAAK,IAAI;AAAA,EACf;AAAA,EAEU,YAAY,OAAO,KAAc,QAAkB;AAC3D,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,OAAO,IAAI,OAAO,QAAQ,IAAI,QAAQ,QAAQ,IAAI,OAAO,CAAC;AAEjG,QAAI,QAAmB,CAAC;AAExB,UAAM,QAAqB,IAAI;AAC/B,UAAM,SAAS,MAAM,QAAQ;AAC7B,UAAM,eAAe,MAAM,cAAc;AACzC,UAAM,MAAM,MAAM,KAAK;AAEvB,QAAI,QAAQ;AAEV,WAAK,OAAO,QAAQ,0CAA0C,QAAQ,cAAc,GAAG;AAEvF,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAO,KAAK,IAAY,QAAQ,QAAQ,KAAK,MAAM,YAAY,CAAC;AAC7E,gBAAQ,OAAO,CAAC,IAAI,IAAI,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,MAAM,cAAc,KAAK,QAAQ,KAAK,MAAM,YAAY,CAAC;AAAA,MACnE;AAAA,IACF,OAAO;AAEL,YAAM,YAAuB,cAAc,IAAI,KAAoB;AACnE,WAAK,OAAO,QAAQ,iCAAiC,SAAS;AAC9D,cAAQ,MAAM,cAAc,IAAI,SAAS;AAAA,IAC3C;AAEA,QAAI,KAAK,MAAM,IAAI,CAAC,SAAkB,WAAW,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;AAAA,EAC3E;AAEF;",
   "names": []
 }

package/dist/util/general.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/util/general.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-unused-vars */\n/* eslint-disable no-undefined */\nexport const clean = (obj: any) => {\n  return Object.fromEntries(\n    Object.entries(obj).filter(([_, v]) => v !== undefined)\n  );\n}\n\n//Recursive implementation of jSON.stringify;\nexport const stringifyJSON = function (obj: any, visited: Set<any> = new Set()): string {\n  const arrOfKeyVals: string[] = [];\n  const arrVals: string[] = [];\n  let objKeys: string[] = [];\n\n  /*********CHECK FOR PRIMITIVE TYPES**********/\n  if (typeof obj === 'number' || typeof obj === 'boolean' || obj === null)\n    return '' + obj;\n  else if (typeof obj === 'string')\n    return '\"' + obj + '\"';\n\n  /*********DETECT CIRCULAR REFERENCES**********/\n  if (obj instanceof Object && visited.has(obj)) {\n    return '\"(circular)\"';\n  }\n\n  /*********CHECK FOR ARRAY**********/\n  else if (Array.isArray(obj)) {\n    //check for empty array\n    if (obj[0] === undefined)\n      return '[]';\n    else {\n      // Add array to visited before processing its elements\n      visited.add(obj);\n      obj.forEach(function (el) {\n        arrVals.push(stringifyJSON(el, visited));\n      });\n      return '[' + arrVals + ']';\n    }\n  }\n  /*********CHECK FOR OBJECT**********/\n  else if (obj instanceof Object) {\n    // Add object to visited before processing its properties\n    visited.add(obj);\n    //get object keys\n    objKeys = Object.keys(obj);\n    //set key output;\n    objKeys.forEach(function (key) {\n      const keyOut = '\"' + key + '\":';\n      const keyValOut = obj[key];\n      //skip functions and undefined properties\n      if (keyValOut instanceof Function || keyValOut === undefined)\n        return; // Skip this entry entirely instead of pushing an empty string\n      else if (typeof keyValOut === 'string')\n        arrOfKeyVals.push(keyOut + '\"' + keyValOut + '\"');\n      else if (typeof keyValOut === 'boolean' || typeof keyValOut === 'number' || keyValOut === null)\n        arrOfKeyVals.push(keyOut + keyValOut);\n      //check for nested objects, call recursively until no more objects\n      else if (keyValOut instanceof Object) {\n        arrOfKeyVals.push(keyOut + stringifyJSON(keyValOut, visited));\n      }\n    });\n    return '{' + arrOfKeyVals + '}';\n  }\n  return '';\n};"],
+  "sourcesContent": ["\n/* eslint-disable no-undefined, @typescript-eslint/no-unused-vars */\nexport const clean = (obj: any) => {\n  return Object.fromEntries(\n    Object.entries(obj).filter(([_, v]) => v !== undefined)\n  );\n}\n\n//Recursive implementation of jSON.stringify;\nexport const stringifyJSON = function (obj: any, visited: Set<any> = new Set()): string {\n  const arrOfKeyVals: string[] = [];\n  const arrVals: string[] = [];\n  let objKeys: string[] = [];\n\n  /*********CHECK FOR PRIMITIVE TYPES**********/\n  if (typeof obj === 'number' || typeof obj === 'boolean' || obj === null)\n    return '' + obj;\n  else if (typeof obj === 'string')\n    return '\"' + obj + '\"';\n\n  /*********DETECT CIRCULAR REFERENCES**********/\n  if (obj instanceof Object && visited.has(obj)) {\n    return '\"(circular)\"';\n  }\n\n  /*********CHECK FOR ARRAY**********/\n  else if (Array.isArray(obj)) {\n    //check for empty array\n    if (obj[0] === undefined)\n      return '[]';\n    else {\n      // Add array to visited before processing its elements\n      visited.add(obj);\n      obj.forEach(function (el) {\n        arrVals.push(stringifyJSON(el, visited));\n      });\n      return '[' + arrVals + ']';\n    }\n  }\n  /*********CHECK FOR OBJECT**********/\n  else if (obj instanceof Object) {\n    // Add object to visited before processing its properties\n    visited.add(obj);\n    //get object keys\n    objKeys = Object.keys(obj);\n    //set key output;\n    objKeys.forEach(function (key) {\n      const keyOut = '\"' + key + '\":';\n      const keyValOut = obj[key];\n      //skip functions and undefined properties\n      if (keyValOut instanceof Function || keyValOut === undefined)\n        return; // Skip this entry entirely instead of pushing an empty string\n      else if (typeof keyValOut === 'string')\n        arrOfKeyVals.push(keyOut + '\"' + keyValOut + '\"');\n      else if (typeof keyValOut === 'boolean' || typeof keyValOut === 'number' || keyValOut === null)\n        arrOfKeyVals.push(keyOut + keyValOut);\n      //check for nested objects, call recursively until no more objects\n      else if (keyValOut instanceof Object) {\n        arrOfKeyVals.push(keyOut + stringifyJSON(keyValOut, visited));\n      }\n    });\n    return '{' + arrOfKeyVals + '}';\n  }\n  return '';\n};\n"],
   "mappings": "AAEO,MAAM,QAAQ,CAAC,QAAa;AACjC,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,MAAM,MAAS;AAAA,EACxD;AACF;AAGO,MAAM,gBAAgB,SAAU,KAAU,UAAoB,oBAAI,IAAI,GAAW;AACtF,QAAM,eAAyB,CAAC;AAChC,QAAM,UAAoB,CAAC;AAC3B,MAAI,UAAoB,CAAC;AAGzB,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,aAAa,QAAQ;AACjE,WAAO,KAAK;AAAA,WACL,OAAO,QAAQ;AACtB,WAAO,MAAM,MAAM;AAGrB,MAAI,eAAe,UAAU,QAAQ,IAAI,GAAG,GAAG;AAC7C,WAAO;AAAA,EACT,WAGS,MAAM,QAAQ,GAAG,GAAG;AAE3B,QAAI,IAAI,CAAC,MAAM;AACb,aAAO;AAAA,SACJ;AAEH,cAAQ,IAAI,GAAG;AACf,UAAI,QAAQ,SAAU,IAAI;AACxB,gBAAQ,KAAK,cAAc,IAAI,OAAO,CAAC;AAAA,MACzC,CAAC;AACD,aAAO,MAAM,UAAU;AAAA,IACzB;AAAA,EACF,WAES,eAAe,QAAQ;AAE9B,YAAQ,IAAI,GAAG;AAEf,cAAU,OAAO,KAAK,GAAG;AAEzB,YAAQ,QAAQ,SAAU,KAAK;AAC7B,YAAM,SAAS,MAAM,MAAM;AAC3B,YAAM,YAAY,IAAI,GAAG;AAEzB,UAAI,qBAAqB,YAAY,cAAc;AACjD;AAAA,eACO,OAAO,cAAc;AAC5B,qBAAa,KAAK,SAAS,MAAM,YAAY,GAAG;AAAA,eACzC,OAAO,cAAc,aAAa,OAAO,cAAc,YAAY,cAAc;AACxF,qBAAa,KAAK,SAAS,SAAS;AAAA,eAE7B,qBAAqB,QAAQ;AACpC,qBAAa,KAAK,SAAS,cAAc,WAAW,OAAO,CAAC;AAAA,MAC9D;AAAA,IACF,CAAC;AACD,WAAO,MAAM,eAAe;AAAA,EAC9B;AACA,SAAO;AACT;",
   "names": []
 }

package/examples/README.md

@@ -34,6 +34,16 @@ Shows how fjell-express-router handles enterprise organizational data patterns w
 
 Perfect for understanding how to build production-ready applications with fjell-express-router.
 
+### 4. `router-handlers-example.ts` 🎯 **Router-Level Handler Precedence**
+**Advanced router customization!** Demonstrates how to define custom handlers at the router level that take precedence over library-level handlers:
+- **Router-level handlers**: Define custom actions, facets, allActions, and allFacets directly in router options
+- **Handler precedence**: Router-level handlers are called first, with fallback to library handlers
+- **Cross-system integration**: Perfect for aggregating data from multiple services or external APIs
+- **Business logic separation**: Keep complex integrations at the router layer while maintaining library simplicity
+- **Flexible architecture**: Supports both PItemRouter and CItemRouter with appropriate type safety
+
+Ideal for scenarios requiring external service calls, data aggregation, or complex business logic that shouldn't be in the core library layer.
+
 ## Key Concepts Demonstrated
 
 ### Basic Router Setup (basic-router-example.ts)
@@ -170,6 +180,12 @@ npx tsx examples/full-application-example.ts
 # Server runs on http://localhost:3003
 ```
 
+**Router Handlers Example:**
+```bash
+npx tsx examples/router-handlers-example.ts
+# Server runs on http://localhost:3004
+```
+
 ## Testing the Examples
 
 ### Basic Router Example (Port 3001)
@@ -258,6 +274,37 @@ curl -X POST http://localhost:3003/api/customers \
   }'
 ```
 
+### Router Handlers Example (Port 3004)
+```bash
+# Test router-level user actions
+curl -X POST http://localhost:3004/api/users/user-1/activate
+curl -X POST http://localhost:3004/api/users/user-1/deactivate
+
+# Test router-level user facets
+curl http://localhost:3004/api/users/user-1/profile
+curl http://localhost:3004/api/users/user-1/activity
+
+# Test router-level all actions
+curl -X POST http://localhost:3004/api/users/bulk-activate
+curl -X POST http://localhost:3004/api/users/send-notifications
+
+# Test router-level all facets
+curl http://localhost:3004/api/users/statistics
+curl http://localhost:3004/api/users/analytics
+
+# Test router-level post actions (nested under users)
+curl -X POST http://localhost:3004/api/users/user-1/posts/post-1/publish
+curl -X POST http://localhost:3004/api/users/user-1/posts/post-1/archive
+
+# Test router-level post facets
+curl http://localhost:3004/api/users/user-1/posts/post-1/analytics
+curl http://localhost:3004/api/users/user-1/posts/post-1/comments
+
+# Test fallback to library handlers for undefined router handlers
+curl -X POST http://localhost:3004/api/users/user-1/someOtherAction
+curl http://localhost:3004/api/users/user-1/someOtherFacet
+```
+
 ## Integration Patterns
 
 ### Mock Operations

package/examples/basic-router-example.ts

@@ -12,11 +12,12 @@
  */
 
 import { Item, PriKey, UUID } from '@fjell/core';
+import { NotFoundError } from '@fjell/lib';
 import express, { Application } from 'express';
 import { createRegistry, PItemRouter } from '../src';
 
 // Define our data models
-interface User extends Item<'user'> {
+export interface User extends Item<'user'> {
   id: string;
   name: string;
   email: string;
@@ -24,7 +25,7 @@ interface User extends Item<'user'> {
   lastLogin?: Date;
 }
 
-interface Task extends Item<'task'> {
+export interface Task extends Item<'task'> {
   id: string;
   title: string;
   description: string;
@@ -122,7 +123,7 @@ const createUserOperations = () => {
       console.log(`🔍 UserOperations.get(${key.pk}) - Fetching user...`);
       const user = mockUserStorage.get(String(key.pk));
       if (!user) {
-        throw new Error(`User not found: ${key.pk}`);
+        throw new NotFoundError('get', { kta: ['user', '', '', '', '', ''], scopes: [] }, key);
       }
       return user;
     },
@@ -148,7 +149,7 @@ const createUserOperations = () => {
       console.log(`🔄 UserOperations.update(${key.pk}) - Updating user...`);
       const existing = mockUserStorage.get(String(key.pk));
       if (!existing) {
-        throw new Error(`User not found: ${key.pk}`);
+        throw new NotFoundError('update', { kta: ['user', '', '', '', '', ''], scopes: [] }, key);
       }
       const updated: User = {
         ...existing,
@@ -199,7 +200,7 @@ const createTaskOperations = () => {
       console.log(`🔍 TaskOperations.get(${key.pk}) - Fetching task...`);
       const task = mockTaskStorage.get(String(key.pk));
       if (!task) {
-        throw new Error(`Task not found: ${key.pk}`);
+        throw new NotFoundError('get', { kta: ['task', '', '', '', '', ''], scopes: [] }, key);
       }
       return task;
     },
@@ -225,7 +226,7 @@ const createTaskOperations = () => {
       console.log(`🔄 TaskOperations.update(${key.pk}) - Updating task...`);
       const existing = mockTaskStorage.get(String(key.pk));
       if (!existing) {
-        throw new Error(`Task not found: ${key.pk}`);
+        throw new NotFoundError('update', { kta: ['task', '', '', '', '', ''], scopes: [] }, key);
       }
       const updated: Task = {
         ...existing,

package/examples/full-application-example.ts

@@ -12,7 +12,7 @@
  */
 
 import express, { Application, NextFunction, Request, Response } from 'express';
-import { ComKey, Item, PriKey, UUID } from '@fjell/core';
+import { ComKey, Item, LocKey, PriKey, UUID } from '@fjell/core';
 import { CItemRouter, createRegistry, PItemRouter } from '../src';
 
 // ===== Data Models =====
@@ -280,12 +280,23 @@ const createCustomerOperations = () => ({
   async update(key: PriKey<'customer'>, updates: Partial<Customer>) {
     const existing = mockCustomerStorage.get(String(key.pk));
     if (!existing) throw new Error(`Customer not found: ${key.pk}`);
-    const updated = { ...existing, ...updates };
+    const updated = {
+      ...existing,
+      ...updates,
+      key: existing.key, // Preserve the key
+      events: {
+        ...existing.events,
+        updated: { at: new Date() }
+      }
+    };
     mockCustomerStorage.set(String(key.pk), updated);
     return updated;
   },
   async remove(key: PriKey<'customer'>) {
-    return mockCustomerStorage.delete(String(key.pk));
+    const customer = mockCustomerStorage.get(String(key.pk));
+    if (!customer) throw new Error(`Customer not found: ${key.pk}`);
+    mockCustomerStorage.delete(String(key.pk));
+    return customer;
   },
   async find(finder: string, params: any) {
     const customers = Array.from(mockCustomerStorage.values());
@@ -318,12 +329,23 @@ const createProductOperations = () => ({
   async update(key: PriKey<'product'>, updates: Partial<Product>) {
     const existing = mockProductStorage.get(String(key.pk));
     if (!existing) throw new Error(`Product not found: ${key.pk}`);
-    const updated = { ...existing, ...updates };
+    const updated = {
+      ...existing,
+      ...updates,
+      key: existing.key, // Preserve the key
+      events: {
+        ...existing.events,
+        updated: { at: new Date() }
+      }
+    };
     mockProductStorage.set(String(key.pk), updated);
     return updated;
   },
   async remove(key: PriKey<'product'>) {
-    return mockProductStorage.delete(String(key.pk));
+    const product = mockProductStorage.get(String(key.pk));
+    if (!product) throw new Error(`Product not found: ${key.pk}`);
+    mockProductStorage.delete(String(key.pk));
+    return product;
   },
   async find(finder: string, params: any) {
     const products = Array.from(mockProductStorage.values());
@@ -344,25 +366,54 @@ const createOrderOperations = () => ({
     if (!order) throw new Error(`Order not found: ${key.pk}`);
     return order;
   },
-  async create(item: Order) {
+  async create(item: Order, options?: { locations?: any[] }) {
+    console.log('Order create called with:', { item, options });
     const id = `order-${Date.now()}`;
+    // Extract customerId from locations (passed from URL params) or item data
+    const customerId = options?.locations?.[0]?.lk || item.customerId;
+    console.log('Extracted customerId:', customerId);
+    if (!customerId) {
+      throw new Error('CustomerId is required for order creation');
+    }
     const newOrder: Order = {
       ...item,
       id,
-      key: { kt: 'order', pk: id as UUID, loc: (item.key as any)?.loc || [] },
+      customerId,
+      orderDate: item.orderDate ? new Date(item.orderDate) : new Date(),
+      key: {
+        kt: 'order',
+        pk: id as UUID,
+        loc: [{ kt: 'customer', lk: customerId }]
+      },
       events: { created: { at: new Date() }, updated: { at: new Date() }, deleted: { at: null } }
     };
+    console.log('Created order:', newOrder);
     mockOrderStorage.set(id, newOrder);
     return newOrder;
   },
   async update(key: ComKey<'order', 'customer'>, updates: Partial<Order>) {
     const existing = mockOrderStorage.get(String(key.pk));
     if (!existing) throw new Error(`Order not found: ${key.pk}`);
-    const updated = { ...existing, ...updates };
+    const updated = {
+      ...existing,
+      ...updates,
+      // Ensure orderDate is a Date object if it's being updated
+      ...(updates.orderDate && { orderDate: new Date(updates.orderDate) }),
+      key: existing.key, // Preserve the key
+      events: {
+        ...existing.events,
+        updated: { at: new Date() }
+      }
+    };
     mockOrderStorage.set(String(key.pk), updated);
     return updated;
   },
-  async remove(key: ComKey<'order', 'customer'>) { return mockOrderStorage.delete(String(key.pk)); },
+  async remove(key: ComKey<'order', 'customer'>) {
+    const order = mockOrderStorage.get(String(key.pk));
+    if (!order) throw new Error(`Order not found: ${key.pk}`);
+    mockOrderStorage.delete(String(key.pk));
+    return order;
+  },
   async find(finder: string, params: any) {
     const orders = Array.from(mockOrderStorage.values());
     switch (finder) {
@@ -376,6 +427,7 @@ const createOrderOperations = () => ({
 // ===== Middleware =====
 const errorHandler = (err: Error, req: Request, res: Response, next: NextFunction) => {
   console.error('❌ Application Error:', err.message);
+  console.error('❌ Stack trace:', err.stack);
   res.status(500).json({
     error: 'Internal Server Error',
     message: process.env.NODE_ENV === 'development' ? err.message : 'Something went wrong'
@@ -425,6 +477,36 @@ export const runFullApplicationExample = async (): Promise<{ app: Application }>
   app.use(requestLogger);
   app.use(validateCustomerTier);
 
+  // JSON parsing error handler
+  app.use((err: any, req: Request, res: Response, next: NextFunction) => {
+    if (err instanceof SyntaxError && 'body' in err) {
+      return res.status(400).json({ error: 'Invalid JSON' });
+    }
+    next(err);
+  });
+
+  // Validation middleware for customer creation only (not nested routes)
+  app.use('/api/customers', (req, res, next) => {
+    // Only validate for direct customer creation, not nested routes like orders
+    if (req.method === 'POST' && req.path === '/') {
+      const { name, email } = req.body;
+      if (!name || !email) {
+        return res.status(500).json({ error: 'Missing required fields: name and email' });
+      }
+    }
+    next();
+  });
+
+  app.use('/api/products', (req, res, next) => {
+    if (req.method === 'POST') {
+      const { name, price, category } = req.body;
+      if (!name || typeof price !== 'number' || !category) {
+        return res.status(500).json({ error: 'Missing required fields: name, price, and category' });
+      }
+    }
+    next();
+  });
+
   // ===== CORS and Security Headers =====
   app.use((req, res, next) => {
     res.header('Access-Control-Allow-Origin', '*');
@@ -461,10 +543,53 @@ export const runFullApplicationExample = async (): Promise<{ app: Application }>
   });
 
   // Core entity routes
-  app.use('/api/customers', customerRouter.getRouter());
   app.use('/api/products', productRouter.getRouter());
+
+  // Mount order router BEFORE customer router to avoid conflicts
+  // Middleware to extract customerPk parameter for order router
+  app.use('/api/customers/:customerPk/orders', (req, res, next) => {
+    res.locals.customerPk = req.params.customerPk;
+    next();
+  });
   app.use('/api/customers/:customerPk/orders', orderRouter.getRouter());
 
+  // Customer router last to avoid route conflicts
+  app.use('/api/customers', customerRouter.getRouter());
+
+  // Custom find routes for better test compatibility
+  app.get('/api/customers/find/:finder', async (req, res, next) => {
+    try {
+      const { finder } = req.params;
+      const params = req.query;
+      const customers = await customerInstance.operations.find(finder, params);
+      res.json(customers);
+    } catch (error) {
+      next(error);
+    }
+  });
+
+  app.get('/api/products/find/:finder', async (req, res, next) => {
+    try {
+      const { finder } = req.params;
+      const params = req.query;
+      const products = await productInstance.operations.find(finder, params);
+      res.json(products);
+    } catch (error) {
+      next(error);
+    }
+  });
+
+  app.get('/api/customers/:customerPk/orders/find/:finder', async (req, res, next) => {
+    try {
+      const { finder } = req.params;
+      const params = req.query;
+      const orders = await orderInstance.operations.find(finder, params);
+      res.json(orders);
+    } catch (error) {
+      next(error);
+    }
+  });
+
   // Business logic routes
   app.get('/api/dashboard', async (req, res, next) => {
     try {
@@ -489,7 +614,7 @@ export const runFullApplicationExample = async (): Promise<{ app: Application }>
         }, {}),
         featuredProducts: products.filter((product: Product) => product.featured),
         recentOrders: orders
-          .sort((a: Order, b: Order) => b.orderDate.getTime() - a.orderDate.getTime())
+          .sort((a: Order, b: Order) => new Date(b.orderDate).getTime() - new Date(a.orderDate).getTime())
           .slice(0, 10)
       };
 
@@ -561,7 +686,7 @@ export const runFullApplicationExample = async (): Promise<{ app: Application }>
           }, {})
         },
         recentOrders: customerOrders
-          .sort((a: Order, b: Order) => b.orderDate.getTime() - a.orderDate.getTime())
+          .sort((a: Order, b: Order) => new Date(b.orderDate).getTime() - new Date(a.orderDate).getTime())
           .slice(0, 5)
       };