@ditojs/server 3.2.4 → 3.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ditojs/server",
-  "version": "3.2.4",
+  "version": "3.2.6",
   "type": "module",
   "description": "Dito.js Server – Dito.js is a declarative and modern web framework, based on Objection.js, Koa.js and Vue.js",
   "repository": "https://github.com/ditojs/dito/tree/main/packages/server",
@@ -24,10 +24,10 @@
     "node >= 18"
   ],
   "dependencies": {
-    "@ditojs/admin": "^3.2.4",
-    "@ditojs/build": "^3.2.0",
-    "@ditojs/router": "^3.2.0",
-    "@ditojs/utils": "^3.2.0",
+    "@ditojs/admin": "^3.2.6",
+    "@ditojs/build": "^3.2.6",
+    "@ditojs/router": "^3.2.6",
+    "@ditojs/utils": "^3.2.6",
     "@koa/cors": "^5.0.0",
     "@koa/etag": "^5.0.2",
     "@koa/multer": "^4.0.0",
@@ -61,7 +61,7 @@
     "picocolors": "^1.1.1",
     "picomatch": "^4.0.7",
     "pino": "^10.4.0",
-    "pino-pretty": "^13.1.3",
+    "pino-pretty": "^13.2.0",
     "pluralize": "^8.0.0",
     "repl": "^0.1.3",
     "type-fest": "^5.10.0",
@@ -89,5 +89,5 @@
     "objection": "^3.1.5",
     "typescript": "^6.0.3"
   },
-  "gitHead": "32147a4ee71f5bca6c051af04be9c15a16f37567"
+  "gitHead": "d9868ae96d60a70b5e7ba89a5fc91e07b267a0d5"
 }

package/types/index.d.ts

@@ -2161,7 +2161,7 @@ export type ControllerActionOptions<
    * }>
    * ```
    */
-  parameters?: { [K in keyof $Params]: Schema<$Params[K]> }
+  parameters?: { [K in keyof $Params]: ParameterSchema<$Params[K]> }
   handler: ControllerActionHandler<$Controller, $Params>
 }
 
@@ -2172,7 +2172,7 @@ export type ModelControllerActionOptions<$ModelController = ModelController> =
      * The handler receives a single parameter object with
      * the same keys.
      */
-    parameters?: { [key: string]: Schema }
+    parameters?: { [key: string]: ParameterSchema }
     /** The function to be called when the action route is requested. */
     handler: ModelControllerActionHandler<$ModelController>
   }
@@ -3160,22 +3160,22 @@ export class QueryBuilder<
   updateById(id: Id, data: PartialModelObject<M>): this
   upsertAndFetch(data: PartialModelObject<M>): this
   insertDitoGraph(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
   insertDitoGraphAndFetch(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
   upsertDitoGraph(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
   upsertDitoGraphAndFetch(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
@@ -3186,12 +3186,12 @@ export class QueryBuilder<
   ): this
 
   updateDitoGraph(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
   updateDitoGraphAndFetch(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
@@ -3202,12 +3202,12 @@ export class QueryBuilder<
   ): this
 
   patchDitoGraph(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
   patchDitoGraphAndFetch(
-    data: PartialDitoModelGraph<M>,
+    data: OrArrayOf<PartialDitoModelGraph<M>>,
     options?: DitoGraphOptions
   ): this
 
@@ -3848,6 +3848,21 @@ export type SelectModelPropertyKeys<T extends Model> = keyof SerializedModel<T>
  * }
  * ```
  */
+/**
+ * The schema of an action parameter, with the source of its value.
+ */
+export type ParameterSchema<$Value = any> = Schema<$Value> & {
+  /**
+   * Where the value of the parameter comes from, instead of the parameters
+   * of the request:
+   * - `'root'`: The whole parameters, e.g. an array in the body.
+   * - `'member'`: The member that a member action is called on.
+   * - `'path'`, `'query'`, `'body'`: The path parameters, the query or the
+   *   body of the request.
+   */
+  from?: 'root' | 'member' | 'path' | 'query' | 'body'
+}
+
 export type Schema<$Value = any> = JSONSchemaType<$Value> & {
   // keywords/_validate.js
   validate?: (params: {