Merge branch 'feature-frontend-clean-architecture-layering-contract' into develop

src/application/create-application.js

@@ -12,10 +12,26 @@
  * }} ports
  */
 export function createApplication(ports) {
+  /**
+   * @param {unknown} query
+   * @param {import("./ports/resource-ports.js").RequestContext} [context]
+   */
+  function queryResources(query, context) {
+    return ports.resources.query.execute(query, context);
+  }
+
+  /**
+   * @param {unknown} command
+   * @param {import("./ports/resource-ports.js").RequestContext} [context]
+   */
+  function commandResources(command, context) {
+    return ports.resources.command.execute(command, context);
+  }
+
   return Object.freeze({
     resources: Object.freeze({
-      query: (query, context) => ports.resources.query.execute(query, context),
+      query: queryResources,
-      command: (command, context) => ports.resources.command.execute(command, context),
+      command: commandResources,
     }),
     cache: ports.cache,
     storage: ports.storage,

src/application/ports/clock-port.js

@@ -5,6 +5,7 @@
  * }} ClockPort
  */
 
+/** @type {ClockPort} */
 export const systemClock = Object.freeze({
   now: () => Date.now(),
   sleep(milliseconds, signal) {

src/application/ports/resource-ports.js

@@ -22,7 +22,7 @@
 /**
  * @template Value
  * @typedef {{ ok: true, value: Value, meta?: Record<string, unknown> } |
- *   { ok: false, error: import("../../contracts/errors.js").ApiFailure }} Result
+ *   { ok: false, error: unknown }} Result
  */
 
 export {};