@shakerquiz/utilities 0.3.5 → 0.3.7

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@shakerquiz/utilities",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "author": "yurkimus <yurkimus@gmail.com>",
   "license": "ISC",
+  "scripts": {
+    "type": "rm -rf ./source/enumerations/*.d.ts && rm -rf ./source/functions/*.d.ts && tsc --allowjs --emitdeclarationonly --declaration ./source/*.js"
+  },
   "exports": {
     ".": {
       "node": "./source/index.js",
@@ -19,5 +22,8 @@
     "@yurkimus/response-status": "0.1.1",
     "@yurkimus/url": "0.2.8",
     "urlpattern-polyfill": "10.0.0"
+  },
+  "devDependencies": {
+    "typescript": "5.8.2"
   }
 }

package/source/enumerations/features.d.ts

@@ -1,5 +1,3 @@
-import { URLOptions } from "@yurkimus/url";
-
 export namespace Features {
     let Checkin: "Checkin";
     let Cities: "Cities";
@@ -23,6 +21,7 @@ export namespace Features {
 }
 export namespace ServiceFeatures {
     export let Admin: ("Checkin" | "Games" | "Users" | "Cities" | "City" | "Countries" | "Country" | "Exception" | "Game" | "Home" | "Region" | "Regions" | "Registration" | "Registrations" | "Theme" | "Themes" | "User" | "Venue" | "Venues")[];
+    export let Backend: ("Checkin" | "Games" | "Users" | "Cities" | "City" | "Game" | "Home" | "Registration" | "Registrations" | "Theme" | "Themes" | "User" | "Venue" | "Venues")[];
     let Games_1: ("Games" | "Game" | "Home" | "Registration" | "Registrations" | "Theme" | "Themes")[];
     export { Games_1 as Games };
     export let Landing: ("Games" | "Exception" | "Game" | "Home" | "Registration")[];
@@ -399,4 +398,4 @@ export const ServiceNetworkOrigins: Map<Service, Map<Network, string>>;
 /**
  * @type {Map<Service, Map<Feature, Map<Network, Nullable<(options?: import('@yurkimus/url').URLOptions) => URL>>>>}
  */
-export const ServiceFeatureNetworkURLs: Map<Service, Map<Feature, Map<Network, Nullable<(options?: URLOptions) => URL>>>>;
+export const ServiceFeatureNetworkURLs: Map<Service, Map<Feature, Map<Network, Nullable<(options?: any) => URL>>>>;

package/source/enumerations/features.js

@@ -49,6 +49,23 @@ export var ServiceFeatures = {
     Features.Venues,
   ],
 
+  [Services.Backend]: [
+    Features.Checkin,
+    Features.Cities,
+    Features.City,
+    Features.Game,
+    Features.Games,
+    Features.Home,
+    Features.Registration,
+    Features.Registrations,
+    Features.Theme,
+    Features.Themes,
+    Features.User,
+    Features.Users,
+    Features.Venue,
+    Features.Venues,
+  ],
+
   [Services.Games]: [
     Features.Game,
     Features.Games,
@@ -308,6 +325,13 @@ export var ServiceNetworkOrigins = new Map([
       [Networks.Public, ''],
     ]),
   ],
+  [
+    Services.Backend,
+    new Map([
+      [Networks.Docker, ''],
+      [Networks.Public, ''],
+    ]),
+  ],
   [
     Services.Games,
     new Map([
@@ -488,6 +512,110 @@ export var ServiceFeatureNetworkURLs = new Map([
     ]),
   ],
 
+  [
+    Services.Admin,
+    new Map([
+      [
+        Features.Checkin,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Cities,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.City,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Game,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Games,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Home,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Registration,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Registrations,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Theme,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Themes,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.User,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Users,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Venue,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+      [
+        Features.Venues,
+        new Map([
+          [Networks.Docker, null],
+          [Networks.Public, null],
+        ]),
+      ],
+    ]),
+  ],
+
   [
     Services.Games,
     new Map([
@@ -556,29 +684,29 @@ export var ServiceFeatureNetworkURLs = new Map([
       [
         Features.Game,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Games,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Home,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Registration,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
     ]),
@@ -590,64 +718,64 @@ export var ServiceFeatureNetworkURLs = new Map([
       [
         Features.Cities,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.City,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Countries,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Country,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Home,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Region,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Regions,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Venue,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Venues,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
     ]),
@@ -666,29 +794,29 @@ export var ServiceFeatureNetworkURLs = new Map([
       [
         Features.Game,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Games,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Home,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Registration,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
     ]),
@@ -700,8 +828,8 @@ export var ServiceFeatureNetworkURLs = new Map([
       [
         Features.Checkin,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
@@ -714,15 +842,15 @@ export var ServiceFeatureNetworkURLs = new Map([
       [
         Features.User,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
       [
         Features.Users,
         new Map([
-          [Networks.Docker, ''],
-          [Networks.Public, ''],
+          [Networks.Docker, null],
+          [Networks.Public, null],
         ]),
       ],
     ]),

package/source/enumerations/services.d.ts

@@ -1,5 +1,6 @@
 export namespace Services {
     let Admin: "Admin";
+    let Backend: "Backend";
     let Games: "Games";
     let Landing: "Landing";
     let Locations: "Locations";

package/source/enumerations/services.js

@@ -3,6 +3,10 @@ export var Services = /** @type {const} */ ({
    * @description Frontend-service representing tools for managing and creating content.
    */
   Admin: 'Admin',
+  /**
+   * @description Legacy backend-service in Python.
+   */
+  Backend: 'Backend',
   /**
    * @description Backend-service manipulating Theme, Game and Registration.
    */

package/source/functions/fetch.d.ts

@@ -4,10 +4,13 @@
 /**
  * @typedef {WeakMap<Function, Map<ExtensionHooks, Set<Function>>>} Extensions
  */
+
+import { URLOptions } from "@yurkimus/url";
+
 /**
  * @type {Extensions}
  */
 export const extensions: Extensions;
-export function useFetch<S extends Service, F extends typeof import("../enumerations/features.js").ServiceFeatures[S][number], N extends Network>(service: S, feature: F, network: N): <M extends RequestMethod = "GET", R extends Role = "default">(options: import('@yurkimus/url').URLOptions | undefined, init: RequestInit) => Promise<FetchResults[S][F][M][R]>;
+export function useFetch<S extends Service, F extends typeof import("../enumerations/features.js").ServiceFeatures[S][number], N extends Network>(service: S, feature: F, network: N): <M extends RequestMethod = "GET", R extends Role = "default">(options: URLOptions | undefined, init: RequestInit) => Promise<FetchResults[S][F][M][R]>;
 export type ExtensionHooks = "onbefore" | "onfulfilled" | "onrejected";
 export type Extensions = WeakMap<Function, Map<ExtensionHooks, Set<Function>>>;

package/source/functions/fetch.js

@@ -52,6 +52,16 @@ var handleMessage = (feature, [response, body]) => {
   }
 }
 
+/**
+ * @param {Function} fetcher
+ * @param {ExtensionHooks} name
+ * @param {any} value
+ */
+var extensionHook = (fetcher, name, value) =>
+  Array
+    .from(extensions.get(fetcher).get(name))
+    .reduce((x, f) => f(x), value)
+
 /**
  * @template {Service} S
  * @template {typeof import('../enumerations/features.js').ServiceFeatures[S][number]} F
@@ -61,7 +71,7 @@ var handleMessage = (feature, [response, body]) => {
  * @param {F} feature
  * @param {N} network
  */
-export var useFetch = (service, feature, network) =>
+export var useFetch = (service, feature, network) => {
   /**
    * @template {RequestMethod} [M='GET']
    * @template {Role} [R='default']
@@ -71,7 +81,7 @@ export var useFetch = (service, feature, network) =>
    *
    * @returns {Promise<FetchResults[S][F][M][R]>}
    */
-  function fetcher(options, init) {
+  var fetcher = (options, init) => {
     if (!(service in Services))
       throw TypeError(
         `Service '${service}' is not listed in 'Services'.`,
@@ -122,15 +132,6 @@ export var useFetch = (service, feature, network) =>
         `Network '${network}' of 'ServiceFeatureNetworkURLs[${service}][${feature}]' has no value.`,
       )
 
-    extensions.set(
-      fetcher,
-      new Map([
-        ['onbefore', new Set([])],
-        ['onfulfilled', new Set([])],
-        ['onrejected', new Set([])],
-      ]),
-    )
-
     var url = ServiceFeatureNetworkURLs
       .get(service)
       .get(feature)
@@ -151,18 +152,13 @@ export var useFetch = (service, feature, network) =>
         'application/json',
       )
 
-    /**
-     * @param {ExtensionHooks} name
-     * @param {any} value
-     */
-    var hook = (name, value) =>
-      Array
-        .from(extensions.get(fetcher).get(name))
-        .reduce((x, f) => f(x), value)
-
     return new Promise((resolve, reject) => {
       try {
-        resolve(hook('onbefore', request))
+        resolve(extensionHook(
+          fetcher,
+          'onbefore',
+          request,
+        ))
       } catch (reason) {
         reject(reason)
       }
@@ -170,6 +166,26 @@ export var useFetch = (service, feature, network) =>
       .then(fetch)
       .then(message.read)
       .then(handleMessage.bind(undefined, feature))
-      .then(hook.bind(undefined, 'onfulfilled'))
-      .catch(hook.bind(undefined, 'onrejected'))
+      .then(extensionHook.bind(
+        undefined,
+        fetcher,
+        'onfulfilled',
+      ))
+      .catch(extensionHook.bind(
+        undefined,
+        fetcher,
+        'onrejected',
+      ))
   }
+
+  extensions.set(
+    fetcher,
+    new Map([
+      ['onbefore', new Set([])],
+      ['onfulfilled', new Set([])],
+      ['onrejected', new Set([])],
+    ]),
+  )
+
+  return fetcher
+}

package/source/functions/origin.js

@@ -28,40 +28,40 @@ export var setServiceNetworkOrigins = origins => {
           `Network '${network}' must be listed in 'Networks'.`,
         )
 
-      for (var origin in origins[service][network]) {
-        ServiceNetworkOrigins
-          .get(service)
-          .set(network, origin)
+      var origin = origins[service][network]
+
+      ServiceNetworkOrigins
+        .get(service)
+        .set(network, origin)
 
-        for (var feature of ServiceFeatures[service]) {
-          if (!(feature in Features))
-            throw TypeError(
-              `Feature '${feature}' must be listed in 'Features'.`,
-            )
+      for (var feature of ServiceFeatures[service]) {
+        if (!(feature in Features))
+          throw TypeError(
+            `Feature '${feature}' must be listed in 'Features'.`,
+          )
 
-          if (!(feature in FeaturePathnames))
-            throw TypeError(
-              `Feature '${feature}' must be listed in 'FeaturePathnames'.`,
-            )
+        if (!(feature in FeaturePathnames))
+          throw TypeError(
+            `Feature '${feature}' must be listed in 'FeaturePathnames'.`,
+          )
 
-          if (!ServiceFeatureNetworkURLs.has(service))
-            throw TypeError(
-              `Service '${service}' must be listed in 'ServiceFeatureNetworkURLs'.`,
-            )
+        if (!ServiceFeatureNetworkURLs.has(service))
+          throw TypeError(
+            `Service '${service}' must be listed in 'ServiceFeatureNetworkURLs'.`,
+          )
 
-          if (!ServiceFeatureNetworkURLs.get(service).has(feature))
-            throw TypeError(
-              `Feature '${feature}' must be listed in 'ServiceFeatureNetworkURLs[${service}]'.`,
-            )
+        if (!ServiceFeatureNetworkURLs.get(service).has(feature))
+          throw TypeError(
+            `Feature '${feature}' must be listed in 'ServiceFeatureNetworkURLs[${service}]'.`,
+          )
 
-          ServiceFeatureNetworkURLs
-            .get(service)
-            .get(feature)
-            .set(
-              network,
-              url.bind(undefined, origin, FeaturePathnames[feature]),
-            )
-        }
+        ServiceFeatureNetworkURLs
+          .get(service)
+          .get(feature)
+          .set(
+            network,
+            url.bind(undefined, origin, FeaturePathnames[feature]),
+          )
       }
     }
   }