@hozu/cli 0.10.0 → 0.12.0

package/schema/call.schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/CallOutput",
+  "definitions": {
+    "CallOutput": {
+      "type": "object",
+      "properties": {
+        "effect": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "query",
+            "mutation"
+          ]
+        },
+        "runs": {
+          "$ref": "#/definitions/Runs"
+        },
+        "input": {
+          "$ref": "#/definitions/Json"
+        },
+        "result": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "ok": {
+                  "type": "boolean",
+                  "const": true
+                },
+                "value": {
+                  "$ref": "#/definitions/Json"
+                }
+              },
+              "required": [
+                "ok",
+                "value"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "ok": {
+                  "type": "boolean",
+                  "const": false
+                },
+                "error": {
+                  "type": "string"
+                },
+                "data": {
+                  "$ref": "#/definitions/Json"
+                }
+              },
+              "required": [
+                "ok",
+                "error",
+                "data"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "ms": {
+          "type": "number",
+          "description": "Milliseconds for the request."
+        },
+        "invalidated": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Tags a mutation invalidated."
+        },
+        "refreshes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The queries those tags refresh."
+        }
+      },
+      "required": [
+        "effect",
+        "kind",
+        "runs",
+        "input",
+        "result",
+        "ms",
+        "invalidated",
+        "refreshes"
+      ],
+      "additionalProperties": false,
+      "description": "`hozu call` (ADR 0050 F): one query or mutation through the app's handler."
+    },
+    "Runs": {
+      "type": "string",
+      "enum": [
+        "server",
+        "browser",
+        "either"
+      ],
+      "description": "What an effect's implementation needs (ADR 0049): server secrets, browser credentials, or neither."
+    },
+    "Json": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Json"
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/Json"
+          }
+        }
+      ]
+    }
+  }
+}

package/schema/check.schema.json

@@ -39,13 +39,35 @@
           "items": {
             "$ref": "#/definitions/CheckOverrides"
           }
+        },
+        "timings": {
+          "type": "object",
+          "properties": {
+            "types": {
+              "type": "number"
+            },
+            "load": {
+              "type": "number"
+            },
+            "validate": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "types",
+            "load",
+            "validate"
+          ],
+          "additionalProperties": false,
+          "description": "Milliseconds; the type check runs in parallel with loading and validating (ADR 0050 D)."
         }
       },
       "required": [
         "ok",
         "types",
         "validate",
-        "overrides"
+        "overrides",
+        "timings"
       ],
       "additionalProperties": false
     },
@@ -282,7 +304,9 @@
         "HZ077",
         "HZ078",
         "HZ079",
-        "HZ080"
+        "HZ080",
+        "HZ081",
+        "HZ082"
       ]
     },
     "Severity": {

package/schema/explain.schema.json

@@ -33,12 +33,16 @@
                   "items": {
                     "type": "string"
                   }
+                },
+                "runs": {
+                  "$ref": "#/definitions/Runs"
                 }
               },
               "required": [
                 "effect",
                 "input",
-                "errors"
+                "errors",
+                "runs"
               ],
               "additionalProperties": false
             },
@@ -78,6 +82,15 @@
       ],
       "additionalProperties": false
     },
+    "Runs": {
+      "type": "string",
+      "enum": [
+        "server",
+        "browser",
+        "either"
+      ],
+      "description": "What an effect's implementation needs (ADR 0049): server secrets, browser credentials, or neither."
+    },
     "ExplainTransition": {
       "type": "object",
       "properties": {

package/schema/impact.schema.json

@@ -50,6 +50,17 @@
           "items": {
             "type": "string"
           }
+        },
+        "runs": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Runs"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Where a query or mutation runs (ADR 0049); null for other symbols."
         }
       },
       "required": [
@@ -59,7 +70,8 @@
         "queries",
         "invalidatedBy",
         "uses",
-        "features"
+        "features",
+        "runs"
       ],
       "additionalProperties": false
     },
@@ -118,6 +130,15 @@
       ],
       "additionalProperties": false
     },
+    "Runs": {
+      "type": "string",
+      "enum": [
+        "server",
+        "browser",
+        "either"
+      ],
+      "description": "What an effect's implementation needs (ADR 0049): server secrets, browser credentials, or neither."
+    },
     "ComponentImpact": {
       "type": "object",
       "properties": {

package/schema/inspect.schema.json

@@ -71,6 +71,38 @@
         },
         "exports": {
           "$ref": "#/definitions/ExportsIR"
+        },
+        "effects": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "query",
+                  "mutation"
+                ]
+              },
+              "runs": {
+                "$ref": "#/definitions/Runs"
+              },
+              "implemented": {
+                "type": "string",
+                "enum": [
+                  "resolver",
+                  "fetch.ts"
+                ]
+              }
+            },
+            "required": [
+              "kind",
+              "runs",
+              "implemented"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Each query and mutation: where it runs and where it is implemented (ADR 0049)."
         }
       },
       "required": [
@@ -83,7 +115,8 @@
         "contracts",
         "hydrates",
         "imports",
-        "exports"
+        "exports",
+        "effects"
       ],
       "additionalProperties": false
     },
@@ -144,6 +177,15 @@
       ],
       "additionalProperties": false
     },
+    "Runs": {
+      "type": "string",
+      "enum": [
+        "server",
+        "browser",
+        "either"
+      ],
+      "description": "What an effect's implementation needs (ADR 0049): server secrets, browser credentials, or neither."
+    },
     "FeatureIR": {
       "type": "object",
       "properties": {
@@ -241,6 +283,26 @@
               "type": "null"
             }
           ]
+        },
+        "fetch": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "sourceHash": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "sourceHash"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The feature's `fetch.ts` (ADR 0049): implementations of its `'either'` / `'browser'` effects."
         }
       },
       "required": [
@@ -259,7 +321,8 @@
         "components",
         "endpoints",
         "contracts",
-        "messages"
+        "messages",
+        "fetch"
       ],
       "additionalProperties": false
     },
@@ -369,6 +432,9 @@
           "items": {
             "$ref": "#/definitions/TagExprIR"
           }
+        },
+        "runs": {
+          "$ref": "#/definitions/Runs"
         }
       },
       "required": [
@@ -377,7 +443,8 @@
         "errors",
         "scope",
         "freshness",
-        "tags"
+        "tags",
+        "runs"
       ],
       "additionalProperties": false
     },
@@ -780,13 +847,17 @@
           "items": {
             "$ref": "#/definitions/TagExprIR"
           }
+        },
+        "runs": {
+          "$ref": "#/definitions/Runs"
         }
       },
       "required": [
         "input",
         "output",
         "errors",
-        "invalidates"
+        "invalidates",
+        "runs"
       ],
       "additionalProperties": false
     },

package/schema/map.schema.json

@@ -165,6 +165,10 @@
                   "type": "string"
                 }
               },
+              "runs": {
+                "type": "string",
+                "description": "Where it runs (ADR 0049): 'server', 'browser' or 'either'."
+              },
               "at": {
                 "type": [
                   "string",
@@ -178,6 +182,7 @@
               "freshness",
               "errors",
               "tags",
+              "runs",
               "at"
             ],
             "additionalProperties": false
@@ -203,6 +208,9 @@
                   "type": "string"
                 }
               },
+              "runs": {
+                "type": "string"
+              },
               "at": {
                 "type": [
                   "string",
@@ -214,11 +222,19 @@
               "name",
               "errors",
               "invalidates",
+              "runs",
               "at"
             ],
             "additionalProperties": false
           }
         },
+        "fetch": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "The feature's fetch.ts (ADR 0049), when it has one."
+        },
         "endpoints": {
           "type": "array",
           "items": {
@@ -374,6 +390,7 @@
         "id",
         "queries",
         "mutations",
+        "fetch",
         "endpoints",
         "events",
         "fns",