@fjell/express-router 4.4.23 → 4.4.24

package/README.md

@@ -110,6 +110,207 @@ This creates endpoints like:
 
 ## Advanced Usage
 
+### Router-Level Handlers
+
+Fjell Express Router supports router-level handlers for actions, facets, allActions, and allFacets. These handlers take precedence over library-level handlers and are ideal for implementing cross-system integrations, external service calls, or complex business logic that doesn't belong in the library layer.
+
+#### When to Use Router-Level Handlers
+
+- **Cross-system integrations**: When you need to call external services (APIs, databases, etc.)
+- **Complex aggregations**: When you need to combine data from multiple sources
+- **External notifications**: When you need to send emails, push notifications, etc.
+- **Audit logging**: When you need to log actions to external systems
+- **Caching strategies**: When you need custom caching logic
+
+#### Example: Router-Level Handlers
+
+```typescript
+import { PItemRouter, CItemRouter } from '@fjell/express-router';
+import { Item, PriKey, ComKey } from '@fjell/core';
+import { Request, Response } from 'express';
+
+// Define your data models
+interface User extends Item<'user'> {
+  id: string;
+  name: string;
+  email: string;
+}
+
+interface Post extends Item<'post', 'user'> {
+  id: string;
+  title: string;
+  content: string;
+  authorId: string;
+}
+
+// Create routers with router-level handlers
+const userRouter = new PItemRouter(userInstance, 'user', {
+  // Router-level action handlers
+  actions: {
+    activate: async (req: Request, res: Response, ik: PriKey<'user'>) => {
+      // Custom logic: send activation email, update status, etc.
+      const user = await userInstance.operations.get(ik);
+      await emailService.sendActivationEmail(user.email);
+      await auditService.logAction('user_activated', ik.pk);
+
+      res.json({
+        message: 'User activated via router handler',
+        userId: ik.pk,
+        emailSent: true
+      });
+    },
+    deactivate: async (req: Request, res: Response, ik: PriKey<'user'>) => {
+      // Custom logic: send deactivation notification, update status, etc.
+      const user = await userInstance.operations.get(ik);
+      await notificationService.sendDeactivationNotification(user);
+      await auditService.logAction('user_deactivated', ik.pk);
+
+      res.json({
+        message: 'User deactivated via router handler',
+        userId: ik.pk,
+        notificationSent: true
+      });
+    }
+  },
+
+  // Router-level facet handlers
+  facets: {
+    profile: async (req: Request, res: Response, ik: PriKey<'user'>) => {
+      // Custom logic: aggregate data from multiple sources
+      const user = await userInstance.operations.get(ik);
+      const socialData = await socialService.getUserData(ik.pk);
+      const preferences = await preferenceService.getUserPreferences(ik.pk);
+
+      res.json({
+        userId: ik.pk,
+        basicInfo: user,
+        socialInfo: socialData,
+        preferences: preferences
+      });
+    },
+    stats: async (req: Request, res: Response, ik: PriKey<'user'>) => {
+      // Custom logic: calculate statistics from multiple data sources
+      const postsCount = await postService.getUserPostsCount(ik.pk);
+      const commentsCount = await commentService.getUserCommentsCount(ik.pk);
+      const likesReceived = await likeService.getUserLikesCount(ik.pk);
+
+      res.json({
+        userId: ik.pk,
+        postsCount,
+        commentsCount,
+        likesReceived,
+        lastActivity: new Date()
+      });
+    }
+  },
+
+  // Router-level all action handlers
+  allActions: {
+    bulkActivate: async (req: Request, res: Response) => {
+      // Custom logic: batch processing, external service integration
+      const { userIds } = req.body;
+      const results = await Promise.all(
+        userIds.map(async (userId) => {
+          const user = await userInstance.operations.get({ kt: 'user', pk: userId });
+          await emailService.sendActivationEmail(user.email);
+          return { userId, emailSent: true };
+        })
+      );
+
+      res.json({
+        message: 'Bulk activation via router handler',
+        processedUsers: results.length,
+        results
+      });
+    }
+  },
+
+  // Router-level all facet handlers
+  allFacets: {
+    userStats: async (req: Request, res: Response) => {
+      // Custom logic: aggregate statistics from multiple systems
+      const totalUsers = await userInstance.operations.all().then(users => users.length);
+      const activeUsers = await analyticsService.getActiveUsersCount();
+      const newUsersThisMonth = await analyticsService.getNewUsersThisMonth();
+
+      res.json({
+        totalUsers,
+        activeUsers,
+        newUsersThisMonth,
+        systemHealth: 'excellent'
+      });
+    }
+  }
+});
+
+// Child router with router-level handlers
+const postRouter = new CItemRouter(postInstance, 'post', userRouter, {
+  actions: {
+    publish: async (req: Request, res: Response, ik: ComKey<'post', 'user'>) => {
+      // Custom logic: publish to social media, send notifications
+      const post = await postInstance.operations.get(ik);
+      await socialMediaService.publishToTwitter(post);
+      await socialMediaService.publishToLinkedIn(post);
+      await notificationService.notifyFollowers(post.authorId, post);
+
+      res.json({
+        message: 'Post published via router handler',
+        postId: ik.pk,
+        socialMediaPosted: true,
+        notificationsSent: true
+      });
+    }
+  },
+
+  facets: {
+    analytics: async (req: Request, res: Response, ik: ComKey<'post', 'user'>) => {
+      // Custom logic: aggregate analytics from multiple sources
+      const views = await analyticsService.getPostViews(ik.pk);
+      const likes = await socialService.getPostLikes(ik.pk);
+      const shares = await socialService.getPostShares(ik.pk);
+
+      res.json({
+        postId: ik.pk,
+        views,
+        likes,
+        shares,
+        engagementRate: (likes + shares) / views
+      });
+    }
+  }
+});
+```
+
+#### Handler Priority
+
+Router-level handlers take precedence over library-level handlers:
+
+1. **Router-level handler exists**: Use router handler
+2. **Router-level handler doesn't exist**: Fallback to library handler
+3. **No handlers exist**: Return error
+
+This allows you to:
+- Override specific handlers while keeping others at the library level
+- Implement handlers only at the router level when needed
+- Mix and match router and library handlers as appropriate
+
+#### Handler Signatures
+
+**Item Actions & Facets** (for PItemRouter):
+```typescript
+async (req: Request, res: Response, ik: PriKey<S>) => Promise<void>
+```
+
+**Item Actions & Facets** (for CItemRouter):
+```typescript
+async (req: Request, res: Response, ik: ComKey<S, L1, L2, L3, L4, L5>) => Promise<void>
+```
+
+**All Actions & Facets** (for both router types):
+```typescript
+async (req: Request, res: Response) => Promise<void>
+```
+
 ### Custom Business Logic
 
 Add custom routes alongside automatic CRUD operations:
@@ -234,6 +435,7 @@ This package includes comprehensive examples in the `examples/` directory:
 
 - **`basic-router-example.ts`** - Start here for fundamental usage patterns
 - **`nested-router-example.ts`** - Hierarchical data management with organizations/departments/employees
+- **`router-handlers-example.ts`** - Router-level handlers for cross-system integrations
 - **`full-application-example.ts`** - Production-ready e-commerce application
 
 Run examples:
@@ -245,6 +447,9 @@ npx tsx examples/basic-router-example.ts
 # Nested routing example
 npx tsx examples/nested-router-example.ts
 
+# Router handlers example
+npx tsx examples/router-handlers-example.ts
+
 # Full application example
 npx tsx examples/full-application-example.ts
 ```

package/dist/CItemRouter.d.ts

@@ -4,7 +4,7 @@ import { ItemRouter, ItemRouterOptions } from "./ItemRouter.js";
 import { Instance } from "./Instance.js";
 export declare class CItemRouter<T extends Item<S, L1, L2, L3, L4, L5>, S extends string, L1 extends string, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never> extends ItemRouter<S, L1, L2, L3, L4, L5> {
     private parentRoute;
-    constructor(lib: Instance<T, S, L1, L2, L3, L4, L5>, type: S, parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>, options?: ItemRouterOptions);
+    constructor(lib: Instance<T, S, L1, L2, L3, L4, L5>, type: S, parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>, options?: ItemRouterOptions<S, L1, L2, L3, L4, L5>);
     hasParent(): boolean;
     getIk(res: Response): ComKey<S, L1, L2, L3, L4, L5>;
     getLKA(res: Response): LocKeyArray<S, L1, L2, L3, L4>;

package/dist/CItemRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CItemRouter.d.ts","sourceRoot":"","sources":["../src/CItemRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAAE,IAAI,EAAqB,WAAW,EAC7C,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMzC,qBAAa,WAAW,CACtB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,CACzB,SAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAEzC,OAAO,CAAC,WAAW,CAAwC;gBAGzD,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACvC,IAAI,EAAE,CAAC,EACP,WAAW,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAClD,OAAO,GAAE,iBAAsB;IAM1B,SAAS,IAAI,OAAO;IAIpB,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAMnD,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAWrD,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAInE,SAAS,CAAC,UAAU,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBASvD;IAEF,SAAS,CAAC,SAAS,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBA4BtD;CAEH"}
+{"version":3,"file":"CItemRouter.d.ts","sourceRoot":"","sources":["../src/CItemRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAAE,IAAI,EAAqB,WAAW,EAC7C,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMzC,qBAAa,WAAW,CACtB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,EACjB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,CACzB,SAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAEzC,OAAO,CAAC,WAAW,CAAwC;gBAGzD,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACvC,IAAI,EAAE,CAAC,EACP,WAAW,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAClD,OAAO,GAAE,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAM;IAMjD,SAAS,IAAI,OAAO;IAIpB,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAMnD,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAWrD,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAInE,SAAS,CAAC,UAAU,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBAuBvD;IAEF,SAAS,CAAC,SAAS,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,mBA4BtD;CAEH"}

package/dist/CItemRouter.js

@@ -2,6 +2,7 @@ import {
   paramsToQuery,
   validatePK
 } from "@fjell/core";
+import { NotFoundError } from "@fjell/lib";
 import { ItemRouter } from "./ItemRouter.js";
 class CItemRouter extends ItemRouter {
   parentRoute;
@@ -28,14 +29,28 @@ class CItemRouter extends ItemRouter {
   createItem = async (req, res) => {
     const libOperations = this.lib.operations;
     this.logger.default("Creating Item", { body: req?.body, query: req?.query, params: req?.params, locals: res?.locals });
-    const itemToCreate = this.convertDates(req.body);
-    let item = validatePK(await libOperations.create(
-      itemToCreate,
-      { locations: this.getLocations(res) }
-    ), this.getPkType());
-    item = await this.postCreateItem(item);
-    this.logger.default("Created Item %j", item);
-    res.json(item);
+    try {
+      const itemToCreate = this.convertDates(req.body);
+      let item = validatePK(await libOperations.create(
+        itemToCreate,
+        { locations: this.getLocations(res) }
+      ), this.getPkType());
+      item = await this.postCreateItem(item);
+      this.logger.default("Created Item %j", item);
+      res.json(item);
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        this.logger.error("Item Not Found for Create", { message: err?.message, stack: err?.stack });
+        res.status(404).json({
+          message: "Item Not Found"
+        });
+      } else {
+        this.logger.error("General Error in Create", { message: err?.message, stack: err?.stack });
+        res.status(500).json({
+          message: "General Error"
+        });
+      }
+    }
   };
   findItems = async (req, res) => {
     const libOperations = this.lib.operations;

package/dist/CItemRouter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/CItemRouter.ts"],
-  "sourcesContent": ["import {\n  ComKey, Item, ItemQuery, LocKey, LocKeyArray, paramsToQuery, PriKey, QueryParams, validatePK\n} from \"@fjell/core\";\nimport { Request, Response } from \"express\";\nimport { ItemRouter, ItemRouterOptions } from \"./ItemRouter.js\";\nimport { Instance } from \"./Instance.js\";\n\ninterface ParsedQuery {\n  [key: string]: undefined | string | string[] | ParsedQuery | ParsedQuery[];\n}\n\nexport class CItemRouter<\n  T extends Item<S, L1, L2, L3, L4, L5>,\n  S extends string,\n  L1 extends string,\n  L2 extends string = never,\n  L3 extends string = never,\n  L4 extends string = never,\n  L5 extends string = never\n> extends ItemRouter<S, L1, L2, L3, L4, L5> {\n\n  private parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>;\n\n  constructor(\n    lib: Instance<T, S, L1, L2, L3, L4, L5>,\n    type: S,\n    parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>,\n    options: ItemRouterOptions = {},\n  ) {\n    super(lib as any, type, options);\n    this.parentRoute = parentRoute;\n  }\n\n  public hasParent(): boolean {\n    return !!this.parentRoute;\n  }\n\n  public getIk(res: Response): ComKey<S, L1, L2, L3, L4, L5> {\n    const pri = this.getPk(res) as PriKey<S>;\n    const loc = this.getLocations(res) as LocKeyArray<L1, L2, L3, L4, L5>;\n    return { kt: pri.kt, pk: pri.pk, loc }\n  }\n\n  public getLKA(res: Response): LocKeyArray<S, L1, L2, L3, L4> {\n    /**\n     * A location key array is passed to a child router to provide contextfor the items it will\n     * be working with.  It is always a concatenation of \"My LKA\" + \"Parent LKA\" which will\n     * bubble all the way up to the root Primary.\n     */\n    let lka: LocKey<S | L1 | L2 | L3 | L4>[] = [this.getLk(res)];\n    lka = lka.concat(this.parentRoute.getLKA(res) as LocKey<S | L1 | L2 | L3 | L4>[]);\n    return lka as LocKeyArray<S, L1, L2, L3, L4>;\n  }\n\n  public getLocations(res: Response): LocKeyArray<L1, L2, L3, L4, L5> {\n    return this.parentRoute.getLKA(res) as LocKeyArray<L1, L2, L3, L4, L5>;\n  }\n\n  protected 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, L1, L2, L3, L4, L5>);\n    let item = validatePK(await libOperations.create(\n      itemToCreate, { locations: this.getLocations(res) }), this.getPkType()) as Item<S, L1, L2, L3, L4, L5>;\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    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    let items: Item<S, L1, L2, L3, L4, L5>[] = [];\n\n    if (finder) {\n      // If finder is defined?  Call a finder.\n      this.logger.default('Finding Items with Finder', { finder, finderParams, one });\n\n      if (one === 'true') {\n        const item = await (this.lib as any).findOne(finder, JSON.parse(finderParams), this.getLocations(res));\n        items = item ? [item] : [];\n      } else {\n        items = await libOperations.find(finder, JSON.parse(finderParams), this.getLocations(res));\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 Query: %j', itemQuery);\n      items = await libOperations.all(itemQuery, this.getLocations(res));\n      this.logger.default('Found %d Items with Query', items.length);\n    }\n\n    res.json(items.map((item: Item<S, L1, L2, L3, L4, L5>) => validatePK(item, this.getPkType())));\n  };\n\n}\n"],
-  "mappings": "AAAA;AAAA,EACgD;AAAA,EAAoC;AAAA,OAC7E;AAEP,SAAS,kBAAqC;AAOvC,MAAM,oBAQH,WAAkC;AAAA,EAElC;AAAA,EAER,YACE,KACA,MACA,aACA,UAA6B,CAAC,GAC9B;AACA,UAAM,KAAY,MAAM,OAAO;AAC/B,SAAK,cAAc;AAAA,EACrB;AAAA,EAEO,YAAqB;AAC1B,WAAO,CAAC,CAAC,KAAK;AAAA,EAChB;AAAA,EAEO,MAAM,KAA8C;AACzD,UAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,UAAM,MAAM,KAAK,aAAa,GAAG;AACjC,WAAO,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;AAAA,EACvC;AAAA,EAEO,OAAO,KAA+C;AAM3D,QAAI,MAAuC,CAAC,KAAK,MAAM,GAAG,CAAC;AAC3D,UAAM,IAAI,OAAO,KAAK,YAAY,OAAO,GAAG,CAAoC;AAChF,WAAO;AAAA,EACT;AAAA,EAEO,aAAa,KAAgD;AAClE,WAAO,KAAK,YAAY,OAAO,GAAG;AAAA,EACpC;AAAA,EAEU,aAAa,OAAO,KAAc,QAAkB;AAC5D,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,MAAM,KAAK,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,QAAQ,KAAK,OAAO,CAAC;AACrH,UAAM,eAAe,KAAK,aAAa,IAAI,IAAmC;AAC9E,QAAI,OAAO,WAAW,MAAM,cAAc;AAAA,MACxC;AAAA,MAAc,EAAE,WAAW,KAAK,aAAa,GAAG,EAAE;AAAA,IAAC,GAAG,KAAK,UAAU,CAAC;AACxE,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,UAAM,QAAqB,IAAI;AAC/B,UAAM,SAAS,MAAM,QAAQ;AAC7B,UAAM,eAAe,MAAM,cAAc;AACzC,UAAM,MAAM,MAAM,KAAK;AAEvB,QAAI,QAAuC,CAAC;AAE5C,QAAI,QAAQ;AAEV,WAAK,OAAO,QAAQ,6BAA6B,EAAE,QAAQ,cAAc,IAAI,CAAC;AAE9E,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAO,KAAK,IAAY,QAAQ,QAAQ,KAAK,MAAM,YAAY,GAAG,KAAK,aAAa,GAAG,CAAC;AACrG,gBAAQ,OAAO,CAAC,IAAI,IAAI,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,MAAM,cAAc,KAAK,QAAQ,KAAK,MAAM,YAAY,GAAG,KAAK,aAAa,GAAG,CAAC;AAAA,MAC3F;AAAA,IACF,OAAO;AAEL,YAAM,YAAuB,cAAc,IAAI,KAAoB;AACnE,WAAK,OAAO,QAAQ,gCAAgC,SAAS;AAC7D,cAAQ,MAAM,cAAc,IAAI,WAAW,KAAK,aAAa,GAAG,CAAC;AACjE,WAAK,OAAO,QAAQ,6BAA6B,MAAM,MAAM;AAAA,IAC/D;AAEA,QAAI,KAAK,MAAM,IAAI,CAAC,SAAsC,WAAW,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;AAAA,EAC/F;AAEF;",
+  "sourcesContent": ["import {\n  ComKey, Item, ItemQuery, LocKey, LocKeyArray, paramsToQuery, PriKey, QueryParams, validatePK\n} from \"@fjell/core\";\nimport { NotFoundError } from \"@fjell/lib\";\nimport { Request, Response } from \"express\";\nimport { ItemRouter, ItemRouterOptions } from \"./ItemRouter.js\";\nimport { Instance } from \"./Instance.js\";\n\ninterface ParsedQuery {\n  [key: string]: undefined | string | string[] | ParsedQuery | ParsedQuery[];\n}\n\nexport class CItemRouter<\n  T extends Item<S, L1, L2, L3, L4, L5>,\n  S extends string,\n  L1 extends string,\n  L2 extends string = never,\n  L3 extends string = never,\n  L4 extends string = never,\n  L5 extends string = never\n> extends ItemRouter<S, L1, L2, L3, L4, L5> {\n\n  private parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>;\n\n  constructor(\n    lib: Instance<T, S, L1, L2, L3, L4, L5>,\n    type: S,\n    parentRoute: ItemRouter<L1, L2, L3, L4, L5, never>,\n    options: ItemRouterOptions<S, L1, L2, L3, L4, L5> = {},\n  ) {\n    super(lib as any, type, options);\n    this.parentRoute = parentRoute;\n  }\n\n  public hasParent(): boolean {\n    return !!this.parentRoute;\n  }\n\n  public getIk(res: Response): ComKey<S, L1, L2, L3, L4, L5> {\n    const pri = this.getPk(res) as PriKey<S>;\n    const loc = this.getLocations(res) as LocKeyArray<L1, L2, L3, L4, L5>;\n    return { kt: pri.kt, pk: pri.pk, loc }\n  }\n\n  public getLKA(res: Response): LocKeyArray<S, L1, L2, L3, L4> {\n    /**\n     * A location key array is passed to a child router to provide contextfor the items it will\n     * be working with.  It is always a concatenation of \"My LKA\" + \"Parent LKA\" which will\n     * bubble all the way up to the root Primary.\n     */\n    let lka: LocKey<S | L1 | L2 | L3 | L4>[] = [this.getLk(res)];\n    lka = lka.concat(this.parentRoute.getLKA(res) as LocKey<S | L1 | L2 | L3 | L4>[]);\n    return lka as LocKeyArray<S, L1, L2, L3, L4>;\n  }\n\n  public getLocations(res: Response): LocKeyArray<L1, L2, L3, L4, L5> {\n    return this.parentRoute.getLKA(res) as LocKeyArray<L1, L2, L3, L4, L5>;\n  }\n\n  protected 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    try {\n      const itemToCreate = this.convertDates(req.body as Item<S, L1, L2, L3, L4, L5>);\n      let item = validatePK(await libOperations.create(\n        itemToCreate, { locations: this.getLocations(res) }), this.getPkType()) as Item<S, L1, L2, L3, L4, L5>;\n      item = await this.postCreateItem(item);\n      this.logger.default('Created Item %j', item);\n      res.json(item);\n    } catch (err: any) {\n      if (err instanceof NotFoundError) {\n        this.logger.error('Item Not Found for Create', { message: err?.message, stack: err?.stack });\n        res.status(404).json({\n          message: \"Item Not Found\",\n        });\n      } else {\n        this.logger.error('General Error in Create', { message: err?.message, stack: err?.stack });\n        res.status(500).json({\n          message: \"General Error\",\n        });\n      }\n    }\n  };\n\n  protected findItems = async (req: Request, res: Response) => {\n    const libOperations = this.lib.operations;\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    let items: Item<S, L1, L2, L3, L4, L5>[] = [];\n\n    if (finder) {\n      // If finder is defined?  Call a finder.\n      this.logger.default('Finding Items with Finder', { finder, finderParams, one });\n\n      if (one === 'true') {\n        const item = await (this.lib as any).findOne(finder, JSON.parse(finderParams), this.getLocations(res));\n        items = item ? [item] : [];\n      } else {\n        items = await libOperations.find(finder, JSON.parse(finderParams), this.getLocations(res));\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 Query: %j', itemQuery);\n      items = await libOperations.all(itemQuery, this.getLocations(res));\n      this.logger.default('Found %d Items with Query', items.length);\n    }\n\n    res.json(items.map((item: Item<S, L1, L2, L3, L4, L5>) => validatePK(item, this.getPkType())));\n  };\n\n}\n"],
+  "mappings": "AAAA;AAAA,EACgD;AAAA,EAAoC;AAAA,OAC7E;AACP,SAAS,qBAAqB;AAE9B,SAAS,kBAAqC;AAOvC,MAAM,oBAQH,WAAkC;AAAA,EAElC;AAAA,EAER,YACE,KACA,MACA,aACA,UAAoD,CAAC,GACrD;AACA,UAAM,KAAY,MAAM,OAAO;AAC/B,SAAK,cAAc;AAAA,EACrB;AAAA,EAEO,YAAqB;AAC1B,WAAO,CAAC,CAAC,KAAK;AAAA,EAChB;AAAA,EAEO,MAAM,KAA8C;AACzD,UAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,UAAM,MAAM,KAAK,aAAa,GAAG;AACjC,WAAO,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI;AAAA,EACvC;AAAA,EAEO,OAAO,KAA+C;AAM3D,QAAI,MAAuC,CAAC,KAAK,MAAM,GAAG,CAAC;AAC3D,UAAM,IAAI,OAAO,KAAK,YAAY,OAAO,GAAG,CAAoC;AAChF,WAAO;AAAA,EACT;AAAA,EAEO,aAAa,KAAgD;AAClE,WAAO,KAAK,YAAY,OAAO,GAAG;AAAA,EACpC;AAAA,EAEU,aAAa,OAAO,KAAc,QAAkB;AAC5D,UAAM,gBAAgB,KAAK,IAAI;AAC/B,SAAK,OAAO,QAAQ,iBAAiB,EAAE,MAAM,KAAK,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,QAAQ,QAAQ,KAAK,OAAO,CAAC;AACrH,QAAI;AACF,YAAM,eAAe,KAAK,aAAa,IAAI,IAAmC;AAC9E,UAAI,OAAO,WAAW,MAAM,cAAc;AAAA,QACxC;AAAA,QAAc,EAAE,WAAW,KAAK,aAAa,GAAG,EAAE;AAAA,MAAC,GAAG,KAAK,UAAU,CAAC;AACxE,aAAO,MAAM,KAAK,eAAe,IAAI;AACrC,WAAK,OAAO,QAAQ,mBAAmB,IAAI;AAC3C,UAAI,KAAK,IAAI;AAAA,IACf,SAAS,KAAU;AACjB,UAAI,eAAe,eAAe;AAChC,aAAK,OAAO,MAAM,6BAA6B,EAAE,SAAS,KAAK,SAAS,OAAO,KAAK,MAAM,CAAC;AAC3F,YAAI,OAAO,GAAG,EAAE,KAAK;AAAA,UACnB,SAAS;AAAA,QACX,CAAC;AAAA,MACH,OAAO;AACL,aAAK,OAAO,MAAM,2BAA2B,EAAE,SAAS,KAAK,SAAS,OAAO,KAAK,MAAM,CAAC;AACzF,YAAI,OAAO,GAAG,EAAE,KAAK;AAAA,UACnB,SAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEU,YAAY,OAAO,KAAc,QAAkB;AAC3D,UAAM,gBAAgB,KAAK,IAAI;AAC/B,UAAM,QAAqB,IAAI;AAC/B,UAAM,SAAS,MAAM,QAAQ;AAC7B,UAAM,eAAe,MAAM,cAAc;AACzC,UAAM,MAAM,MAAM,KAAK;AAEvB,QAAI,QAAuC,CAAC;AAE5C,QAAI,QAAQ;AAEV,WAAK,OAAO,QAAQ,6BAA6B,EAAE,QAAQ,cAAc,IAAI,CAAC;AAE9E,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAO,KAAK,IAAY,QAAQ,QAAQ,KAAK,MAAM,YAAY,GAAG,KAAK,aAAa,GAAG,CAAC;AACrG,gBAAQ,OAAO,CAAC,IAAI,IAAI,CAAC;AAAA,MAC3B,OAAO;AACL,gBAAQ,MAAM,cAAc,KAAK,QAAQ,KAAK,MAAM,YAAY,GAAG,KAAK,aAAa,GAAG,CAAC;AAAA,MAC3F;AAAA,IACF,OAAO;AAEL,YAAM,YAAuB,cAAc,IAAI,KAAoB;AACnE,WAAK,OAAO,QAAQ,gCAAgC,SAAS;AAC7D,cAAQ,MAAM,cAAc,IAAI,WAAW,KAAK,aAAa,GAAG,CAAC;AACjE,WAAK,OAAO,QAAQ,6BAA6B,MAAM,MAAM;AAAA,IAC/D;AAEA,QAAI,KAAK,MAAM,IAAI,CAAC,SAAsC,WAAW,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;AAAA,EAC/F;AAEF;",
   "names": []
 }

package/dist/Instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Instance.d.ts","sourceRoot":"","sources":["../src/Instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,UAAU,EAAwC,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ,CACvB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,CACzB,SAAQ,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC3C,yEAAyE;IACzE,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,sFAAsF;IACtF,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,GACzB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,UAAU,QAAQ,EAClB,YAAY,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAC7C,QAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KAC1C,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAInC,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,UAAU,GAAG,KAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAQhG,CAAA"}
+{"version":3,"file":"Instance.d.ts","sourceRoot":"","sources":["../src/Instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,UAAU,EAAwC,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ,CACvB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,CACzB,SAAQ,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC3C,yEAAyE;IACzE,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,sFAAsF;IACtF,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,GACzB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEvB,UAAU,QAAQ,EAClB,YAAY,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAC7C,QAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KAC1C,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAIrC,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,UAAU,GAAG,KAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAQhG,CAAA"}

package/dist/Instance.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Instance.ts"],
-  "sourcesContent": ["import LibLogger from \"./logger.js\";\nimport { Item } from \"@fjell/core\";\nimport { Instance as BaseInstance, Coordinate, createInstance as createBaseInstance, Registry } from \"@fjell/registry\";\nimport { Operations, Options } from \"@fjell/lib\";\nimport { ItemRouter } from \"./ItemRouter.js\";\n\nconst logger = LibLogger.get(\"Instance\");\n\n/**\n * The Express Router Instance interface represents a router model instance that extends the base Instance\n * from @fjell/registry and adds express router operations for handling HTTP requests.\n *\n * The interface extends the base Instance (which provides coordinate and registry) with:\n * - router: Provides methods for routing HTTP requests and handling CRUD operations\n * - operations: Provides methods for interacting with the data model (get, find, all, etc.)\n * - options: Provides hooks, validators, finders, actions, and facets\n *\n * @template V - The type of the data model item, extending Item\n * @template S - The string literal type representing the model's key type\n * @template L1-L5 - Optional string literal types for location hierarchy levels\n */\nexport interface Instance<\n  V extends Item<S, L1, L2, L3, L4, L5>,\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> extends BaseInstance<S, L1, L2, L3, L4, L5> {\n  /** The router object that provides methods for handling HTTP requests */\n  router: ItemRouter<S, L1, L2, L3, L4, L5>;\n  /** The operations object that provides methods for interacting with the data model */\n  operations: Operations<V, S, L1, L2, L3, L4, L5>;\n  /** The options object that provides hooks, validators, finders, actions, and facets */\n  options: Options<V, S, L1, L2, L3, L4, L5>;\n  /** The data model item type (for type safety) */\n  readonly itemType?: V;\n}\n\nexport const createInstance = <\n  V extends Item<S, L1, L2, L3, L4, L5>,\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  registry: Registry,\n  coordinate: Coordinate<S, L1, L2, L3, L4, L5>,\n  router: ItemRouter<S, L1, L2, L3, L4, L5>,\n  operations: Operations<V, S, L1, L2, L3, L4, L5>,\n  options?: Options<V, S, L1, L2, L3, L4, L5>,\n): Instance<V, S, L1, L2, L3, L4, L5> => {\n  logger.debug(\"createInstance\", { coordinate, router, registry, operations, options });\n  const baseInstance = createBaseInstance(registry, coordinate);\n  return { ...baseInstance, router, operations, options: options || {} as Options<V, S, L1, L2, L3, L4, L5> };\n}\n\nexport const isInstance = (instance: any): instance is Instance<any, any, any, any, any, any, any> => {\n  return instance != null &&\n    typeof instance === 'object' &&\n    instance.coordinate != null &&\n    instance.router != null &&\n    instance.registry != null &&\n    instance.operations != null &&\n    instance.options != null;\n}\n"],
-  "mappings": "AAAA,OAAO,eAAe;AAEtB,SAA+C,kBAAkB,0BAAoC;AAIrG,MAAM,SAAS,UAAU,IAAI,UAAU;AAkChC,MAAM,iBAAiB,CAS5B,UACA,YACA,QACA,YACA,YACuC;AACvC,SAAO,MAAM,kBAAkB,EAAE,YAAY,QAAQ,UAAU,YAAY,QAAQ,CAAC;AACpF,QAAM,eAAe,mBAAmB,UAAU,UAAU;AAC5D,SAAO,EAAE,GAAG,cAAc,QAAQ,YAAY,SAAS,WAAW,CAAC,EAAuC;AAC5G;AAEO,MAAM,aAAa,CAAC,aAA2E;AACpG,SAAO,YAAY,QACjB,OAAO,aAAa,YACpB,SAAS,cAAc,QACvB,SAAS,UAAU,QACnB,SAAS,YAAY,QACrB,SAAS,cAAc,QACvB,SAAS,WAAW;AACxB;",
+  "sourcesContent": ["import LibLogger from \"./logger.js\";\nimport { Item } from \"@fjell/core\";\nimport { Instance as BaseInstance, Coordinate, createInstance as createBaseInstance, Registry } from \"@fjell/registry\";\nimport { Operations, Options } from \"@fjell/lib\";\nimport { ItemRouter } from \"./ItemRouter.js\";\n\nconst logger = LibLogger.get(\"Instance\");\n\n/**\n * The Express Router Instance interface represents a router model instance that extends the base Instance\n * from @fjell/registry and adds express router operations for handling HTTP requests.\n *\n * The interface extends the base Instance (which provides coordinate and registry) with:\n * - router: Provides methods for routing HTTP requests and handling CRUD operations\n * - operations: Provides methods for interacting with the data model (get, find, all, etc.)\n * - options: Provides hooks, validators, finders, actions, and facets\n *\n * @template V - The type of the data model item, extending Item\n * @template S - The string literal type representing the model's key type\n * @template L1-L5 - Optional string literal types for location hierarchy levels\n */\nexport interface Instance<\n  V extends Item<S, L1, L2, L3, L4, L5>,\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> extends BaseInstance<S, L1, L2, L3, L4, L5> {\n  /** The router object that provides methods for handling HTTP requests */\n  router: ItemRouter<S, L1, L2, L3, L4, L5>;\n  /** The operations object that provides methods for interacting with the data model */\n  operations: Operations<V, S, L1, L2, L3, L4, L5>;\n  /** The options object that provides hooks, validators, finders, actions, and facets */\n  options: Options<V, S, L1, L2, L3, L4, L5>;\n  /** The data model item type (for type safety) */\n  readonly itemType?: V;\n}\n\nexport const createInstance = <\n  V extends Item<S, L1, L2, L3, L4, L5>,\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    registry: Registry,\n    coordinate: Coordinate<S, L1, L2, L3, L4, L5>,\n    router: ItemRouter<S, L1, L2, L3, L4, L5>,\n    operations: Operations<V, S, L1, L2, L3, L4, L5>,\n    options?: Options<V, S, L1, L2, L3, L4, L5>,\n  ): Instance<V, S, L1, L2, L3, L4, L5> => {\n  logger.debug(\"createInstance\", { coordinate, router, registry, operations, options });\n  const baseInstance = createBaseInstance(registry, coordinate);\n  return { ...baseInstance, router, operations, options: options || {} as Options<V, S, L1, L2, L3, L4, L5> };\n}\n\nexport const isInstance = (instance: any): instance is Instance<any, any, any, any, any, any, any> => {\n  return instance != null &&\n    typeof instance === 'object' &&\n    instance.coordinate != null &&\n    instance.router != null &&\n    instance.registry != null &&\n    instance.operations != null &&\n    instance.options != null;\n}\n"],
+  "mappings": "AAAA,OAAO,eAAe;AAEtB,SAA+C,kBAAkB,0BAAoC;AAIrG,MAAM,SAAS,UAAU,IAAI,UAAU;AAkChC,MAAM,iBAAiB,CAS1B,UACA,YACA,QACA,YACA,YACuC;AACzC,SAAO,MAAM,kBAAkB,EAAE,YAAY,QAAQ,UAAU,YAAY,QAAQ,CAAC;AACpF,QAAM,eAAe,mBAAmB,UAAU,UAAU;AAC5D,SAAO,EAAE,GAAG,cAAc,QAAQ,YAAY,SAAS,WAAW,CAAC,EAAuC;AAC5G;AAEO,MAAM,aAAa,CAAC,aAA2E;AACpG,SAAO,YAAY,QACjB,OAAO,aAAa,YACpB,SAAS,cAAc,QACvB,SAAS,UAAU,QACnB,SAAS,YAAY,QACrB,SAAS,cAAc,QACvB,SAAS,WAAW;AACxB;",
   "names": []
 }

package/dist/InstanceFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InstanceFactory.d.ts","sourceRoot":"","sources":["../src/InstanceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAyB,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAOjD,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,IACvB,CACF,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KACxC,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEzB,QAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KAC1C,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAM3C,CAAC"}
+{"version":3,"file":"InstanceFactory.d.ts","sourceRoot":"","sources":["../src/InstanceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAyB,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAOjD,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,IACvB,CACF,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KACxC,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACrC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EACzB,EAAE,SAAS,MAAM,GAAG,KAAK,EAEvB,QAAQ,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACzC,YAAY,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAChD,UAAU,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,KAC1C,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAM7C,CAAC"}

package/dist/InstanceFactory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/InstanceFactory.ts"],
-  "sourcesContent": ["import { Item } from \"@fjell/core\";\nimport { ItemRouter } from \"./ItemRouter.js\";\nimport { InstanceFactory as BaseInstanceFactory, Registry, RegistryHub } from \"@fjell/registry\";\nimport { Operations, Options } from \"@fjell/lib\";\nimport { createInstance, Instance } from \"./Instance.js\";\nimport { Coordinate } from \"@fjell/registry\";\nimport LibLogger from \"./logger.js\";\n\nconst logger = LibLogger.get(\"InstanceFactory\");\n\nexport type InstanceFactory<\n  V extends Item<S, L1, L2, L3, L4, L5>,\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  router: ItemRouter<S, L1, L2, L3, L4, L5>,\n  operations: Operations<V, S, L1, L2, L3, L4, L5>,\n  options?: Options<V, S, L1, L2, L3, L4, L5>\n) => BaseInstanceFactory<S, L1, L2, L3, L4, L5> & { readonly _itemType?: V };\n\n/**\n * Factory function for creating express-router instances\n */\nexport const createInstanceFactory = <\n  V extends Item<S, L1, L2, L3, L4, L5>,\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  router: ItemRouter<S, L1, L2, L3, L4, L5>,\n  operations: Operations<V, S, L1, L2, L3, L4, L5>,\n  options?: Options<V, S, L1, L2, L3, L4, L5>\n): BaseInstanceFactory<S, L1, L2, L3, L4, L5> => {\n  return (coordinate: Coordinate<S, L1, L2, L3, L4, L5>, context: { registry: Registry, registryHub?: RegistryHub }) => {\n    logger.debug(\"Creating express-router instance\", { coordinate, registry: context.registry, router, operations, options });\n\n    return createInstance(context.registry, coordinate, router, operations, options) as Instance<V, S, L1, L2, L3, L4, L5>;\n  };\n};\n"],
-  "mappings": "AAIA,SAAS,sBAAgC;AAEzC,OAAO,eAAe;AAEtB,MAAM,SAAS,UAAU,IAAI,iBAAiB;AAmBvC,MAAM,wBAAwB,CASnC,QACA,YACA,YAC+C;AAC/C,SAAO,CAAC,YAA+C,YAA+D;AACpH,WAAO,MAAM,oCAAoC,EAAE,YAAY,UAAU,QAAQ,UAAU,QAAQ,YAAY,QAAQ,CAAC;AAExH,WAAO,eAAe,QAAQ,UAAU,YAAY,QAAQ,YAAY,OAAO;AAAA,EACjF;AACF;",
+  "sourcesContent": ["import { Item } from \"@fjell/core\";\nimport { ItemRouter } from \"./ItemRouter.js\";\nimport { InstanceFactory as BaseInstanceFactory, Registry, RegistryHub } from \"@fjell/registry\";\nimport { Operations, Options } from \"@fjell/lib\";\nimport { createInstance, Instance } from \"./Instance.js\";\nimport { Coordinate } from \"@fjell/registry\";\nimport LibLogger from \"./logger.js\";\n\nconst logger = LibLogger.get(\"InstanceFactory\");\n\nexport type InstanceFactory<\n  V extends Item<S, L1, L2, L3, L4, L5>,\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  router: ItemRouter<S, L1, L2, L3, L4, L5>,\n  operations: Operations<V, S, L1, L2, L3, L4, L5>,\n  options?: Options<V, S, L1, L2, L3, L4, L5>\n) => BaseInstanceFactory<S, L1, L2, L3, L4, L5> & { readonly _itemType?: V };\n\n/**\n * Factory function for creating express-router instances\n */\nexport const createInstanceFactory = <\n  V extends Item<S, L1, L2, L3, L4, L5>,\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    router: ItemRouter<S, L1, L2, L3, L4, L5>,\n    operations: Operations<V, S, L1, L2, L3, L4, L5>,\n    options?: Options<V, S, L1, L2, L3, L4, L5>\n  ): BaseInstanceFactory<S, L1, L2, L3, L4, L5> => {\n  return (coordinate: Coordinate<S, L1, L2, L3, L4, L5>, context: { registry: Registry, registryHub?: RegistryHub }) => {\n    logger.debug(\"Creating express-router instance\", { coordinate, registry: context.registry, router, operations, options });\n\n    return createInstance(context.registry, coordinate, router, operations, options) as Instance<V, S, L1, L2, L3, L4, L5>;\n  };\n};\n"],
+  "mappings": "AAIA,SAAS,sBAAgC;AAEzC,OAAO,eAAe;AAEtB,MAAM,SAAS,UAAU,IAAI,iBAAiB;AAmBvC,MAAM,wBAAwB,CASjC,QACA,YACA,YAC+C;AACjD,SAAO,CAAC,YAA+C,YAA+D;AACpH,WAAO,MAAM,oCAAoC,EAAE,YAAY,UAAU,QAAQ,UAAU,QAAQ,YAAY,QAAQ,CAAC;AAExH,WAAO,eAAe,QAAQ,UAAU,YAAY,QAAQ,YAAY,OAAO;AAAA,EACjF;AACF;",
   "names": []
 }

package/dist/ItemRouter.d.ts

@@ -1,14 +1,23 @@
 import { ComKey, Item, LocKey, LocKeyArray, PriKey } from "@fjell/core";
 import { Instance } from "./Instance.js";
 import { Request, Response, Router } from "express";
-export type ItemRouterOptions = Record<string, never>;
+export type ItemRouterOptions<S extends string = string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never> = {
+    /** Handlers for item actions */
+    actions?: Record<string, (req: Request, res: Response, ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>) => Promise<void>>;
+    /** Handlers for item facets */
+    facets?: Record<string, (req: Request, res: Response, ik: PriKey<S> | ComKey<S, L1, L2, L3, L4, L5>) => Promise<void>>;
+    /** Handlers for all actions */
+    allActions?: Record<string, (req: Request, res: Response) => Promise<void>>;
+    /** Handlers for all facets */
+    allFacets?: Record<string, (req: Request, res: Response) => Promise<void>>;
+};
 export declare class ItemRouter<S extends string, L1 extends string = never, L2 extends string = never, L3 extends string = never, L4 extends string = never, L5 extends string = never> {
     protected lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>;
     private keyType;
-    protected options: ItemRouterOptions;
+    protected options: ItemRouterOptions<S, L1, L2, L3, L4, L5>;
     private childRouters;
     protected logger: import("@fjell/logging").Logger;
-    constructor(lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>, keyType: S, options?: ItemRouterOptions);
+    constructor(lib: Instance<Item<S, L1, L2, L3, L4, L5>, S, L1, L2, L3, L4, L5>, keyType: S, options?: ItemRouterOptions<S, L1, L2, L3, L4, L5>);
     getPkType: () => S;
     protected getPkParam: () => string;
     protected getLk(res: Response): LocKey<S>;

package/dist/ItemRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ItemRouter.d.ts","sourceRoot":"","sources":["../src/ItemRouter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ItemRouter.d.ts","sourceRoot":"","sources":["../src/ItemRouter.ts"],"names":[],"mappings":"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"}

package/dist/ItemRouter.js

@@ -49,15 +49,26 @@ 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 {
+        await this.options.allActions[allActionKey](req, res);
+        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 +83,26 @@ 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 {
+        await this.options.allFacets[facetKey](req, res);
+        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 +116,20 @@ 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 {
+        await this.options.actions[actionKey](req, res, ik);
+        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 +151,20 @@ 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 {
+        await this.options.facets[facetKey](req, res, ik);
+        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 +269,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 +325,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;