@shakerquiz/utilities 4.0.55 → 4.0.56

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@shakerquiz/utilities",
-  "version": "4.0.55",
+  "version": "4.0.56",
   "author": "yurkimus <yurkimus@gmail.com>",
   "license": "ISC",
   "repository": {
@@ -15,7 +15,7 @@
     "prepublishOnly": "bun scripts/codegen.js && dprint fmt --includes-override source/codegen/autogenerated.js"
   },
   "devDependencies": {
-    "@types/bun": "1.3.6",
+    "@types/bun": "1.3.8",
     "dprint": "0.51.1"
   }
 }

package/source/codegen/autogenerated.js

@@ -249,31 +249,31 @@ export const RoutePathname = Object.freeze(
     'themes': 'themes',
     'themes/search': 'themes/search',
     'game/search': 'game/:game/search',
-    'game/status/search': 'game/:game/status/:status/search',
+    'game/status/search': 'game/:game/status/search',
     'game/city/search': 'game/:game/city/:city/search',
     'game/summary/search': 'game/:game/summary/search',
     'game/theme/search': 'game/:game/theme/:theme/search',
     'game/theme/cover/search': 'game/:game/theme/:theme/cover/:cover/search',
     'game/venue/search': 'game/:game/venue/:venue/search',
     'game/registration': 'game/:game/registration/:registration',
-    'game/registration/status': 'game/:game/registration/:registration/status/:status',
+    'game/registration/status': 'game/:game/registration/:registration/status',
     'game/registration/lineup': 'game/:game/registration/:registration/lineup',
     'game/registrations': 'game/:game/registrations',
-    'game/registrations/status': 'game/:game/registrations/status/:status',
+    'game/registrations/status': 'game/:game/registrations/status',
     'game/registrations/lineup': 'game/:game/registrations/lineup',
     'game/summary': 'game/:game/summary',
     'game/theme': 'game/:game/theme/:theme',
     'game/theme/cover': 'game/:game/theme/:theme/cover/:cover',
     'game/venue': 'game/:game/venue/:venue',
     'games/search': 'games/search',
-    'games/status/search': 'games/status/:status/search',
+    'games/status/search': 'games/status/search',
     'games/city/search': 'games/city/:city/search',
     'games/summary/search': 'games/summary/search',
     'games/theme/search': 'games/theme/:theme/search',
     'games/theme/cover/search': 'games/theme/:theme/cover/:cover/search',
     'games/venue/search': 'games/venue/:venue/search',
     'registration/search': 'registration/:registration/search',
-    'registration/status/search': 'registration/:registration/status/:status/search',
+    'registration/status/search': 'registration/:registration/status/search',
     'registration/creation': 'registration/:registration/creation',
     'registration/confirmation': 'registration/:registration/confirmation',
     'registration/cancellation': 'registration/:registration/cancellation',
@@ -286,11 +286,11 @@ export const RoutePathname = Object.freeze(
     'registration/game/theme/cover/search': 'registration/:registration/game/:game/theme/:theme/cover/:cover/search',
     'registration/game/venue/search': 'registration/:registration/game/:game/venue/:venue/search',
     'registrations/search': 'registrations/search',
-    'registrations/status/search': 'registrations/status/:status/search',
+    'registrations/status/search': 'registrations/status/search',
     'registrations/lineup/search': 'registrations/lineup/search',
     'registrations/city/search': 'registrations/city/:city/search',
     'registrations/game/search': 'registrations/game/:game/search',
-    'registrations/game/status/search': 'registrations/game/:game/status/:status/search',
+    'registrations/game/status/search': 'registrations/game/:game/status/search',
     'registrations/game/theme/search': 'registrations/game/:game/theme/:theme/search',
     'registrations/game/venue/search': 'registrations/game/:game/venue/:venue/search',
     'telegram/webhook': 'telegram/webhook',
@@ -423,7 +423,6 @@ export const RouteParameters = Object.freeze(
     ],
     'game/status/search': [
       ':game',
-      ':status',
     ],
     'game/city/search': [
       ':game',
@@ -452,7 +451,6 @@ export const RouteParameters = Object.freeze(
     'game/registration/status': [
       ':game',
       ':registration',
-      ':status',
     ],
     'game/registration/lineup': [
       ':game',
@@ -463,7 +461,6 @@ export const RouteParameters = Object.freeze(
     ],
     'game/registrations/status': [
       ':game',
-      ':status',
     ],
     'game/registrations/lineup': [
       ':game',
@@ -485,9 +482,7 @@ export const RouteParameters = Object.freeze(
       ':venue',
     ],
     'games/search': [],
-    'games/status/search': [
-      ':status',
-    ],
+    'games/status/search': [],
     'games/city/search': [
       ':city',
     ],
@@ -507,7 +502,6 @@ export const RouteParameters = Object.freeze(
     ],
     'registration/status/search': [
       ':registration',
-      ':status',
     ],
     'registration/creation': [
       ':registration',
@@ -552,9 +546,7 @@ export const RouteParameters = Object.freeze(
       ':venue',
     ],
     'registrations/search': [],
-    'registrations/status/search': [
-      ':status',
-    ],
+    'registrations/status/search': [],
     'registrations/lineup/search': [],
     'registrations/city/search': [
       ':city',
@@ -564,7 +556,6 @@ export const RouteParameters = Object.freeze(
     ],
     'registrations/game/status/search': [
       ':game',
-      ':status',
     ],
     'registrations/game/theme/search': [
       ':game',
@@ -639,31 +630,31 @@ export const PathnameRoute = Object.freeze(
     'themes': 'themes',
     'themes/search': 'themes/search',
     'game/:game/search': 'game/search',
-    'game/:game/status/:status/search': 'game/status/search',
+    'game/:game/status/search': 'game/status/search',
     'game/:game/city/:city/search': 'game/city/search',
     'game/:game/summary/search': 'game/summary/search',
     'game/:game/theme/:theme/search': 'game/theme/search',
     'game/:game/theme/:theme/cover/:cover/search': 'game/theme/cover/search',
     'game/:game/venue/:venue/search': 'game/venue/search',
     'game/:game/registration/:registration': 'game/registration',
-    'game/:game/registration/:registration/status/:status': 'game/registration/status',
+    'game/:game/registration/:registration/status': 'game/registration/status',
     'game/:game/registration/:registration/lineup': 'game/registration/lineup',
     'game/:game/registrations': 'game/registrations',
-    'game/:game/registrations/status/:status': 'game/registrations/status',
+    'game/:game/registrations/status': 'game/registrations/status',
     'game/:game/registrations/lineup': 'game/registrations/lineup',
     'game/:game/summary': 'game/summary',
     'game/:game/theme/:theme': 'game/theme',
     'game/:game/theme/:theme/cover/:cover': 'game/theme/cover',
     'game/:game/venue/:venue': 'game/venue',
     'games/search': 'games/search',
-    'games/status/:status/search': 'games/status/search',
+    'games/status/search': 'games/status/search',
     'games/city/:city/search': 'games/city/search',
     'games/summary/search': 'games/summary/search',
     'games/theme/:theme/search': 'games/theme/search',
     'games/theme/:theme/cover/:cover/search': 'games/theme/cover/search',
     'games/venue/:venue/search': 'games/venue/search',
     'registration/:registration/search': 'registration/search',
-    'registration/:registration/status/:status/search': 'registration/status/search',
+    'registration/:registration/status/search': 'registration/status/search',
     'registration/:registration/creation': 'registration/creation',
     'registration/:registration/confirmation': 'registration/confirmation',
     'registration/:registration/cancellation': 'registration/cancellation',
@@ -676,11 +667,11 @@ export const PathnameRoute = Object.freeze(
     'registration/:registration/game/:game/theme/:theme/cover/:cover/search': 'registration/game/theme/cover/search',
     'registration/:registration/game/:game/venue/:venue/search': 'registration/game/venue/search',
     'registrations/search': 'registrations/search',
-    'registrations/status/:status/search': 'registrations/status/search',
+    'registrations/status/search': 'registrations/status/search',
     'registrations/lineup/search': 'registrations/lineup/search',
     'registrations/city/:city/search': 'registrations/city/search',
     'registrations/game/:game/search': 'registrations/game/search',
-    'registrations/game/:game/status/:status/search': 'registrations/game/status/search',
+    'registrations/game/:game/status/search': 'registrations/game/status/search',
     'registrations/game/:game/theme/:theme/search': 'registrations/game/theme/search',
     'registrations/game/:game/venue/:venue/search': 'registrations/game/venue/search',
     'telegram/webhook': 'telegram/webhook',
@@ -811,9 +802,8 @@ export const PathnameParameters = Object.freeze(
     'game/:game/search': [
       ':game',
     ],
-    'game/:game/status/:status/search': [
+    'game/:game/status/search': [
       ':game',
-      ':status',
     ],
     'game/:game/city/:city/search': [
       ':game',
@@ -839,10 +829,9 @@ export const PathnameParameters = Object.freeze(
       ':game',
       ':registration',
     ],
-    'game/:game/registration/:registration/status/:status': [
+    'game/:game/registration/:registration/status': [
       ':game',
       ':registration',
-      ':status',
     ],
     'game/:game/registration/:registration/lineup': [
       ':game',
@@ -851,9 +840,8 @@ export const PathnameParameters = Object.freeze(
     'game/:game/registrations': [
       ':game',
     ],
-    'game/:game/registrations/status/:status': [
+    'game/:game/registrations/status': [
       ':game',
-      ':status',
     ],
     'game/:game/registrations/lineup': [
       ':game',
@@ -875,9 +863,7 @@ export const PathnameParameters = Object.freeze(
       ':venue',
     ],
     'games/search': [],
-    'games/status/:status/search': [
-      ':status',
-    ],
+    'games/status/search': [],
     'games/city/:city/search': [
       ':city',
     ],
@@ -895,9 +881,8 @@ export const PathnameParameters = Object.freeze(
     'registration/:registration/search': [
       ':registration',
     ],
-    'registration/:registration/status/:status/search': [
+    'registration/:registration/status/search': [
       ':registration',
-      ':status',
     ],
     'registration/:registration/creation': [
       ':registration',
@@ -942,9 +927,7 @@ export const PathnameParameters = Object.freeze(
       ':venue',
     ],
     'registrations/search': [],
-    'registrations/status/:status/search': [
-      ':status',
-    ],
+    'registrations/status/search': [],
     'registrations/lineup/search': [],
     'registrations/city/:city/search': [
       ':city',
@@ -952,9 +935,8 @@ export const PathnameParameters = Object.freeze(
     'registrations/game/:game/search': [
       ':game',
     ],
-    'registrations/game/:game/status/:status/search': [
+    'registrations/game/:game/status/search': [
       ':game',
-      ':status',
     ],
     'registrations/game/:game/theme/:theme/search': [
       ':game',
@@ -995,7 +977,6 @@ export const ParameterPattern = Object.freeze(
     ':cover': '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}',
     ':game': '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}',
     ':registration': '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}',
-    ':status': '\w+',
   }),
 )
 

package/source/entities/segment.js

@@ -11,6 +11,7 @@ export const Segments = Object.freeze(
         plural: 'checkins',
         service: Service['Checkin'],
         pattern: null,
+        kind: 'Operation',
       }),
     ),
     Object.freeze(
@@ -21,6 +22,7 @@ export const Segments = Object.freeze(
         plural: 'users',
         service: Service['Users'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -31,6 +33,7 @@ export const Segments = Object.freeze(
         plural: 'users',
         service: Service['Users'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -41,6 +44,7 @@ export const Segments = Object.freeze(
         plural: 'roles',
         service: Service['Roles'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -51,6 +55,7 @@ export const Segments = Object.freeze(
         plural: 'roles',
         service: Service['Roles'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -61,6 +66,7 @@ export const Segments = Object.freeze(
         plural: 'countries',
         service: Service['Locations'],
         pattern: Pattern.COUNTRY_CODE.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -71,6 +77,7 @@ export const Segments = Object.freeze(
         plural: 'countries',
         service: Service['Locations'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -81,6 +88,7 @@ export const Segments = Object.freeze(
         plural: 'currencies',
         service: Service['Locations'],
         pattern: Pattern.CURRENCY_CODE.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -91,6 +99,7 @@ export const Segments = Object.freeze(
         plural: 'currencies',
         service: Service['Locations'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -101,6 +110,7 @@ export const Segments = Object.freeze(
         plural: 'timezones',
         service: Service['Locations'],
         pattern: Pattern.TIMEZONE_NAME.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -111,6 +121,7 @@ export const Segments = Object.freeze(
         plural: 'timezones',
         service: Service['Locations'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -121,6 +132,7 @@ export const Segments = Object.freeze(
         plural: 'cities',
         service: Service['Cities'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -131,6 +143,7 @@ export const Segments = Object.freeze(
         plural: 'cities',
         service: Service['Cities'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -141,6 +154,7 @@ export const Segments = Object.freeze(
         plural: 'venues',
         service: Service['Venues'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -151,6 +165,7 @@ export const Segments = Object.freeze(
         plural: 'venues',
         service: Service['Venues'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -161,6 +176,7 @@ export const Segments = Object.freeze(
         plural: 'themes',
         service: Service['Themes'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -171,6 +187,7 @@ export const Segments = Object.freeze(
         plural: 'themes',
         service: Service['Themes'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -181,6 +198,7 @@ export const Segments = Object.freeze(
         plural: 'covers',
         service: Service['Minio'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -191,6 +209,7 @@ export const Segments = Object.freeze(
         plural: 'covers',
         service: Service['Minio'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -201,6 +220,7 @@ export const Segments = Object.freeze(
         plural: 'games',
         service: Service['Games'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -211,6 +231,7 @@ export const Segments = Object.freeze(
         plural: 'games',
         service: Service['Games'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -221,6 +242,7 @@ export const Segments = Object.freeze(
         plural: 'registrations',
         service: Service['Registrations'],
         pattern: Pattern.UUID.source,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -231,6 +253,7 @@ export const Segments = Object.freeze(
         plural: 'registrations',
         service: Service['Registrations'],
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -240,7 +263,8 @@ export const Segments = Object.freeze(
         singular: 'status',
         plural: 'statuses',
         service: null,
-        pattern: Pattern.STRING.source,
+        pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -251,6 +275,7 @@ export const Segments = Object.freeze(
         plural: 'statuses',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -261,6 +286,7 @@ export const Segments = Object.freeze(
         plural: 'lineups',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -271,6 +297,7 @@ export const Segments = Object.freeze(
         plural: 'lineups',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -281,6 +308,7 @@ export const Segments = Object.freeze(
         plural: 'telegrams',
         service: Service['Telegram'],
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -291,6 +319,7 @@ export const Segments = Object.freeze(
         plural: 'chatapps',
         service: Service['Chatapp'],
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -301,6 +330,7 @@ export const Segments = Object.freeze(
         plural: 'bitrixes',
         service: Service['Bitrix'],
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -311,6 +341,7 @@ export const Segments = Object.freeze(
         plural: 'webhooks',
         service: null,
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -321,6 +352,7 @@ export const Segments = Object.freeze(
         plural: 'sources',
         service: Service['Updates'],
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -331,6 +363,7 @@ export const Segments = Object.freeze(
         plural: 'searches',
         service: null,
         pattern: null,
+        kind: 'Integration',
       }),
     ),
     Object.freeze(
@@ -341,6 +374,7 @@ export const Segments = Object.freeze(
         plural: 'exports',
         service: null,
         pattern: null,
+        kind: 'Operation',
       }),
     ),
     Object.freeze(
@@ -351,6 +385,7 @@ export const Segments = Object.freeze(
         plural: 'passwords',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -361,6 +396,7 @@ export const Segments = Object.freeze(
         plural: 'vk_group_tokens',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -371,6 +407,7 @@ export const Segments = Object.freeze(
         plural: 'summaries',
         service: null,
         pattern: null,
+        kind: 'Aggregation',
       }),
     ),
     Object.freeze(
@@ -381,6 +418,7 @@ export const Segments = Object.freeze(
         plural: 'mailings',
         service: null,
         pattern: null,
+        kind: 'Entity',
       }),
     ),
     Object.freeze(
@@ -391,6 +429,7 @@ export const Segments = Object.freeze(
         plural: 'channels',
         service: null,
         pattern: null,
+        kind: 'Property',
       }),
     ),
     Object.freeze(
@@ -401,6 +440,7 @@ export const Segments = Object.freeze(
         plural: 'creations',
         service: null,
         pattern: null,
+        kind: 'Operation',
       }),
     ),
     Object.freeze(
@@ -411,6 +451,7 @@ export const Segments = Object.freeze(
         plural: 'confirmations',
         service: null,
         pattern: null,
+        kind: 'Operation',
       }),
     ),
     Object.freeze(
@@ -421,6 +462,7 @@ export const Segments = Object.freeze(
         plural: 'cancellations',
         service: null,
         pattern: null,
+        kind: 'Operation',
       }),
     ),
   ]),

package/source/helpers/route.js

@@ -23,6 +23,26 @@ export const route = maybeString => {
   return segments.join('/')
 }
 
+/**
+ * @param {string} maybeRoute
+ *
+ * @example
+ * routeBreakdown('users/role') // ['role']
+ * routeBreakdown('games/search') // ['game']
+ */
+export const routeBreakdown = maybeRoute => {
+  let singulars = route(maybeRoute)
+    .split('/')
+    .filter(segment => ['Entity', 'Property', 'Aggregation', 'Operation'].includes(Segment[segment].kind))
+    .map(segment => Segment[segment].singular)
+
+  let lastIndex = singulars.findLastIndex(segment => Segment[segment].kind === 'Entity')
+
+  return singulars
+    .slice(lastIndex, singulars.length)
+    .join('/')
+}
+
 /**
  * @param {string} segment
  *