@fjell/express-router 4.4.8 → 4.4.10

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/logger.ts","../src/ItemRouter.ts","../src/CItemRouter.ts","../src/PItemRouter.ts"],"sourcesContent":["import Logging from '@fjell/logging';\n\nconst LibLogger = Logging.getLogger('@fjell/express-router');\n\nexport default LibLogger;\n","import {\n  ComKey,\n  cPK,\n  Item,\n  ItemEvent,\n  LocKey,\n  LocKeyArray,\n  PriKey,\n  validatePK\n} from \"@fjell/core\";\nimport { Instance, NotFoundError } from \"@fjell/lib\";\nimport deepmerge from \"deepmerge\";\nimport { Request, Response, Router } from \"express\";\nimport LibLogger from \"./logger\";\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.definition.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.definition.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.definition.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.definition.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.definition.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","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\";\nimport { Contained } from \"@fjell/lib\";\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: Contained.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","import { Item, ItemQuery, paramsToQuery, PriKey, QueryParams, validatePK } from \"@fjell/core\";\nimport { Primary } from \"@fjell/lib\";\nimport { ItemRouter, ItemRouterOptions } from \"@/ItemRouter\";\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: Primary.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"],"names":["LibLogger","Logging","getLogger","ItemRouter","getLk","res","kt","keyType","lk","locals","getPkParam","getLKA","getPk","cPK","getPkType","getLocations","Error","getIk","getRouter","router","Router","configure","lib","options","_define_property","childRouters","logger","postAllAction","req","libOptions","definition","libOperations","operations","debug","query","params","allActionKey","path","substring","lastIndexOf","allActions","error","status","json","allAction","body","err","message","stack","getAllFacet","facetKey","allFacets","facet","combinedQueryParams","allFacet","postItemAction","ik","actionKey","actions","action","getItemFacet","facets","pkType","get","findItems","post","createItem","default","Object","keys","forEach","itemRouter","getItem","put","updateItem","delete","deleteItem","itemActions","itemFacets","use","validatePrimaryKeyValue","configureChildRouters","next","pkParamValue","validatePKParam","originalUrl","addChildRouter","postCreateItem","item","removedItem","remove","validatePK","NotFoundError","itemToUpdate","convertDates","retItem","update","events","key","assign","deepmerge","at","Date","validPkParam","length","CItemRouter","hasParent","parentRoute","pri","loc","pk","lka","concat","type","itemToCreate","create","locations","finder","finderParams","one","items","findOne","JSON","parse","find","itemQuery","paramsToQuery","all","map","PItemRouter"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/logger.ts","../src/ItemRouter.ts","../src/CItemRouter.ts","../src/PItemRouter.ts","../src/Instance.ts","../src/InstanceFactory.ts","../src/Registry.ts"],"sourcesContent":["import Logging from '@fjell/logging';\n\nconst LibLogger = Logging.getLogger('@fjell/express-router');\n\nexport default LibLogger;\n","import {\n  ComKey,\n  cPK,\n  Item,\n  ItemEvent,\n  LocKey,\n  LocKeyArray,\n  PriKey,\n  validatePK\n} from \"@fjell/core\";\nimport { Instance, NotFoundError } from \"@fjell/lib\";\nimport deepmerge from \"deepmerge\";\nimport { Request, Response, Router } from \"express\";\nimport LibLogger from \"./logger\";\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","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\";\nimport { Instance } from \"@fjell/lib\";\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","import { Item, ItemQuery, paramsToQuery, PriKey, QueryParams, validatePK } from \"@fjell/core\";\nimport { Instance } from \"@fjell/lib\";\nimport { ItemRouter, ItemRouterOptions } from \"@/ItemRouter\";\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","import LibLogger from \"./logger\";\nimport { Item } from \"@fjell/core\";\nimport { Instance as BaseInstance, Coordinate, createInstance as createBaseInstance, Registry } from \"@fjell/registry\";\nimport { ItemRouter } from \"./ItemRouter\";\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 *\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 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  ): Instance<V, S, L1, L2, L3, L4, L5> => {\n  logger.debug(\"createInstance\", { coordinate, router, registry });\n  const baseInstance = createBaseInstance(registry, coordinate);\n  return { ...baseInstance, router };\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}\n","import { Item } from \"@fjell/core\";\nimport { ItemRouter } from \"./ItemRouter\";\nimport { InstanceFactory as BaseInstanceFactory, Registry, RegistryHub } from \"@fjell/registry\";\nimport { createInstance, Instance } from \"./Instance\";\nimport { Coordinate } from \"@fjell/registry\";\nimport LibLogger from \"./logger\";\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) => 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  ): 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 });\n\n    return createInstance(context.registry, coordinate, router) as Instance<V, S, L1, L2, L3, L4, L5>;\n  };\n};\n","import LibLogger from './logger';\nimport {\n  Registry as BaseRegistry,\n  createRegistry as createBaseRegistry,\n  RegistryFactory,\n  RegistryHub\n} from '@fjell/registry';\n\nconst logger = LibLogger.get(\"Registry\");\n\n/**\n * Extended Registry interface for express-router-specific functionality\n */\nexport interface Registry extends BaseRegistry {\n  type: 'express-router';\n}\n\n/**\n * Factory function for creating express-router registries\n */\nexport const createRegistryFactory = (): RegistryFactory => {\n  return (type: string, registryHub?: RegistryHub): BaseRegistry => {\n    if (type !== 'express-router') {\n      throw new Error(`Express Router registry factory can only create 'express-router' type registries, got: ${type}`);\n    }\n\n    logger.debug(\"Creating express-router registry\", { type, registryHub });\n\n    const baseRegistry = createBaseRegistry(type, registryHub);\n\n    // Cast to Registry for type safety\n    return baseRegistry as Registry;\n  };\n};\n\n/**\n * Creates a new express-router registry instance\n */\nexport const createRegistry = (registryHub?: RegistryHub): Registry => {\n  const baseRegistry = createBaseRegistry('express-router', registryHub);\n\n  return {\n    ...baseRegistry,\n  } as Registry;\n};\n"],"names":["LibLogger","Logging","getLogger","ItemRouter","getLk","res","kt","keyType","lk","locals","getPkParam","getLKA","getPk","cPK","getPkType","getLocations","Error","getIk","getRouter","router","Router","configure","lib","options","_define_property","childRouters","logger","postAllAction","req","libOptions","libOperations","operations","debug","query","params","allActionKey","path","substring","lastIndexOf","allActions","error","status","json","allAction","body","err","message","stack","getAllFacet","facetKey","allFacets","facet","combinedQueryParams","allFacet","postItemAction","ik","actionKey","actions","action","getItemFacet","facets","pkType","get","findItems","post","createItem","default","Object","keys","forEach","itemRouter","getItem","put","updateItem","delete","deleteItem","itemActions","itemFacets","use","validatePrimaryKeyValue","configureChildRouters","next","pkParamValue","validatePKParam","originalUrl","addChildRouter","postCreateItem","item","removedItem","remove","validatePK","NotFoundError","itemToUpdate","convertDates","retItem","update","events","key","assign","deepmerge","at","Date","validPkParam","length","CItemRouter","hasParent","parentRoute","pri","loc","pk","lka","concat","type","itemToCreate","create","locations","finder","finderParams","one","items","findOne","JSON","parse","find","itemQuery","paramsToQuery","all","map","PItemRouter","createInstance","registry","coordinate","baseInstance","createBaseInstance","isInstance","instance","createInstanceFactory","context","createRegistryFactory","registryHub","baseRegistry","createBaseRegistry","createRegistry"],"mappings":";;;;;;;;;;;AAEA,MAAMA,SAAAA,GAAYC,OAAAA,CAAQC,SAAS,CAAC,uBAAA,CAAA;;;;;;;;;;;;;;;ACe7B,MAAMC,UAAAA,CAAAA;AAkCDC,IAAAA,KAAAA,CAAMC,GAAa,EAAa;QACxC,OAAO;YAAEC,EAAAA,EAAI,IAAI,CAACC,OAAO;AAAEC,YAAAA,EAAAA,EAAIH,IAAII,MAAM,CAAC,IAAI,CAACC,UAAU,EAAA;AAAI,SAAA;AAC/D,IAAA;;AAGOC,IAAAA,MAAAA,CAAON,GAAa,EAAkC;QAC3D,OAAO;YAAC,IAAI,CAACD,KAAK,CAACC,GAAAA;AAAK,SAAA;AAC1B,IAAA;AAEOO,IAAAA,KAAAA,CAAMP,GAAa,EAAa;QACrC,OAAOQ,QAAAA,CAAOR,GAAAA,CAAII,MAAM,CAAC,IAAI,CAACC,UAAU,EAAA,CAAG,EAAE,IAAI,CAACI,SAAS,EAAA,CAAA;AAC7D,IAAA;;AAGA,yBACUC,YAAAA,CAAaV,GAAa,EAAwC;AAC1E,QAAA,MAAM,IAAIW,KAAAA,CAAM,8CAAA,CAAA;AAClB,IAAA;AACA;AAGUC,IAAAA,KAAAA,CAAMZ,GAAa,EAA6C;AACxE,QAAA,MAAM,IAAIW,KAAAA,CAAM,8CAAA,CAAA;AAClB,IAAA;+BAuLA,SAAOE,GAAoB;AACzB,QAAA,MAAMC,MAAAA,GAASC,cAAAA,EAAAA;QACf,IAAI,CAACC,SAAS,CAACF,MAAAA,CAAAA;QACf,OAAOA,MAAAA;AACT,IAAA;AArOA,IAAA,WAAA,CACEG,KAAiE,EACjEf,OAAU,EACVgB,OAAAA,GAA6B,EAAE,CAC/B;AAVF,QAAAC,kBAAA,CAAA,IAAA,EAAUF,OAAV,MAAA,CAAA;AACA,QAAAE,kBAAA,CAAA,IAAA,EAAQjB,WAAR,MAAA,CAAA;AACA,QAAAiB,kBAAA,CAAA,IAAA,EAAUD,WAAV,MAAA,CAAA;AACA,QAAAC,kBAAA,CAAA,IAAA,EAAQC,gBAAuC,EAAC,CAAA;AAChD,QAAAD,kBAAA,CAAA,IAAA,EAAUE,UAAV,MAAA,CAAA;AAaA,QAAAF,kBAAA,CAAA,IAAA,EAAOV,WAAAA,EAAY,IAAA;YACjB,OAAO,IAAI,CAACP,OAAO;AACrB,QAAA,CAAA,CAAA;AAEA,QAAAiB,kBAAA,CAAA,IAAA,EAAUd,YAAAA,EAAa,IAAA;AACrB,YAAA,OAAO,GAAG,IAAI,CAACI,SAAS,EAAA,CAAG,EAAE,CAAC;AAChC,QAAA,CAAA,CAAA;QA2BAU,kBAAA,CAAA,IAAA,EAAUG,eAAAA,EAAgB,OAAOC,GAAAA,EAAcvB,GAAAA,GAAAA;AAC7C,YAAA,MAAMwB,UAAAA,GAAa,IAAI,CAACP,GAAG,CAACC,OAAO;AACnC,YAAA,MAAMO,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,oBAAA,EAAsB;AAAEC,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;YACtG,MAAM0B,YAAAA,GAAeP,GAAAA,CAAIQ,IAAI,CAACC,SAAS,CAACT,GAAAA,CAAIQ,IAAI,CAACE,WAAW,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;YACpE,IAAI,CAACT,UAAAA,CAAWU,UAAU,EAAE;AAC1B,gBAAA,IAAI,CAACb,MAAM,CAACc,KAAK,CAAC,iCAAA,CAAA;AAClBnC,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAkC,iBAAA,CAAA;AAChE,gBAAA;AACF,YAAA;AACA,YAAA,MAAMG,SAAAA,GAAYd,UAAAA,CAAWU,UAAU,CAACJ,YAAAA,CAAa;AACrD,YAAA,IAAI,CAACQ,SAAAA,EAAW;AACd,gBAAA,IAAI,CAACjB,MAAM,CAACc,KAAK,CAAC,8BAAA,EAAgC;AAAEL,oBAAAA;AAAa,iBAAA,CAAA;AACjE9B,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAgC,iBAAA,CAAA;AAC9D,gBAAA;AACF,YAAA;YACA,IAAI;gBACFnC,GAAAA,CAAIqC,IAAI,CAAC,MAAMZ,aAAAA,CAAca,SAAS,CAACR,YAAAA,EAAcP,IAAIgB,IAAI,CAAA,CAAA;AAC/D,YAAA,CAAA,CAAE,OAAOC,GAAAA,EAAU;AACjB,gBAAA,IAAI,CAACnB,MAAM,CAACc,KAAK,CAAC,qBAAA,EAAuB;AAAEM,oBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,oBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,iBAAA,CAAA;AACpF1C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAACG,GAAAA,CAAAA;AACvB,YAAA;AACF,QAAA,CAAA,CAAA;QAEArB,kBAAA,CAAA,IAAA,EAAUwB,aAAAA,EAAc,OAAOpB,GAAAA,EAAcvB,GAAAA,GAAAA;AAC3C,YAAA,MAAMwB,UAAAA,GAAa,IAAI,CAACP,GAAG,CAACC,OAAO;AACnC,YAAA,MAAMO,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,mBAAA,EAAqB;AAAEC,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;YACrG,MAAMwC,QAAAA,GAAWrB,GAAAA,CAAIQ,IAAI,CAACC,SAAS,CAACT,GAAAA,CAAIQ,IAAI,CAACE,WAAW,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;YAChE,IAAI,CAACT,UAAAA,CAAWqB,SAAS,EAAE;AACzB,gBAAA,IAAI,CAACxB,MAAM,CAACc,KAAK,CAAC,gCAAA,CAAA;AAClBnC,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAiC,iBAAA,CAAA;AAC/D,gBAAA;AACF,YAAA;AACA,YAAA,MAAMW,KAAAA,GAAQtB,UAAAA,CAAWqB,SAAS,CAACD,QAAAA,CAAS;AAC5C,YAAA,IAAI,CAACE,KAAAA,EAAO;AACV,gBAAA,IAAI,CAACzB,MAAM,CAACc,KAAK,CAAC,8BAAA,EAAgC;AAAES,oBAAAA;AAAS,iBAAA,CAAA;AAC7D5C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAA+B,iBAAA,CAAA;AAC7D,gBAAA;AACF,YAAA;YACA,IAAI;AACF,gBAAA,MAAMY,mBAAAA,GAAsB;AAAE,oBAAA,GAAGxB,IAAIK,KAAK;AAAE,oBAAA,GAAGL,IAAIM;AAAO,iBAAA;AAC1D7B,gBAAAA,GAAAA,CAAIqC,IAAI,CAAC,MAAMZ,aAAAA,CAAcuB,QAAQ,CAACJ,QAAAA,EAAUG,mBAAAA,CAAAA,CAAAA;AAClD,YAAA,CAAA,CAAE,OAAOP,GAAAA,EAAU;AACjB,gBAAA,IAAI,CAACnB,MAAM,CAACc,KAAK,CAAC,oBAAA,EAAsB;AAAEM,oBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,oBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,iBAAA,CAAA;AACnF1C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAACG,GAAAA,CAAAA;AACvB,YAAA;AACF,QAAA,CAAA,CAAA;QAEArB,kBAAA,CAAA,IAAA,EAAU8B,gBAAAA,EAAiB,OAAO1B,GAAAA,EAAcvB,GAAAA,GAAAA;AAC9C,YAAA,MAAMwB,UAAAA,GAAa,IAAI,CAACP,GAAG,CAACC,OAAO;AACnC,YAAA,MAAMO,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,cAAA,EAAgB;AAAEC,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;AAChG,YAAA,MAAM8C,EAAAA,GAAK,IAAI,CAACtC,KAAK,CAACZ,GAAAA,CAAAA;YACtB,MAAMmD,SAAAA,GAAY5B,GAAAA,CAAIQ,IAAI,CAACC,SAAS,CAACT,GAAAA,CAAIQ,IAAI,CAACE,WAAW,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;YACjE,IAAI,CAACT,UAAAA,CAAW4B,OAAO,EAAE;AACvB,gBAAA,IAAI,CAAC/B,MAAM,CAACc,KAAK,CAAC,iCAAA,CAAA;AAClBnC,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAkC,iBAAA,CAAA;AAChE,gBAAA;AACF,YAAA;AACA,YAAA,MAAMkB,MAAAA,GAAS7B,UAAAA,CAAW4B,OAAO,CAACD,SAAAA,CAAU;AAC5C,YAAA,IAAI,CAACE,MAAAA,EAAQ;AACX,gBAAA,IAAI,CAAChC,MAAM,CAACc,KAAK,CAAC,+BAAA,EAAiC;AAAEgB,oBAAAA;AAAU,iBAAA,CAAA;AAC/DnD,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAgC,iBAAA,CAAA;AAC9D,gBAAA;AACF,YAAA;YACA,IAAI;gBACFnC,GAAAA,CAAIqC,IAAI,CAAC,MAAMZ,aAAAA,CAAc4B,MAAM,CAACH,EAAAA,EAAIC,SAAAA,EAAW5B,GAAAA,CAAIgB,IAAI,CAAA,CAAA;AAC7D,YAAA,CAAA,CAAE,OAAOC,GAAAA,EAAU;AACjB,gBAAA,IAAI,CAACnB,MAAM,CAACc,KAAK,CAAC,sBAAA,EAAwB;AAAEM,oBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,oBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,iBAAA,CAAA;AACrF1C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAACG,GAAAA,CAAAA;AACvB,YAAA;AACF,QAAA,CAAA,CAAA;QAEArB,kBAAA,CAAA,IAAA,EAAUmC,cAAAA,EAAe,OAAO/B,GAAAA,EAAcvB,GAAAA,GAAAA;AAC5C,YAAA,MAAMwB,UAAAA,GAAa,IAAI,CAACP,GAAG,CAACC,OAAO;AACnC,YAAA,MAAMO,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,cAAA,EAAgB;AAAEC,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;AAChG,YAAA,MAAM8C,EAAAA,GAAK,IAAI,CAACtC,KAAK,CAACZ,GAAAA,CAAAA;YACtB,MAAM4C,QAAAA,GAAWrB,GAAAA,CAAIQ,IAAI,CAACC,SAAS,CAACT,GAAAA,CAAIQ,IAAI,CAACE,WAAW,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;YAChE,IAAI,CAACT,UAAAA,CAAW+B,MAAM,EAAE;AACtB,gBAAA,IAAI,CAAClC,MAAM,CAACc,KAAK,CAAC,gCAAA,CAAA;AAClBnC,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAAiC,iBAAA,CAAA;AAC/D,gBAAA;AACF,YAAA;AACA,YAAA,MAAMW,KAAAA,GAAQtB,UAAAA,CAAW+B,MAAM,CAACX,QAAAA,CAAS;AACzC,YAAA,IAAI,CAACE,KAAAA,EAAO;AACV,gBAAA,IAAI,CAACzB,MAAM,CAACc,KAAK,CAAC,8BAAA,EAAgC;AAAES,oBAAAA;AAAS,iBAAA,CAAA;AAC7D5C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO;AAA+B,iBAAA,CAAA;AAC7D,gBAAA;AACF,YAAA;YACA,IAAI;AACF,gBAAA,MAAMY,mBAAAA,GAAsB;AAAE,oBAAA,GAAGxB,IAAIK,KAAK;AAAE,oBAAA,GAAGL,IAAIM;AAAO,iBAAA;AAC1D7B,gBAAAA,GAAAA,CAAIqC,IAAI,CAAC,MAAMZ,cAAcqB,KAAK,CAACI,IAAIN,QAAAA,EAAUG,mBAAAA,CAAAA,CAAAA;AACnD,YAAA,CAAA,CAAE,OAAOP,GAAAA,EAAU;AACjB,gBAAA,IAAI,CAACnB,MAAM,CAACc,KAAK,CAAC,qBAAA,EAAuB;AAAEM,oBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,oBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,iBAAA,CAAA;AACpF1C,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAACG,GAAAA,CAAAA;AACvB,YAAA;AACF,QAAA,CAAA,CAAA;AAEA,QAAArB,kBAAA,CAAA,IAAA,EAAQH,aAAY,CAACF,MAAAA,GAAAA;AACnB,YAAA,MAAMU,UAAAA,GAAa,IAAI,CAACP,GAAG,CAACC,OAAO;AACnC,YAAA,IAAI,CAACG,MAAM,CAACM,KAAK,CAAC,oBAAA,EAAsB;gBAAE6B,MAAAA,EAAQ,IAAI,CAAC/C,SAAS;AAAG,aAAA,CAAA;AACnEK,YAAAA,MAAAA,CAAO2C,GAAG,CAAC,GAAA,EAAK,IAAI,CAACC,SAAS,CAAA;AAC9B5C,YAAAA,MAAAA,CAAO6C,IAAI,CAAC,GAAA,EAAK,IAAI,CAACC,UAAU,CAAA;AAEhC,YAAA,IAAI,CAACvC,MAAM,CAACwC,OAAO,CAAC,gCAAA,EAAkC;AAAE3B,gBAAAA,UAAAA,EAAYV,WAAWU;AAAW,aAAA,CAAA;YAC1F,IAAIV,UAAAA,CAAWU,UAAU,EAAE;AACzB4B,gBAAAA,MAAAA,CAAOC,IAAI,CAACvC,UAAAA,CAAWU,UAAU,CAAA,CAAE8B,OAAO,CAAC,CAACb,SAAAA,GAAAA;AAC1C,oBAAA,IAAI,CAAC9B,MAAM,CAACM,KAAK,CAAC,2BAAA,EAA6BwB,SAAAA,CAAAA;;oBAE/CrC,MAAAA,CAAO6C,IAAI,CAAC,CAAC,CAAC,EAAER,SAAAA,CAAAA,CAAW,EAAE,IAAI,CAAC7B,aAAa,CAAA;AACjD,gBAAA,CAAA,CAAA;AACF,YAAA;AAEA,YAAA,IAAI,CAACD,MAAM,CAACwC,OAAO,CAAC,+BAAA,EAAiC;AAAEhB,gBAAAA,SAAAA,EAAWrB,WAAWqB;AAAU,aAAA,CAAA;YACvF,IAAIrB,UAAAA,CAAWqB,SAAS,EAAE;AACxBiB,gBAAAA,MAAAA,CAAOC,IAAI,CAACvC,UAAAA,CAAWqB,SAAS,CAAA,CAAEmB,OAAO,CAAC,CAACpB,QAAAA,GAAAA;AACzC,oBAAA,IAAI,CAACvB,MAAM,CAACM,KAAK,CAAC,0BAAA,EAA4BiB,QAAAA,CAAAA;;oBAE9C9B,MAAAA,CAAO2C,GAAG,CAAC,CAAC,CAAC,EAAEb,QAAAA,CAAAA,CAAU,EAAE,IAAI,CAACD,WAAW,CAAA;AAC7C,gBAAA,CAAA,CAAA;AACF,YAAA;AAEA,YAAA,MAAMsB,UAAAA,GAAalD,cAAAA,EAAAA;AACnBkD,YAAAA,UAAAA,CAAWR,GAAG,CAAC,GAAA,EAAK,IAAI,CAACS,OAAO,CAAA;AAChCD,YAAAA,UAAAA,CAAWE,GAAG,CAAC,GAAA,EAAK,IAAI,CAACC,UAAU,CAAA;AACnCH,YAAAA,UAAAA,CAAWI,MAAM,CAAC,GAAA,EAAK,IAAI,CAACC,UAAU,CAAA;AAEtC,YAAA,IAAI,CAACjD,MAAM,CAACwC,OAAO,CAAC,iCAAA,EAAmC;AAAEU,gBAAAA,WAAAA,EAAa/C,WAAW4B;AAAQ,aAAA,CAAA;YACzF,IAAI5B,UAAAA,CAAW4B,OAAO,EAAE;AACtBU,gBAAAA,MAAAA,CAAOC,IAAI,CAACvC,UAAAA,CAAW4B,OAAO,CAAA,CAAEY,OAAO,CAAC,CAACb,SAAAA,GAAAA;AACvC,oBAAA,IAAI,CAAC9B,MAAM,CAACM,KAAK,CAAC,4BAAA,EAA8BwB,SAAAA,CAAAA;;oBAEhDc,UAAAA,CAAWN,IAAI,CAAC,CAAC,CAAC,EAAER,SAAAA,CAAAA,CAAW,EAAE,IAAI,CAACF,cAAc,CAAA;AACtD,gBAAA,CAAA,CAAA;AACF,YAAA;AAEA,YAAA,IAAI,CAAC5B,MAAM,CAACwC,OAAO,CAAC,gCAAA,EAAkC;AAAEW,gBAAAA,UAAAA,EAAYhD,WAAW+B;AAAO,aAAA,CAAA;YACtF,IAAI/B,UAAAA,CAAW+B,MAAM,EAAE;AACrBO,gBAAAA,MAAAA,CAAOC,IAAI,CAACvC,UAAAA,CAAW+B,MAAM,CAAA,CAAES,OAAO,CAAC,CAACpB,QAAAA,GAAAA;AACtC,oBAAA,IAAI,CAACvB,MAAM,CAACM,KAAK,CAAC,2BAAA,EAA6BiB,QAAAA,CAAAA;;oBAE/CqB,UAAAA,CAAWR,GAAG,CAAC,CAAC,CAAC,EAAEb,QAAAA,CAAAA,CAAU,EAAE,IAAI,CAACU,YAAY,CAAA;AAClD,gBAAA,CAAA,CAAA;AACF,YAAA;YAEA,IAAI,CAACjC,MAAM,CAACM,KAAK,CAAC,+CAAA,EAAiD,IAAI,CAACtB,UAAU,EAAA,CAAA;AAClFS,YAAAA,MAAAA,CAAO2D,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,CAACpE,UAAU,EAAA,CAAA,CAAI,EAAE,IAAI,CAACqE,uBAAuB,EAAET,UAAAA,CAAAA;YAEnE,IAAI,IAAI,CAAC7C,YAAY,EAAE;AACrB,gBAAA,IAAI,CAACuD,qBAAqB,CAACV,UAAAA,EAAY,IAAI,CAAC7C,YAAY,CAAA;AAC1D,YAAA;YACA,OAAON,MAAAA;AACT,QAAA,CAAA,CAAA;QAEAK,kBAAA,CAAA,IAAA,EAAQuD,yBAAAA,EAA0B,CAACnD,GAAAA,EAAcvB,GAAAA,EAAe4E,IAAAA,GAAAA;AAC9D,YAAA,MAAMC,eAAetD,GAAAA,CAAIM,MAAM,CAAC,IAAI,CAACxB,UAAU,EAAA,CAAG;AAClD,YAAA,IAAI,IAAI,CAACyE,eAAe,CAACD,YAAAA,CAAAA,EAAe;AACtC7E,gBAAAA,GAAAA,CAAII,MAAM,CAAC,IAAI,CAACC,UAAU,GAAG,GAAGwE,YAAAA;AAChCD,gBAAAA,IAAAA,EAAAA;YACF,CAAA,MAAO;AACL,gBAAA,IAAI,CAACvD,MAAM,CAACc,KAAK,CAAC,qBAAA,EAAuB;AAAE0C,oBAAAA,YAAAA;AAAc9C,oBAAAA,IAAI,EAAER,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKwD;AAAY,iBAAA,CAAA;AAChF/E,gBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;oBAAEF,KAAAA,EAAO,qBAAA;AAAuBJ,oBAAAA,IAAI,EAAER,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKwD;AAAY,iBAAA,CAAA;AAC9E,YAAA;AACF,QAAA,CAAA,CAAA;QAEA5D,kBAAA,CAAA,IAAA,EAAQwD,uBAAAA,EAAwB,CAAC7D,MAAAA,EAAgBM,YAAAA,GAAAA;YAC/C,IAAK,MAAMW,QAAQX,YAAAA,CAAc;AAC/B,gBAAA,IAAI,CAACC,MAAM,CAACM,KAAK,CAAC,qCAAA,EAAuCI,IAAAA,CAAAA;gBAEzDjB,MAAAA,CAAO2D,GAAG,CAAC,CAAC,CAAC,EAAE1C,IAAAA,CAAAA,CAAM,EAAEX,YAAY,CAACW,IAAAA,CAAK,CAAA;AAC3C,YAAA;YACA,OAAOjB,MAAAA;AACT,QAAA,CAAA,CAAA;QAEAK,kBAAA,CAAA,IAAA,EAAO6D,gBAAAA,EAAiB,CAACjD,IAAAA,EAAcjB,MAAAA,GAAAA;AACrC,YAAA,IAAI,CAACM,YAAY,CAACW,IAAAA,CAAK,GAAGjB,MAAAA;AAC5B,QAAA,CAAA,CAAA;AASA;QAEAK,kBAAA,CAAA,IAAA,EAAUyC,YAAAA,EAAa,OAAOrC,GAAAA,EAAcvB,GAAAA,GAAAA;AAC1C,YAAA,MAAM,IAAIW,KAAAA,CAAM,8CAAA,CAAA;AAClB,QAAA,CAAA,CAAA;;mCAIAQ,kBAAA,CAAA,IAAA,EAAO8D,gBAAAA,EAAiB,OAAOC,IAAAA,GAAAA;AAC7B,YAAA,IAAI,CAAC7D,MAAM,CAACM,KAAK,CAAC,kBAAA,EAAoB;AAAEuD,gBAAAA;AAAK,aAAA,CAAA;YAC7C,OAAOA,IAAAA;AACT,QAAA,CAAA,CAAA;QAEA/D,kBAAA,CAAA,IAAA,EAAUmD,YAAAA,EAAa,OAAO/C,GAAAA,EAAcvB,GAAAA,GAAAA;AAC1C,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AAEzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,eAAA,EAAiB;AAAEC,gBAAAA,KAAAA,EAAOL,IAAIK,KAAK;AAAEC,gBAAAA,MAAAA,EAAQN,IAAIM,MAAM;AAAEzB,gBAAAA,MAAAA,EAAQJ,IAAII;AAAO,aAAA,CAAA;AAC9F,YAAA,MAAM8C,EAAAA,GAAK,IAAI,CAACtC,KAAK,CAACZ,GAAAA,CAAAA;AACtB,YAAA,MAAMmF,WAAAA,GAAc,MAAM1D,aAAAA,CAAc2D,MAAM,CAAClC,EAAAA,CAAAA;AAC/C,YAAA,MAAMgC,IAAAA,GAAOG,eAAAA,CAAWF,WAAAA,EAAa,IAAI,CAAC1E,SAAS,EAAA,CAAA;AACnDT,YAAAA,GAAAA,CAAIqC,IAAI,CAAC6C,IAAAA,CAAAA;AACX,QAAA,CAAA,CAAA;AAEA,wDAEA/D,kBAAA,CAAA,IAAA,EAAUuC,WAAAA,EAAY,OAAOnC,GAAAA,EAAcvB,GAAAA,GAAAA;AACzC,YAAA,MAAM,IAAIW,KAAAA,CAAM,8CAAA,CAAA;AAClB,QAAA,CAAA,CAAA;AACA,4BAEAQ,kBAAA,CAAA,IAAA,EAAU+C,SAAAA,EAAU,OAAO3C,GAAAA,EAAcvB,GAAAA,GAAAA;AACvC,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,cAAA,EAAgB;AAAEC,gBAAAA,KAAAA,EAAOL,IAAIK,KAAK;AAAEC,gBAAAA,MAAAA,EAAQN,IAAIM,MAAM;AAAEzB,gBAAAA,MAAAA,EAAQJ,IAAII;AAAO,aAAA,CAAA;AAC7F,YAAA,MAAM8C,EAAAA,GAAK,IAAI,CAACtC,KAAK,CAACZ,GAAAA,CAAAA;YACtB,IAAI;;gBAEF,MAAMkF,IAAAA,GAAOG,gBAAW,MAAM5D,aAAAA,CAAcgC,GAAG,CAACP,EAAAA,CAAAA,EAAK,IAAI,CAACzC,SAAS,EAAA,CAAA;AACnET,gBAAAA,GAAAA,CAAIqC,IAAI,CAAC6C,IAAAA,CAAAA;AACX,YAAA,CAAA,CAAE,OAAO1C,GAAAA,EAAU;AACjB,gBAAA,IAAIA,eAAe8C,iBAAAA,EAAe;AAChC,oBAAA,IAAI,CAACjE,MAAM,CAACc,KAAK,CAAC,gBAAA,EAAkB;AAAEe,wBAAAA,EAAAA;AAAIT,wBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,wBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,qBAAA,CAAA;AACnF1C,oBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;AACnBa,wBAAAA,EAAAA;wBACAT,OAAAA,EAAS;AACX,qBAAA,CAAA;gBACF,CAAA,MAAO;AACL,oBAAA,IAAI,CAACpB,MAAM,CAACc,KAAK,CAAC,eAAA,EAAiB;AAAEe,wBAAAA,EAAAA;AAAIT,wBAAAA,OAAO,EAAED,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKC,OAAO;AAAEC,wBAAAA,KAAK,EAAEF,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKE;AAAM,qBAAA,CAAA;AAClF1C,oBAAAA,GAAAA,CAAIoC,MAAM,CAAC,GAAA,CAAA,CAAKC,IAAI,CAAC;AACnBa,wBAAAA,EAAAA;wBACAT,OAAAA,EAAS;AACX,qBAAA,CAAA;AACF,gBAAA;AACF,YAAA;AACF,QAAA,CAAA,CAAA;QAEAtB,kBAAA,CAAA,IAAA,EAAUiD,YAAAA,EAAa,OAAO7C,GAAAA,EAAcvB,GAAAA,GAAAA;AAC1C,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACM,KAAK,CAAC,eAAA,EAChB;AAAEY,gBAAAA,IAAI,EAAEhB,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKgB,IAAI;AAAEX,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;AACjF,YAAA,MAAM8C,EAAAA,GAAK,IAAI,CAACtC,KAAK,CAACZ,GAAAA,CAAAA;AACtB,YAAA,MAAMuF,eAAe,IAAI,CAACC,YAAY,CAACjE,IAAIgB,IAAI,CAAA;YAC/C,MAAMkD,OAAAA,GAAUJ,eAAAA,CAAW,MAAM5D,aAAAA,CAAciE,MAAM,CAACxC,EAAAA,EAAIqC,YAAAA,CAAAA,EAAe,IAAI,CAAC9E,SAAS,EAAA,CAAA;AACvFT,YAAAA,GAAAA,CAAIqC,IAAI,CAACoD,OAAAA,CAAAA;AACX,QAAA,CAAA,CAAA;AAEA,QAAAtE,kBAAA,CAAA,IAAA,EAAOqE,gBAAe,CAACN,IAAAA,GAAAA;YACrB,MAAMS,MAAAA,GAAST,KAAKS,MAAM;AAC1B,YAAA,IAAI,CAACtE,MAAM,CAACM,KAAK,CAAC,kBAAA,EAAoB;AAAEuD,gBAAAA;AAAK,aAAA,CAAA;AAC7C,YAAA,IAAIS,MAAAA,EAAQ;AACV7B,gBAAAA,MAAAA,CAAOC,IAAI,CAAC4B,MAAAA,CAAAA,CAAQ3B,OAAO,CAAC,CAAC4B,GAAAA,GAAAA;oBAC3B9B,MAAAA,CAAO+B,MAAM,CAACF,MAAAA,EAAQ;AACpB,wBAAA,CAACC,MAAME,SAAAA,CAAUH,MAAM,CAACC,IAAI,EAAE;AAAEG,4BAAAA,EAAAA,EAAIJ,MAAM,CAACC,GAAAA,CAAI,CAACG,EAAE,GAAG,IAAIC,IAAAA,CAAKL,MAAM,CAACC,GAAAA,CAAI,CAACG,EAAE,CAAA,GAAI;AAAK,yBAAA;AACvF,qBAAA,CAAA;AACF,gBAAA,CAAA,CAAA;AACF,YAAA;YACAjC,MAAAA,CAAO+B,MAAM,CAACX,IAAAA,EAAM;AAAES,gBAAAA;AAAO,aAAA,CAAA;YAC7B,OAAOT,IAAAA;AACT,QAAA,CAAA,CAAA;;AAGA;;;;;;MAOA/D,kBAAA,CAAA,IAAA,EAAU2D,mBAAkB,CAACD,YAAAA,GAAAA;AAC3B,YAAA,IAAIoB,YAAAA,GAAe,IAAA;YACnB,IAAIpB,YAAAA,CAAaqB,MAAM,IAAI,CAAA,EAAG;AAC5B,gBAAA,IAAI,CAAC7E,MAAM,CAACc,KAAK,CAAC,gCAAA,EAAkC;AAAE0C,oBAAAA;AAAa,iBAAA,CAAA;gBACnEoB,YAAAA,GAAe,KAAA;YACjB,CAAA,MAAO,IAAIpB,iBAAiB,WAAA,EAAa;AACvC,gBAAA,IAAI,CAACxD,MAAM,CAACc,KAAK,CAAC,yCAAA,EAA2C;AAAE0C,oBAAAA;AAAa,iBAAA,CAAA;gBAC5EoB,YAAAA,GAAe,KAAA;AACjB,YAAA;YACA,OAAOA,YAAAA;AACT,QAAA,CAAA,CAAA;QAnUE,IAAI,CAAChF,GAAG,GAAGA,KAAAA;QACX,IAAI,CAACf,OAAO,GAAGA,OAAAA;QACf,IAAI,CAACgB,OAAO,GAAGA,OAAAA;AACf,QAAA,IAAI,CAACG,MAAM,GAAG1B,SAAAA,CAAU8D,GAAG,CAAC,YAAA,EAAcvD,OAAAA,CAAAA;AAC5C,IAAA;AAiUF;;;;;;;;;;;;;;;AC/VO,MAAMiG,WAAAA,SAQHrG,UAAAA,CAAAA;IAcDsG,SAAAA,GAAqB;AAC1B,QAAA,OAAO,CAAC,CAAC,IAAI,CAACC,WAAW;AAC3B,IAAA;AAEOzF,IAAAA,KAAAA,CAAMZ,GAAa,EAAiC;AACzD,QAAA,MAAMsG,GAAAA,GAAM,IAAI,CAAC/F,KAAK,CAACP,GAAAA,CAAAA;AACvB,QAAA,MAAMuG,GAAAA,GAAM,IAAI,CAAC7F,YAAY,CAACV,GAAAA,CAAAA;QAC9B,OAAO;AAAEC,YAAAA,EAAAA,EAAIqG,IAAIrG,EAAE;AAAEuG,YAAAA,EAAAA,EAAIF,IAAIE,EAAE;AAAED,YAAAA;AAAI,SAAA;AACvC,IAAA;AAEOjG,IAAAA,MAAAA,CAAON,GAAa,EAAkC;AAC3D;;;;AAIC,QACD,IAAIyG,GAAAA,GAAuC;YAAC,IAAI,CAAC1G,KAAK,CAACC,GAAAA;AAAK,SAAA;QAC5DyG,GAAAA,GAAMA,GAAAA,CAAIC,MAAM,CAAC,IAAI,CAACL,WAAW,CAAC/F,MAAM,CAACN,GAAAA,CAAAA,CAAAA;QACzC,OAAOyG,GAAAA;AACT,IAAA;AAEO/F,IAAAA,YAAAA,CAAaV,GAAa,EAAmC;AAClE,QAAA,OAAO,IAAI,CAACqG,WAAW,CAAC/F,MAAM,CAACN,GAAAA,CAAAA;AACjC,IAAA;IAjCA,WAAA,CACEiB,GAAuC,EACvC0F,IAAO,EACPN,WAAkD,EAClDnF,OAAAA,GAA6B,EAAE,CAC/B;QACA,KAAK,CAACD,GAAAA,EAAY0F,IAAAA,EAAMzF,OAAAA,CAAAA,EAR1BC,kBAAA,CAAA,IAAA,EAAQkF,aAAAA,EAAR,MAAA,CAAA,EAqCAlF,kBAAA,CAAA,IAAA,EAAUyC,YAAAA,EAAa,OAAOrC,GAAAA,EAAcvB,GAAAA,GAAAA;AAC1C,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACwC,OAAO,CAAC,eAAA,EAAiB;AAAEtB,gBAAAA,IAAI,EAAEhB,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKgB,IAAI;AAAEX,gBAAAA,KAAK,EAAEL,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKK,KAAK;AAAEC,gBAAAA,MAAM,EAAEN,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKM,MAAM;AAAEzB,gBAAAA,MAAM,EAAEJ,GAAAA,KAAAA,IAAAA,IAAAA,GAAAA,KAAAA,MAAAA,GAAAA,MAAAA,GAAAA,GAAAA,CAAKI;AAAO,aAAA,CAAA;AACpH,YAAA,MAAMwG,eAAe,IAAI,CAACpB,YAAY,CAACjE,IAAIgB,IAAI,CAAA;AAC/C,YAAA,IAAI2C,OAAOG,eAAAA,CAAW,MAAM5D,aAAAA,CAAcoF,MAAM,CAC9CD,YAAAA,EAAc;gBAAEE,SAAAA,EAAW,IAAI,CAACpG,YAAY,CAACV,GAAAA;aAAK,CAAA,EAAI,IAAI,CAACS,SAAS,EAAA,CAAA;AACtEyE,YAAAA,IAAAA,GAAO,MAAM,IAAI,CAACD,cAAc,CAACC,IAAAA,CAAAA;AACjC,YAAA,IAAI,CAAC7D,MAAM,CAACwC,OAAO,CAAC,iBAAA,EAAmBqB,IAAAA,CAAAA;AACvClF,YAAAA,GAAAA,CAAIqC,IAAI,CAAC6C,IAAAA,CAAAA;QACX,CAAA,CAAA,EAEA/D,kBAAA,CAAA,IAAA,EAAUuC,WAAAA,EAAY,OAAOnC,GAAAA,EAAcvB,GAAAA,GAAAA;AACzC,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;YACzC,MAAME,KAAAA,GAAqBL,IAAIK,KAAK;YACpC,MAAMmF,MAAAA,GAASnF,KAAK,CAAC,QAAA,CAAS;YAC9B,MAAMoF,YAAAA,GAAepF,KAAK,CAAC,cAAA,CAAe;YAC1C,MAAMqF,GAAAA,GAAMrF,KAAK,CAAC,KAAA,CAAM;AAExB,YAAA,IAAIsF,QAAuC,EAAE;AAE7C,YAAA,IAAIH,MAAAA,EAAQ;;AAEV,gBAAA,IAAI,CAAC1F,MAAM,CAACwC,OAAO,CAAC,2BAAA,EAA6B;AAAEkD,oBAAAA,MAAAA;AAAQC,oBAAAA,YAAAA;AAAcC,oBAAAA;AAAI,iBAAA,CAAA;AAE7E,gBAAA,IAAIA,QAAQ,MAAA,EAAQ;AAClB,oBAAA,MAAM/B,OAAO,MAAO,IAAI,CAACjE,GAAG,CAASkG,OAAO,CAACJ,MAAAA,EAAQK,KAAKC,KAAK,CAACL,eAAe,IAAI,CAACtG,YAAY,CAACV,GAAAA,CAAAA,CAAAA;AACjGkH,oBAAAA,KAAAA,GAAQhC,IAAAA,GAAO;AAACA,wBAAAA;AAAK,qBAAA,GAAG,EAAE;gBAC5B,CAAA,MAAO;AACLgC,oBAAAA,KAAAA,GAAQ,MAAMzF,aAAAA,CAAc6F,IAAI,CAACP,MAAAA,EAAQK,IAAAA,CAAKC,KAAK,CAACL,YAAAA,CAAAA,EAAe,IAAI,CAACtG,YAAY,CAACV,GAAAA,CAAAA,CAAAA;AACvF,gBAAA;YACF,CAAA,MAAO;;gBAEL,MAAMuH,SAAAA,GAAuBC,kBAAAA,CAAcjG,GAAAA,CAAIK,KAAK,CAAA;AACpD,gBAAA,IAAI,CAACP,MAAM,CAACwC,OAAO,CAAC,8BAAA,EAAgC0D,SAAAA,CAAAA;gBACpDL,KAAAA,GAAQ,MAAMzF,cAAcgG,GAAG,CAACF,WAAW,IAAI,CAAC7G,YAAY,CAACV,GAAAA,CAAAA,CAAAA;AAC7D,gBAAA,IAAI,CAACqB,MAAM,CAACwC,OAAO,CAAC,2BAAA,EAA6BqD,MAAMhB,MAAM,CAAA;AAC/D,YAAA;YAEAlG,GAAAA,CAAIqC,IAAI,CAAC6E,KAAAA,CAAMQ,GAAG,CAAC,CAACxC,IAAAA,GAAsCG,eAAAA,CAAWH,IAAAA,EAAM,IAAI,CAACzE,SAAS,EAAA,CAAA,CAAA,CAAA;AAC3F,QAAA,CAAA,CAAA;QAnEE,IAAI,CAAC4F,WAAW,GAAGA,WAAAA;AACrB,IAAA;AAoEF;;;;;;;;;;;;;;;AC1FO,MAAMsB,WAAAA,SAAyD7H,UAAAA,CAAAA;AAM7Dc,IAAAA,KAAAA,CAAMZ,GAAa,EAAa;AACrC,QAAA,MAAMsG,GAAAA,GAAM,IAAI,CAAC/F,KAAK,CAACP,GAAAA,CAAAA;QACvB,OAAOsG,GAAAA;AACT,IAAA;AAPA,IAAA,WAAA,CAAYrF,GAAmB,EAAEf,OAAU,EAAEgB,OAAAA,GAA6B,EAAE,CAAE;AAC5E,QAAA,KAAK,CAACD,GAAAA,EAAYf,OAAAA,EAASgB,UAQ7B,gBAAA,CAAA,IAAA,EAAO0C,YAAAA,EAAa,OAAOrC,GAAAA,EAAcvB,GAAAA,GAAAA;AACvC,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACwC,OAAO,CAAC,eAAA,EAAiB;AAAEtB,gBAAAA,IAAAA,EAAMhB,IAAIgB,IAAI;AAAEX,gBAAAA,KAAAA,EAAOL,IAAIK,KAAK;AAAEC,gBAAAA,MAAAA,EAAQN,IAAIM,MAAM;AAAEzB,gBAAAA,MAAAA,EAAQJ,IAAII;AAAO,aAAA,CAAA;AAChH,YAAA,MAAMwG,eAAe,IAAI,CAACpB,YAAY,CAACjE,IAAIgB,IAAI,CAAA;YAC/C,IAAI2C,IAAAA,GAAOG,gBAAW,MAAM5D,aAAAA,CAAcoF,MAAM,CAACD,YAAAA,CAAAA,EAAe,IAAI,CAACnG,SAAS,EAAA,CAAA;AAC9EyE,YAAAA,IAAAA,GAAO,MAAM,IAAI,CAACD,cAAc,CAACC,IAAAA,CAAAA;AACjC,YAAA,IAAI,CAAC7D,MAAM,CAACwC,OAAO,CAAC,iBAAA,EAAmBqB,IAAAA,CAAAA;AACvClF,YAAAA,GAAAA,CAAIqC,IAAI,CAAC6C,IAAAA,CAAAA;QACX,CAAA,CAAA,EAEA,gBAAA,CAAA,IAAA,EAAUxB,WAAAA,EAAY,OAAOnC,GAAAA,EAAcvB,GAAAA,GAAAA;AACzC,YAAA,MAAMyB,aAAAA,GAAgB,IAAI,CAACR,GAAG,CAACS,UAAU;AACzC,YAAA,IAAI,CAACL,MAAM,CAACwC,OAAO,CAAC,eAAA,EAAiB;AAAEjC,gBAAAA,KAAAA,EAAOL,IAAIK,KAAK;AAAEC,gBAAAA,MAAAA,EAAQN,IAAIM,MAAM;AAAEzB,gBAAAA,MAAAA,EAAQJ,IAAII;AAAO,aAAA,CAAA;AAEhG,YAAA,IAAI8G,QAAmB,EAAE;YAEzB,MAAMtF,KAAAA,GAAqBL,IAAIK,KAAK;YACpC,MAAMmF,MAAAA,GAASnF,KAAK,CAAC,QAAA,CAAS;YAC9B,MAAMoF,YAAAA,GAAepF,KAAK,CAAC,cAAA,CAAe;YAC1C,MAAMqF,GAAAA,GAAMrF,KAAK,CAAC,KAAA,CAAM;AAExB,YAAA,IAAImF,MAAAA,EAAQ;;AAEV,gBAAA,IAAI,CAAC1F,MAAM,CAACwC,OAAO,CAAC,wCAAA,EAA0CkD,QAAQC,YAAAA,EAAcC,GAAAA,CAAAA;AAEpF,gBAAA,IAAIA,QAAQ,MAAA,EAAQ;AAClB,oBAAA,MAAM/B,IAAAA,GAAO,MAAM,IAAK,CAACjE,GAAG,CAASkG,OAAO,CAACJ,MAAAA,EAAQK,IAAAA,CAAKC,KAAK,CAACL,YAAAA,CAAAA,CAAAA;AAChEE,oBAAAA,KAAAA,GAAQhC,IAAAA,GAAO;AAACA,wBAAAA;AAAK,qBAAA,GAAG,EAAE;gBAC5B,CAAA,MAAO;AACLgC,oBAAAA,KAAAA,GAAQ,MAAMzF,aAAAA,CAAc6F,IAAI,CAACP,MAAAA,EAAQK,IAAAA,CAAKC,KAAK,CAACL,YAAAA,CAAAA,CAAAA;AACtD,gBAAA;YACF,CAAA,MAAO;;gBAEL,MAAMO,SAAAA,GAAuBC,kBAAAA,CAAcjG,GAAAA,CAAIK,KAAK,CAAA;AACpD,gBAAA,IAAI,CAACP,MAAM,CAACwC,OAAO,CAAC,+BAAA,EAAiC0D,SAAAA,CAAAA;gBACrDL,KAAAA,GAAQ,MAAMzF,aAAAA,CAAcgG,GAAG,CAACF,SAAAA,CAAAA;AAClC,YAAA;YAEAvH,GAAAA,CAAIqC,IAAI,CAAC6E,KAAAA,CAAMQ,GAAG,CAAC,CAACxC,IAAAA,GAAkBG,eAAAA,CAAWH,IAAAA,EAAM,IAAI,CAACzE,SAAS,EAAA,CAAA,CAAA,CAAA;AACvE,QAAA,CAAA,CAAA;AA9CA,IAAA;AAgDF;;ACxDA,MAAMY,QAAAA,GAAS1B,SAAAA,CAAU8D,GAAG,CAAC,UAAA,CAAA;AA4BtB,MAAMmE,cAAAA,GAAiB,CAS1BC,UAAAA,EACAC,UAAAA,EACAhH,MAAAA,GAAAA;IAEFO,QAAAA,CAAOM,KAAK,CAAC,gBAAA,EAAkB;AAAEmG,QAAAA,UAAAA;AAAYhH,QAAAA,MAAAA;AAAQ+G,kBAAAA;AAAS,KAAA,CAAA;IAC9D,MAAME,YAAAA,GAAeC,wBAAmBH,UAAAA,EAAUC,UAAAA,CAAAA;IAClD,OAAO;AAAE,QAAA,GAAGC,YAAY;AAAEjH,QAAAA;AAAO,KAAA;AACnC;AAEO,MAAMmH,aAAa,CAACC,QAAAA,GAAAA;AACzB,IAAA,OAAOA,QAAAA,IAAY,IAAA,IACjB,OAAOA,QAAAA,KAAa,YACpBA,QAAAA,CAASJ,UAAU,IAAI,IAAA,IACvBI,SAASpH,MAAM,IAAI,IAAA,IACnBoH,QAAAA,CAASL,QAAQ,IAAI,IAAA;AACzB;;AClDA,MAAMxG,QAAAA,GAAS1B,SAAAA,CAAU8D,GAAG,CAAC,iBAAA,CAAA;AAc7B;;IAGO,MAAM0E,qBAAAA,GAAwB,CASjCrH,MAAAA,GAAAA;AAEF,IAAA,OAAO,CAACgH,UAAAA,EAA+CM,OAAAA,GAAAA;QACrD/G,QAAAA,CAAOM,KAAK,CAAC,kCAAA,EAAoC;AAAEmG,YAAAA,UAAAA;AAAYD,YAAAA,QAAAA,EAAUO,QAAQP,QAAQ;AAAE/G,YAAAA;AAAO,SAAA,CAAA;AAElG,QAAA,OAAO8G,cAAAA,CAAeQ,OAAAA,CAAQP,QAAQ,EAAEC,UAAAA,EAAYhH,MAAAA,CAAAA;AACtD,IAAA,CAAA;AACF;;AChCA,MAAMO,MAAAA,GAAS1B,SAAAA,CAAU8D,GAAG,CAAC,UAAA,CAAA;AAS7B;;UAGa4E,qBAAAA,GAAwB,IAAA;AACnC,IAAA,OAAO,CAAC1B,IAAAA,EAAc2B,WAAAA,GAAAA;AACpB,QAAA,IAAI3B,SAAS,gBAAA,EAAkB;AAC7B,YAAA,MAAM,IAAIhG,KAAAA,CAAM,CAAC,uFAAuF,EAAEgG,IAAAA,CAAAA,CAAM,CAAA;AAClH,QAAA;QAEAtF,MAAAA,CAAOM,KAAK,CAAC,kCAAA,EAAoC;AAAEgF,YAAAA,IAAAA;AAAM2B,YAAAA;AAAY,SAAA,CAAA;QAErE,MAAMC,YAAAA,GAAeC,wBAAmB7B,IAAAA,EAAM2B,WAAAA,CAAAA;;QAG9C,OAAOC,YAAAA;AACT,IAAA,CAAA;AACF;AAEA;;IAGO,MAAME,cAAAA,GAAiB,CAACH,WAAAA,GAAAA;IAC7B,MAAMC,YAAAA,GAAeC,wBAAmB,gBAAA,EAAkBF,WAAAA,CAAAA;IAE1D,OAAO;AACL,QAAA,GAAGC;AACL,KAAA;AACF;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
 export * from './ItemRouter';
 export * from './CItemRouter';
 export * from './PItemRouter';
+export * from './Instance';
+export * from './InstanceFactory';
+export * from './Registry';

package/dist/index.js

@@ -1,4 +1,7 @@
 export { ItemRouter } from './ItemRouter.js';
 export { CItemRouter } from './CItemRouter.js';
 export { PItemRouter } from './PItemRouter.js';
+export { createInstance, isInstance } from './Instance.js';
+export { createInstanceFactory } from './InstanceFactory.js';
+export { createRegistry, createRegistryFactory } from './Registry.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/examples/README.md

@@ -0,0 +1,339 @@
+# Fjell-Express-Router Examples
+
+This directory contains examples demonstrating how to use fjell-express-router for building Express.js applications with automatic CRUD routing, hierarchical data management, and business logic integration with different patterns and complexity levels.
+
+## Examples
+
+### 1. `basic-router-example.ts` ⭐ **Start Here!**
+**Perfect for beginners!** Demonstrates the fundamental way to use fjell-express-router for REST API development:
+- **Basic PItemRouter usage** - Create routers for primary entities (Users, Tasks)
+- **Automatic CRUD endpoints** - GET, POST, PUT, DELETE routes generated automatically
+- **Mock data operations** - Simple in-memory storage with business logic
+- **Express app integration** - Mount routers and add custom middleware
+- **Custom business routes** - Dashboard and health check endpoints
+
+Great for understanding the fundamentals of fjell-express-router for REST API development.
+
+### 2. `nested-router-example.ts` 🏗️ **Hierarchical Data Management**
+**Advanced hierarchical routing!** Demonstrates complex data structures with nested relationships:
+- **Multiple router types**: PItemRouter for Organizations, CItemRouter for Departments and Employees
+- **Nested route mounting**: `/organizations/:orgId/departments/:deptId/employees/:empId`
+- **Hierarchical data models**: Organization → Department → Employee relationships
+- **Location-based operations**: Complex queries spanning multiple organizational levels
+- **Business analytics**: Organizational hierarchy summaries and statistics
+
+Shows how fjell-express-router handles enterprise organizational data patterns with deep hierarchies.
+
+### 3. `full-application-example.ts` 🚀 **Production-Ready Application**
+**Complete enterprise application!** Demonstrates a realistic e-commerce system with advanced patterns:
+- **Multiple interconnected entities**: Customer, Product, Order, OrderItem, Review
+- **Advanced middleware**: Error handling, request logging, business validation
+- **Complex business logic**: Product catalog, customer analytics, order management
+- **Production patterns**: CORS headers, security middleware, proper error handling
+- **Real-world scenarios**: Complete e-commerce platform with customer lifecycle management
+
+Perfect for understanding how to build production-ready applications with fjell-express-router.
+
+## Key Concepts Demonstrated
+
+### Basic Router Setup (basic-router-example.ts)
+```typescript
+// Import fjell-express-router functionality
+import { PItemRouter, createRegistry } from '@fjell/express-router';
+import express from 'express';
+
+// Create Express app and registry
+const app = express();
+const registry = createRegistry();
+
+// Create router instance
+const userRouter = new PItemRouter(userInstance, 'user');
+
+// Mount router to create automatic REST endpoints
+app.use('/api/users', userRouter.getRouter());
+// This creates:
+// GET    /api/users           - List all users
+// GET    /api/users/:userPk   - Get specific user
+// POST   /api/users           - Create new user
+// PUT    /api/users/:userPk   - Update user
+// DELETE /api/users/:userPk   - Delete user
+```
+
+### Nested Routing (nested-router-example.ts)
+```typescript
+// Create hierarchical routers
+const orgRouter = new PItemRouter(orgInstance, 'organization');
+const deptRouter = new CItemRouter(deptInstance, 'department', orgRouter);
+const empRouter = new CItemRouter(empInstance, 'employee', deptRouter);
+
+// Mount nested routes
+app.use('/api/organizations', orgRouter.getRouter());
+app.use('/api/organizations/:organizationPk/departments', deptRouter.getRouter());
+app.use('/api/organizations/:organizationPk/departments/:departmentPk/employees', empRouter.getRouter());
+
+// This creates nested endpoints like:
+// GET /api/organizations/org-1/departments/dept-1/employees
+// POST /api/organizations/org-1/departments/dept-1/employees
+```
+
+### Production Application (full-application-example.ts)
+```typescript
+// Advanced middleware setup
+app.use(express.json({ limit: '10mb' }));
+app.use(requestLogger);
+app.use(validateCustomerTier);
+app.use(errorHandler);
+
+// Business logic routes
+app.get('/api/dashboard', async (req, res) => {
+  // Complex dashboard with analytics
+});
+
+app.get('/api/catalog', async (req, res) => {
+  // Product catalog with filtering and search
+});
+```
+
+## Data Model Patterns
+
+### Primary Items (PItemRouter)
+Primary items are top-level entities that exist independently:
+```typescript
+interface User extends Item<'user'> {
+  id: string;
+  name: string;
+  email: string;
+  // ... other properties
+}
+
+// Creates routes: /api/users, /api/users/:userPk
+const userRouter = new PItemRouter(userInstance, 'user');
+```
+
+### Contained Items (CItemRouter)
+Contained items exist within a parent context and inherit location:
+```typescript
+interface Department extends Item<'department', 'organization'> {
+  id: string;
+  name: string;
+  organizationId: string; // Reference to parent
+  // ... other properties
+}
+
+// Creates nested routes: /api/organizations/:orgPk/departments
+const deptRouter = new CItemRouter(deptInstance, 'department', orgRouter);
+```
+
+### Multi-Level Hierarchies
+Deep nesting is supported for complex organizational structures:
+```typescript
+interface Employee extends Item<'employee', 'organization', 'department'> {
+  id: string;
+  name: string;
+  organizationId: string;
+  departmentId: string;
+  // ... other properties
+}
+
+// Creates deeply nested routes: /api/organizations/:orgPk/departments/:deptPk/employees
+const empRouter = new CItemRouter(empInstance, 'employee', deptRouter);
+```
+
+## Running the Examples
+
+### Prerequisites
+```bash
+# Install dependencies
+npm install express @fjell/core @fjell/lib @fjell/express-router
+
+# For running TypeScript examples
+npm install -g tsx
+```
+
+### Running Individual Examples
+
+**Basic Router Example:**
+```bash
+npx tsx examples/basic-router-example.ts
+# Server runs on http://localhost:3001
+```
+
+**Nested Router Example:**
+```bash
+npx tsx examples/nested-router-example.ts
+# Server runs on http://localhost:3002
+```
+
+**Full Application Example:**
+```bash
+npx tsx examples/full-application-example.ts
+# Server runs on http://localhost:3003
+```
+
+## Testing the Examples
+
+### Basic Router Example (Port 3001)
+```bash
+# Health check
+curl http://localhost:3001/api/health
+
+# Dashboard summary
+curl http://localhost:3001/api/dashboard
+
+# List all users
+curl http://localhost:3001/api/users
+
+# Get specific user
+curl http://localhost:3001/api/users/user-1
+
+# Create new user
+curl -X POST http://localhost:3001/api/users \
+  -H "Content-Type: application/json" \
+  -d '{"name":"New User","email":"new@example.com","role":"user"}'
+
+# List all tasks
+curl http://localhost:3001/api/tasks
+```
+
+### Nested Router Example (Port 3002)
+```bash
+# Organizational hierarchy
+curl http://localhost:3002/api/hierarchy
+
+# Statistics summary
+curl http://localhost:3002/api/stats
+
+# List organizations
+curl http://localhost:3002/api/organizations
+
+# List departments for organization
+curl http://localhost:3002/api/organizations/org-1/departments
+
+# List employees for department
+curl http://localhost:3002/api/organizations/org-1/departments/dept-1/employees
+
+# Create new department
+curl -X POST http://localhost:3002/api/organizations/org-1/departments \
+  -H "Content-Type: application/json" \
+  -d '{"name":"IT Department","budget":1000000,"headCount":15}'
+```
+
+### Full Application Example (Port 3003)
+```bash
+# System health
+curl http://localhost:3003/health
+
+# Business dashboard
+curl http://localhost:3003/api/dashboard
+
+# Product catalog
+curl http://localhost:3003/api/catalog
+
+# Filtered catalog
+curl "http://localhost:3003/api/catalog?category=Electronics&featured=true"
+
+# Customer analytics
+curl http://localhost:3003/api/customers/cust-1/analytics
+
+# List customers
+curl http://localhost:3003/api/customers
+
+# Customer orders
+curl http://localhost:3003/api/customers/cust-1/orders
+
+# Create new customer
+curl -X POST http://localhost:3003/api/customers \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "New Customer",
+    "email": "customer@example.com",
+    "phone": "+1-555-0789",
+    "address": {
+      "street": "789 Pine St",
+      "city": "Seattle",
+      "state": "WA",
+      "zipCode": "98101"
+    },
+    "tier": "bronze"
+  }'
+```
+
+## Integration Patterns
+
+### Mock Operations
+All examples use mock operations that simulate real database interactions:
+```typescript
+const createUserOperations = () => ({
+  async all() { /* return all users */ },
+  async get(key) { /* return specific user */ },
+  async create(item) { /* create new user */ },
+  async update(key, updates) { /* update user */ },
+  async remove(key) { /* delete user */ },
+  async find(finder, params) { /* find users with criteria */ }
+});
+```
+
+### Instance Creation
+Fjell instances wrap operations and provide router integration:
+```typescript
+const mockUserInstance = {
+  operations: createUserOperations(),
+  options: {}
+};
+
+const userRouter = new PItemRouter(mockUserInstance, 'user');
+```
+
+### Error Handling
+Production applications should include comprehensive error handling:
+```typescript
+const errorHandler = (err, req, res, next) => {
+  console.error('Application Error:', err.message);
+  res.status(500).json({
+    error: 'Internal Server Error',
+    message: process.env.NODE_ENV === 'development' ? err.message : 'Something went wrong'
+  });
+};
+
+app.use(errorHandler);
+```
+
+## Best Practices
+
+### 1. **Start Simple**
+Begin with the basic router example to understand core concepts before moving to complex hierarchies.
+
+### 2. **Design Your Data Model**
+Plan your Item interfaces and relationships carefully:
+- Use PItemRouter for independent entities
+- Use CItemRouter for entities that belong to parents
+- Define clear location hierarchies for nested data
+
+### 3. **Implement Operations**
+Create comprehensive operations that handle:
+- CRUD operations (all, get, create, update, remove)
+- Business logic finders (find method with custom logic)
+- Error handling and validation
+
+### 4. **Add Business Logic**
+Extend beyond basic CRUD with:
+- Custom middleware for validation
+- Business logic routes (dashboards, analytics)
+- Proper error handling and logging
+
+### 5. **Production Considerations**
+For production applications:
+- Implement proper authentication/authorization
+- Add rate limiting and security headers
+- Use environment-specific configurations
+- Implement comprehensive logging and monitoring
+
+## Next Steps
+
+1. **Study the examples** in order of complexity
+2. **Run each example** and test the endpoints
+3. **Modify the data models** to match your use case
+4. **Implement real operations** with your database/API
+5. **Add authentication and security** for production use
+
+For more advanced usage, see the fjell-express-router documentation and explore other fjell ecosystem packages like fjell-cache, fjell-lib, and fjell-client-api.