@shakerquiz/utilities 0.5.222 → 0.6.1

package/source/entities/route-service.js

@@ -0,0 +1,65 @@
+import { Route } from './route.js'
+import { Service } from './service.js'
+
+export const RouteService = Object.freeze({
+  [Route['user']]: Service['Users'],
+  [Route['user/cities']]: Service['Users'],
+  [Route['user/password']]: Service['Users'],
+  [Route['user/role']]: Service['Users'],
+  [Route['users']]: Service['Users'],
+  [Route['users/cities']]: Service['Users'],
+  [Route['users/role']]: Service['Users'],
+  [Route['role']]: Service['Roles'],
+  [Route['roles']]: Service['Roles'],
+  [Route['checkin']]: Service['Checkin'],
+  [Route['countries']]: Service['Locations'],
+  [Route['country']]: Service['Locations'],
+  [Route['currencies']]: Service['Locations'],
+  [Route['currency']]: Service['Locations'],
+  [Route['timezone']]: Service['Locations'],
+  [Route['timezones']]: Service['Locations'],
+  [Route['cities']]: Service['Cities'],
+  [Route['cities/country']]: Service['Cities'],
+  [Route['cities/currency']]: Service['Cities'],
+  [Route['cities/timezone']]: Service['Cities'],
+  [Route['cities/venues']]: Service['Cities'],
+  [Route['city']]: Service['Cities'],
+  [Route['city/country']]: Service['Cities'],
+  [Route['city/currency']]: Service['Cities'],
+  [Route['city/timezone']]: Service['Cities'],
+  [Route['city/venues']]: Service['Cities'],
+  [Route['venue']]: Service['Venues'],
+  [Route['venue/city']]: Service['Venues'],
+  [Route['venues']]: Service['Venues'],
+  [Route['venues/city']]: Service['Venues'],
+  [Route['theme']]: Service['Themes'],
+  [Route['theme/cover']]: Service['Themes'],
+  [Route['themes']]: Service['Themes'],
+  [Route['themes/cover']]: Service['Themes'],
+  [Route['game']]: Service['Games'],
+  [Route['game/city']]: Service['Games'],
+  [Route['game/registrations']]: Service['Games'],
+  [Route['game/registrations/export']]: Service['Games'],
+  [Route['game/summary']]: Service['Games'],
+  [Route['game/theme']]: Service['Games'],
+  [Route['game/venue']]: Service['Games'],
+  [Route['games']]: Service['Games'],
+  [Route['games/city']]: Service['Games'],
+  [Route['games/registrations']]: Service['Games'],
+  [Route['games/registrations/export']]: Service['Games'],
+  [Route['games/summary']]: Service['Games'],
+  [Route['games/theme']]: Service['Games'],
+  [Route['games/venue']]: Service['Games'],
+  [Route['registration']]: Service['Registrations'],
+  [Route['registration/cancellation']]: Service['Registrations'],
+  [Route['registration/channel']]: Service['Registrations'],
+  [Route['registration/confirmation']]: Service['Registrations'],
+  [Route['registration/city']]: Service['Registrations'],
+  [Route['registration/game']]: Service['Registrations'],
+  [Route['registration/mailing']]: Service['Registrations'],
+  [Route['registrations']]: Service['Registrations'],
+  [Route['registrations/city']]: Service['Registrations'],
+  [Route['registrations/game']]: Service['Registrations'],
+  [Route['registrations/game/theme']]: Service['Registrations'],
+  [Route['registrations/export']]: Service['Registrations'],
+})

package/source/entities/route.js

@@ -0,0 +1,70 @@
+export const Route = Object.freeze({
+  'checkin': 'checkin',
+  'cities': 'cities',
+  'cities/country': 'cities/country',
+  'cities/currency': 'cities/currency',
+  'cities/timezone': 'cities/timezone',
+  'cities/venues': 'cities/venues',
+  'city': 'city',
+  'city/country': 'city/country',
+  'city/currency': 'city/currency',
+  'city/timezone': 'city/timezone',
+  'city/venue': 'city/venue',
+  'city/venues': 'city/venues',
+  'countries': 'countries',
+  'country': 'country',
+  'currencies': 'currencies',
+  'currency': 'currency',
+  'game': 'game',
+  'game/city': 'game/city',
+  'game/registration': 'game/registration',
+  'game/registrations': 'game/registrations',
+  'game/registrations/export': 'game/registrations/export',
+  'game/summary': 'game/summary',
+  'game/theme': 'game/theme',
+  'game/venue': 'game/venue',
+  'games': 'games',
+  'games/city': 'games/city',
+  'games/registrations': 'games/registrations',
+  'games/registrations/export': 'games/registrations/export',
+  'games/summary': 'games/summary',
+  'games/theme': 'games/theme',
+  'games/venue': 'games/venue',
+  'registration': 'registration',
+  'registration/cancellation': 'registration/cancellation',
+  'registration/channel': 'registration/channel',
+  'registration/confirmation': 'registration/confirmation',
+  'registration/export': 'registration/export',
+  'registration/city': 'registration/city',
+  'registration/game': 'registration/game',
+  'registration/game/theme': 'registration/game/theme',
+  'registration/mailing': 'registration/mailing',
+  'registrations': 'registrations',
+  'registrations/city': 'registrations/city',
+  'registrations/game': 'registrations/game',
+  'registrations/game/theme': 'registrations/game/theme',
+  'registrations/export': 'registrations/export',
+  'role': 'role',
+  'roles': 'roles',
+  'theme': 'theme',
+  'theme/cover': 'theme/cover',
+  'themes': 'themes',
+  'themes/cover': 'themes/cover',
+  'timezone': 'timezone',
+  'timezones': 'timezones',
+  'user': 'user',
+  'user/cities': 'user/cities',
+  'user/city': 'user/city',
+  'user/password': 'user/password',
+  'user/role': 'user/role',
+  'users': 'users',
+  'users/cities': 'users/cities',
+  'users/password': 'users/password',
+  'users/role': 'users/role',
+  'venue': 'venue',
+  'venue/city': 'venue/city',
+  'venues': 'venues',
+  'venues/city': 'venues/city',
+})
+
+export const Routes = Object.freeze(Object.values(Route))

package/source/entities/service-routes.js

@@ -0,0 +1,107 @@
+import { Route } from './route.js'
+import { Service } from './service.js'
+
+export const ServiceRoutes = Object.freeze({
+  [Service['Users']]: Object.freeze([
+    Route['user'],
+    Route['user/cities'],
+    Route['user/password'],
+    Route['user/role'],
+    Route['users'],
+    Route['users/cities'],
+    Route['users/role'],
+  ]),
+
+  [Service['Roles']]: Object.freeze([
+    Route['role'],
+    Route['roles'],
+  ]),
+
+  [Service['Checkin']]: Object.freeze([
+    Route['checkin'],
+  ]),
+
+  [Service['Locations']]: Object.freeze([
+    Route['countries'],
+    Route['country'],
+    Route['currencies'],
+    Route['currency'],
+    Route['timezone'],
+    Route['timezones'],
+  ]),
+
+  [Service['Cities']]: Object.freeze([
+    Route['cities'],
+    Route['cities/country'],
+    Route['cities/currency'],
+    Route['cities/timezone'],
+    Route['cities/venues'],
+    Route['city'],
+    Route['city/country'],
+    Route['city/currency'],
+    Route['city/timezone'],
+    Route['city/venues'],
+  ]),
+
+  [Service['Venues']]: Object.freeze([
+    Route['venue'],
+    Route['venue/city'],
+    Route['venues'],
+    Route['venues/city'],
+  ]),
+
+  [Service['Themes']]: Object.freeze([
+    Route['theme'],
+    Route['theme/cover'],
+    Route['themes'],
+    Route['themes/cover'],
+  ]),
+
+  [Service['Games']]: Object.freeze([
+    Route['game'],
+    Route['game/city'],
+    Route['game/registrations'],
+    Route['game/registrations/export'],
+    Route['game/summary'],
+    Route['game/theme'],
+    Route['game/venue'],
+    Route['games'],
+    Route['games/city'],
+    Route['games/registrations'],
+    Route['games/registrations/export'],
+    Route['games/summary'],
+    Route['games/theme'],
+    Route['games/venue'],
+  ]),
+
+  [Service['Registrations']]: Object.freeze([
+    Route['registration'],
+    Route['registration/cancellation'],
+    Route['registration/channel'],
+    Route['registration/confirmation'],
+    Route['registration/city'],
+    Route['registration/game'],
+    Route['registration/mailing'],
+    Route['registrations'],
+    Route['registrations/city'],
+    Route['registrations/game'],
+    Route['registrations/game/theme'],
+    Route['registrations/export'],
+  ]),
+
+  [Service['Files']]: Object.freeze([]),
+
+  [Service['Procedures']]: Object.freeze([]),
+
+  [Service['Integrations']]: Object.freeze([]),
+
+  [Service['Updates']]: Object.freeze([]),
+
+  [Service['Hub']]: Object.freeze([]),
+
+  [Service['Landing']]: Object.freeze([]),
+
+  [Service['Vkma']]: Object.freeze([]),
+
+  [Service['Minio']]: Object.freeze([]),
+})

package/source/entities/service-runtime.js

@@ -0,0 +1,21 @@
+import { Runtime } from './runtime.js'
+import { Service } from './service.js'
+
+export const ServiceRuntime = Object.freeze({
+  [Service['Users']]: Runtime['Deno'],
+  [Service['Roles']]: Runtime['Deno'],
+  [Service['Checkin']]: Runtime['Deno'],
+  [Service['Locations']]: Runtime['Deno'],
+  [Service['Cities']]: Runtime['Deno'],
+  [Service['Venues']]: Runtime['Deno'],
+  [Service['Themes']]: Runtime['Deno'],
+  [Service['Games']]: Runtime['Deno'],
+  [Service['Registrations']]: Runtime['Deno'],
+  [Service['Files']]: Runtime['Bun'],
+  [Service['Procedures']]: Runtime['Bun'],
+  [Service['Integrations']]: Runtime['Bun'],
+  [Service['Updates']]: Runtime['Bun'],
+  [Service['Hub']]: Runtime['Node'],
+  [Service['Landing']]: Runtime['Node'],
+  [Service['Vkma']]: Runtime['Vite'],
+})

package/source/entities/service.js

@@ -0,0 +1,21 @@
+export const Service = Object.freeze({
+  'Users': 'Users',
+  'Roles': 'Roles',
+  'Checkin': 'Checkin',
+  'Locations': 'Locations',
+  'Cities': 'Cities',
+  'Venues': 'Venues',
+  'Themes': 'Themes',
+  'Games': 'Games',
+  'Registrations': 'Registrations',
+  'Files': 'Files',
+  'Procedures': 'Procedures',
+  'Integrations': 'Integrations',
+  'Updates': 'Updates',
+  'Hub': 'Hub',
+  'Landing': 'Landing',
+  'Vkma': 'Vkma',
+  'Minio': 'Minio',
+})
+
+export const Services = Object.freeze(Object.values(Service))

package/source/entities/theme-status.js

@@ -0,0 +1,14 @@
+export const ThemeStatus = Object.freeze({
+  'Active': 'Active',
+  'Archive': 'Archive',
+})
+
+export const ThemeStatuses = Object.freeze([
+  'Active',
+  'Archive',
+])
+
+export const ThemeStatusIcon = Object.freeze({
+  'Active': 'hero/outline/check',
+  'Archive': 'hero/outline/archive-box',
+})

package/source/entities/venue-audience.js

@@ -0,0 +1,14 @@
+export const VenueAudience = Object.freeze({
+  'Open': 'Open',
+  'Adults': 'Adults',
+})
+
+export const VenueAudiences = Object.freeze([
+  'Open',
+  'Adults',
+])
+
+export const VenueAudienceIcon = Object.freeze({
+  'Open': 'hero/outline/lock-open',
+  'Adults': 'hero/outline/lock-closed',
+})

package/source/entities/venue-status.js

@@ -0,0 +1,15 @@
+export const VenueStatus = Object.freeze({
+  'Active': 'Active',
+  'Archive': 'Archive',
+})
+
+export const VenueStatuses = Object.freeze([
+  'Active',
+  'Archive',
+])
+
+/** @satisfies {Record<keyof typeof VenueStatus, string>} */
+export const VenueStatusIcon = Object.freeze({
+  'Active': 'hero/outline/check',
+  'Archive': 'hero/outline/archive-box',
+})

package/source/helpers/hydrate-route-pathname.js

@@ -0,0 +1,32 @@
+import { checkRoute } from '../application/route.js'
+import { inferRouteParams, inferRoutePathname } from '../system/route.js'
+
+export const hydrateRoutePathname = Object.freeze(
+  /**
+   * @template {keyof typeof import('../system/route.js').Route} RouteTemplate
+   *
+   * @param {RouteTemplate} route
+   * @param {any[]} params
+   */
+  (route, params) => {
+    if (!Array.isArray(params))
+      throw TypeError(`Parameter 'params' must be 'Array'.`)
+
+    var $route = checkRoute(route)
+
+    var $routePathname = inferRoutePathname($route)
+
+    if ($routePathname === 'Unknown')
+      throw TypeError(`Could not infer route pathname of: '${$route}'.`)
+
+    var rpm = inferRouteParams($route)
+
+    if (rpm === 'Unknown')
+      throw TypeError(`Could not infer route params of: '${$route}'.`)
+
+    return rpm.reduce(
+      (pathname, param, index) => pathname.replace(param, params[index]),
+      $routePathname,
+    )
+  },
+)

package/source/helpers/string-tag.js

@@ -0,0 +1,7 @@
+export const toStringTag = Object.freeze(
+  x => Object.prototype.toString.call(x).slice(8, -1),
+)
+
+export const isStringTag = Object.freeze(
+  (tag, x) => tag === Object.prototype.toString.call(x).slice(8, -1),
+)

package/source/helpers/tag.js

@@ -0,0 +1,37 @@
+import { inferMethod } from '../system/method.js'
+
+import { hydrateRoutePathname } from './hydrate-route-pathname.js'
+
+export const tag = Object.freeze(
+  /**
+   * @template {keyof typeof import('../system/method.js').Method} MethodTemplate
+   * @template {keyof typeof import('../system/route.js').Route} RouteTemplate
+   * @template {typeof import('../system/route.js').RoutePathname[RouteTemplate]} RoutePathnameTemplate
+   *
+   * @param {MethodTemplate} method
+   * @param {RouteTemplate} route
+   * @param {any[]} params
+   *
+   * @returns {`${MethodTemplate}/${RoutePathnameTemplate}`}
+   */
+  (method, route, params) => {
+    var m = inferMethod(method)
+
+    if (m === 'Unknown')
+      throw TypeError(`Could not infer method of: '${method}'.`)
+
+    return m + '/' + hydrateRoutePathname(route, params)
+  },
+)
+
+export const tagexp = Object.freeze(
+  /**
+   * @template {keyof typeof import('../system/method.js').Method} MethodTemplate
+   * @template {keyof typeof import('../system/route.js').Route} RouteTemplate
+   *
+   * @param {MethodTemplate} method
+   * @param {RouteTemplate} route
+   * @param {any[]} params
+   */
+  (method, route, params) => new RegExp(`^${tag(method, route, params)}$`),
+)

package/source/index.js

@@ -1,38 +1,41 @@
-export * from './enumerations/blend.js'
-export * from './enumerations/cardinality.js'
-export * from './enumerations/category.js'
-export * from './enumerations/constants.js'
-export * from './enumerations/display.js'
-export * from './enumerations/gender.js'
-export * from './enumerations/icon.js'
-export * from './enumerations/method.js'
-export * from './enumerations/mode.js'
-export * from './enumerations/network.js'
-export * from './enumerations/numerosity.js'
-export * from './enumerations/pattern.js'
-export * from './enumerations/phase.js'
-export * from './enumerations/quantifier.js'
-export * from './enumerations/route.js'
-export * from './enumerations/runtime.js'
-export * from './enumerations/service.js'
-
-export * from './enumerations/entities/affilation.js'
-export * from './enumerations/entities/game-status.js'
-export * from './enumerations/entities/registration-attribute.js'
-export * from './enumerations/entities/registration-channel.js'
-export * from './enumerations/entities/registration-mailing.js'
-export * from './enumerations/entities/role.js'
-export * from './enumerations/entities/version.js'
-
-export * from './enumerations/venue/audience.js'
-export * from './enumerations/venue/status.js'
-
-export * from './enumerations/theme/status.js'
-
-export * from './enumerations/registration/lineup.js'
-export * from './enumerations/registration/status.js'
-
-export * from './functions/hydrate-route-params.js'
-export * from './functions/hydrate-route-pathname.js'
-export * from './functions/string-tag.js'
-export * from './functions/tag.js'
+export * from './entities/blend.js'
+export * from './entities/cardinality-routes.js'
+export * from './entities/cardinality.js'
+export * from './entities/category.js'
+export * from './entities/city-affilation.js'
+export * from './entities/city-chatapp-version.js'
+export * from './entities/constants.js'
+export * from './entities/display.js'
+export * from './entities/game-status.js'
+export * from './entities/gender.js'
+export * from './entities/icon.js'
+export * from './entities/method.js'
+export * from './entities/mode.js'
+export * from './entities/network.js'
+export * from './entities/numerosity.js'
+export * from './entities/pattern.js'
+export * from './entities/phase.js'
+export * from './entities/quantifier.js'
+export * from './entities/registration-attribute.js'
+export * from './entities/registration-channel.js'
+export * from './entities/registration-lineup.js'
+export * from './entities/registration-mailing.js'
+export * from './entities/registration-status.js'
+export * from './entities/role.js'
+export * from './entities/route-cardinality-route.js'
+export * from './entities/route-cardinality.js'
+export * from './entities/route-pathname-params.js'
+export * from './entities/route-pathname.js'
+export * from './entities/route-service.js'
+export * from './entities/route.js'
+export * from './entities/runtime.js'
+export * from './entities/service-routes.js'
+export * from './entities/service-runtime.js'
+export * from './entities/service.js'
+export * from './entities/theme-status.js'
+export * from './entities/venue-audience.js'
+export * from './entities/venue-status.js'
+export * from './helpers/hydrate-route-pathname.js'
+export * from './helpers/string-tag.js'
+export * from './helpers/tag.js'
+export * from './prototypes/reflection.js'

package/source/prototypes/reflection.js

@@ -0,0 +1,53 @@
+/**
+ * @template {*} Value
+ *
+ * @param {Value} value
+ */
+export function Relation(value) {
+  this.value = value
+}
+
+/**
+ * @template {*} Value
+ *
+ * @param {Value} value
+ */
+Relation.of = function(value) {
+  return new Relation(value)
+}
+
+/**
+ * @template {keyof Value} Key
+ *
+ * @this {Relation<Value>}
+ *
+ * @param {*} key
+ *
+ * @returns {Value[Key] | 'Unknown'}
+ */
+Relation.prototype.expect = function(key) {
+  if (Object.hasOwn(this.value, key))
+    return this.value[key]
+  else
+    return 'Unknown'
+}
+
+/**
+ * @template {keyof Value} Key
+ *
+ * @this {Relation<Value>}
+ *
+ * @param {*} key
+ *
+ * @returns {Value[Key]}
+ *
+ * @throws {TypeError}
+ */
+Relation.prototype.require = function(key) {
+  if (Object.hasOwn(this.value, key))
+    return this.value[key]
+  else
+    throw TypeError(`Could not require key '${key}' from Relation '${JSON.stringify(this.value)}'.`)
+}
+
+Relation.prototype[Symbol.toStringTag] = 'Relation'

package/source/enumerations/blend.js

@@ -1,11 +0,0 @@
-export const Blend = Object.freeze({
-  'Unset': 'Unset',
-  'Domain': 'Domain',
-  'System': 'System',
-  'Indifferent': 'Indifferent',
-})
-
-export const inferBlend = Object.freeze(
-  /** @returns {typeof Blend[keyof typeof Blend]} */
-  value => Blend[value] ?? 'Unset',
-)

package/source/enumerations/cardinality.js

@@ -1,13 +0,0 @@
-export const Cardinality = Object.freeze({
-  '1': '1',
-  '1-1': '1-1',
-  '1-N': '1-N',
-  'N': 'N',
-  'N-1': 'N-1',
-  'N-N': 'N-N',
-})
-
-export const inferCardinality = Object.freeze(
-  /** @returns {keyof typeof Cardinality | 'Unknown'} */
-  x => Cardinality[x] ?? 'Unknown',
-)

package/source/enumerations/category.js

@@ -1,9 +0,0 @@
-export const Category = Object.freeze({
-  'Active': 'Active',
-  'Rest': 'Rest',
-})
-
-export const CategoryTitle = Object.freeze({
-  [Category['Active']]: 'Активные',
-  [Category['Rest']]: 'Остальное',
-})

package/source/enumerations/entities/affilation.js

@@ -1,29 +0,0 @@
-export const Affilation = Object.freeze({
-  'Branch': 'Branch',
-  'Franchise': 'Franchise',
-})
-
-/** @satisfies {Array<keyof typeof Affilation>} */
-export const Affilations = Object.freeze([
-  'Branch',
-  'Franchise',
-])
-
-/** @satisfies {Record<keyof typeof Affilation, string>} */
-export const AffilationTitle = Object.freeze({
-  'Branch': 'Филиал',
-  'Franchise': 'Франшиза',
-})
-
-/** @satisfies {Record<keyof typeof Affilation, string>} */
-export const AffilationIcon = Object.freeze({
-  'Branch': 'hero/outline/building-office-2',
-  'Franchise': 'hero/outline/building-storefront',
-})
-
-/** @returns {keyof typeof Affilation | 'Unknown'} */
-export const inferAffilation = Object.freeze(value =>
-  Affilation[value?.affilation]
-    ?? Affilation[value]
-    ?? 'Unknown'
-)