@fjell/express-router 4.4.23 → 4.4.25

package/dist/ItemRouter.js

@@ -49,15 +49,31 @@ class ItemRouter {
     const libOperations = this.lib.operations;
     this.logger.debug("Posting All Action", { query: req?.query, params: req?.params, locals: res?.locals });
     const allActionKey = req.path.substring(req.path.lastIndexOf("/") + 1);
+    if (this.options.allActions && this.options.allActions[allActionKey]) {
+      this.logger.debug("Using router-level all action handler", { allActionKey });
+      try {
+        const result = await this.options.allActions[allActionKey](
+          req.body,
+          this.getLKA(res),
+          { req, res }
+        );
+        if (result != null) res.json(result);
+        return;
+      } catch (err) {
+        this.logger.error("Error in router-level all action", { message: err?.message, stack: err?.stack });
+        res.status(500).json(err);
+        return;
+      }
+    }
     if (!libOptions.allActions) {
-      this.logger.error("Item Actions are not configured");
-      res.status(500).json({ error: "Item Actions are not configured" });
+      this.logger.error("All Actions are not configured");
+      res.status(500).json({ error: "All Actions are not configured" });
       return;
     }
     const allAction = libOptions.allActions[allActionKey];
     if (!allAction) {
       this.logger.error("All Action is not configured", { allActionKey });
-      res.status(500).json({ error: "Item Action is not configured" });
+      res.status(500).json({ error: "All Action is not configured" });
       return;
     }
     try {
@@ -72,15 +88,31 @@ class ItemRouter {
     const libOperations = this.lib.operations;
     this.logger.debug("Getting All Facet", { query: req?.query, params: req?.params, locals: res?.locals });
     const facetKey = req.path.substring(req.path.lastIndexOf("/") + 1);
+    if (this.options.allFacets && this.options.allFacets[facetKey]) {
+      this.logger.debug("Using router-level all facet handler", { facetKey });
+      try {
+        const result = await this.options.allFacets[facetKey](
+          req.query,
+          this.getLKA(res),
+          { req, res }
+        );
+        if (result != null) res.json(result);
+        return;
+      } catch (err) {
+        this.logger.error("Error in router-level all facet", { message: err?.message, stack: err?.stack });
+        res.status(500).json(err);
+        return;
+      }
+    }
     if (!libOptions.allFacets) {
-      this.logger.error("Item Facets are not configured");
-      res.status(500).json({ error: "Item Facets are not configured" });
+      this.logger.error("All Facets are not configured");
+      res.status(500).json({ error: "All Facets are not configured" });
       return;
     }
     const facet = libOptions.allFacets[facetKey];
     if (!facet) {
-      this.logger.error("Item Facet is not configured", { facetKey });
-      res.status(500).json({ error: "Item Facet is not configured" });
+      this.logger.error("All Facet is not configured", { facetKey });
+      res.status(500).json({ error: "All Facet is not configured" });
       return;
     }
     try {
@@ -94,9 +126,25 @@ class ItemRouter {
   postItemAction = async (req, res) => {
     const libOptions = this.lib.options;
     const libOperations = this.lib.operations;
-    this.logger.debug("Getting Item", { query: req?.query, params: req?.params, locals: res?.locals });
+    this.logger.debug("Posting Item Action", { query: req?.query, params: req?.params, locals: res?.locals });
     const ik = this.getIk(res);
     const actionKey = req.path.substring(req.path.lastIndexOf("/") + 1);
+    if (this.options.actions && this.options.actions[actionKey]) {
+      this.logger.debug("Using router-level action handler", { actionKey });
+      try {
+        const result = await this.options.actions[actionKey](
+          ik,
+          req.body,
+          { req, res }
+        );
+        if (result != null) res.json(result);
+        return;
+      } catch (err) {
+        this.logger.error("Error in router-level action", { message: err?.message, stack: err?.stack });
+        res.status(500).json(err);
+        return;
+      }
+    }
     if (!libOptions.actions) {
       this.logger.error("Item Actions are not configured");
       res.status(500).json({ error: "Item Actions are not configured" });
@@ -118,9 +166,25 @@ class ItemRouter {
   getItemFacet = async (req, res) => {
     const libOptions = this.lib.options;
     const libOperations = this.lib.operations;
-    this.logger.debug("Getting Item", { query: req?.query, params: req?.params, locals: res?.locals });
+    this.logger.debug("Getting Item Facet", { query: req?.query, params: req?.params, locals: res?.locals });
     const ik = this.getIk(res);
     const facetKey = req.path.substring(req.path.lastIndexOf("/") + 1);
+    if (this.options.facets && this.options.facets[facetKey]) {
+      this.logger.debug("Using router-level facet handler", { facetKey });
+      try {
+        const result = await this.options.facets[facetKey](
+          ik,
+          req.query,
+          { req, res }
+        );
+        if (result != null) res.json(result);
+        return;
+      } catch (err) {
+        this.logger.error("Error in router-level facet", { message: err?.message, stack: err?.stack });
+        res.status(500).json(err);
+        return;
+      }
+    }
     if (!libOptions.facets) {
       this.logger.error("Item Facets are not configured");
       res.status(500).json({ error: "Item Facets are not configured" });
@@ -225,9 +289,25 @@ class ItemRouter {
     const libOperations = this.lib.operations;
     this.logger.debug("Deleting Item", { query: req.query, params: req.params, locals: res.locals });
     const ik = this.getIk(res);
-    const removedItem = await libOperations.remove(ik);
-    const item = validatePK(removedItem, this.getPkType());
-    res.json(item);
+    try {
+      const removedItem = await libOperations.remove(ik);
+      const item = validatePK(removedItem, this.getPkType());
+      res.json(item);
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        this.logger.error("Item Not Found for Delete", { ik, message: err?.message, stack: err?.stack });
+        res.status(404).json({
+          ik,
+          message: "Item Not Found"
+        });
+      } else {
+        this.logger.error("General Error in Delete", { ik, message: err?.message, stack: err?.stack });
+        res.status(500).json({
+          ik,
+          message: "General Error"
+        });
+      }
+    }
   };
   /* eslint-disable */
   /* istanbul ignore next */
@@ -265,9 +345,25 @@ class ItemRouter {
       { body: req?.body, query: req?.query, params: req?.params, locals: res?.locals }
     );
     const ik = this.getIk(res);
-    const itemToUpdate = this.convertDates(req.body);
-    const retItem = validatePK(await libOperations.update(ik, itemToUpdate), this.getPkType());
-    res.json(retItem);
+    try {
+      const itemToUpdate = this.convertDates(req.body);
+      const retItem = validatePK(await libOperations.update(ik, itemToUpdate), this.getPkType());
+      res.json(retItem);
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        this.logger.error("Item Not Found for Update", { ik, message: err?.message, stack: err?.stack });
+        res.status(404).json({
+          ik,
+          message: "Item Not Found"
+        });
+      } else {
+        this.logger.error("General Error in Update", { ik, message: err?.message, stack: err?.stack });
+        res.status(500).json({
+          ik,
+          message: "General Error"
+        });
+      }
+    }
   };
   convertDates = (item) => {
     const events = item.events;

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\n/**\n * Router-level action method signature - aligned with library ActionMethod pattern\n * Takes the resolved item key, action parameters, and HTTP context\n */\nexport interface RouterActionMethod<\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    ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>,\n    actionParams: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n    context: { req: Request, res: Response }\n  ): Promise<any>;\n}\n\n/**\n * Router-level facet method signature - aligned with library FacetMethod pattern\n * Takes the resolved item key, facet parameters, and HTTP context\n */\nexport interface RouterFacetMethod<\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    ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>,\n    facetParams: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n    context: { req: Request, res: Response }\n  ): Promise<any>;\n}\n\n/**\n * Router-level all action method signature - aligned with library AllActionMethod pattern\n * Takes action parameters, optional locations, and HTTP context\n */\nexport interface RouterAllActionMethod<\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    allActionParams: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n    locations: LocKeyArray<L1, L2, L3, L4, L5> | [],\n    context: { req: Request, res: Response }\n  ): Promise<any>;\n}\n\n/**\n * Router-level all facet method signature - aligned with library AllFacetMethod pattern\n * Takes facet parameters, optional locations, and HTTP context\n */\nexport interface RouterAllFacetMethod<\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    allFacetParams: Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n    locations: LocKeyArray<L1, L2, L3, L4, L5> | [],\n    context: { req: Request, res: Response }\n  ): Promise<any>;\n}\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  /**\n   * Handlers for item actions - aligned with library operation signatures\n   * The key in the Record is the action name, method receives resolved item key and parameters\n   */\n  actions?: Record<string, RouterActionMethod<S, L1, L2, L3, L4, L5>>;\n\n  /**\n   * Handlers for item facets - aligned with library operation signatures\n   * The key in the Record is the facet name, method receives resolved item key and parameters\n   */\n  facets?: Record<string, RouterFacetMethod<S, L1, L2, L3, L4, L5>>;\n\n  /**\n   * Handlers for all actions - aligned with library operation signatures\n   * The key in the Record is the action name, method receives parameters and optional locations\n   */\n  allActions?: Record<string, RouterAllActionMethod<L1, L2, L3, L4, L5>>;\n\n  /**\n   * Handlers for all facets - aligned with library operation signatures\n   * The key in the Record is the facet name, method receives parameters and optional locations\n   */\n  allFacets?: Record<string, RouterAllFacetMethod<L1, L2, L3, L4, L5>>;\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        const result = await this.options.allActions[allActionKey](\n          req.body as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n          this.getLKA(res) as LocKeyArray<L1, L2, L3, L4, L5> | [],\n          { req, res }\n        );\n        if (result != null) res.json(result);\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        const result = await this.options.allFacets[facetKey](\n          req.query as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n          this.getLKA(res) as LocKeyArray<L1, L2, L3, L4, L5> | [],\n          { req, res }\n        );\n        if (result != null) res.json(result);\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        const result = await this.options.actions[actionKey](\n          ik,\n          req.body as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n          { req, res }\n        );\n        if (result != null) res.json(result);\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        const result = await this.options.facets[facetKey](\n          ik,\n          req.query as Record<string, string | number | boolean | Date | Array<string | number | boolean | Date>>,\n          { req, res }\n        );\n        if (result != null) res.json(result);\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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/util/general.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG;;CAI7B,CAAA;AAGD,eAAO,MAAM,aAAa,GAAa,KAAK,GAAG,EAAE,UAAS,GAAG,CAAC,GAAG,CAAa,KAAG,MAuDhF,CAAC"}
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/util/general.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG;;CAI7B,CAAA;AAGD,eAAO,MAAM,aAAa,GAAa,KAAK,GAAG,EAAE,UAAS,GAAG,CAAC,GAAG,CAAa,KAAG,MAuDhF,CAAC"}

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};"],
-  "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;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-unused-vars */\n\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};\n"],
+  "mappings": "AAGO,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,