@hozu/cli 0.11.0 → 0.13.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
     },
@@ -284,7 +306,11 @@
         "HZ079",
         "HZ080",
         "HZ081",
-        "HZ082"
+        "HZ082",
+        "HZ083",
+        "HZ084",
+        "HZ085",
+        "HZ086"
       ]
     },
     "Severity": {

package/schema/env.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/EnvOutput",
+  "definitions": {
+    "EnvOutput": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "project({ env: { files } })."
+        },
+        "read": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The files that existed and were read."
+        },
+        "variables": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EnvVariable"
+          }
+        },
+        "reserved": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "purpose": {
+                "type": "string"
+              },
+              "set": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "name",
+              "purpose",
+              "set"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "example": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "`.env.example` when --example wrote it."
+        }
+      },
+      "required": [
+        "files",
+        "read",
+        "variables",
+        "reserved",
+        "example"
+      ],
+      "additionalProperties": false,
+      "description": "`hozu env` (ADR 0052)."
+    },
+    "EnvVariable": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "side": {
+          "type": "string",
+          "enum": [
+            "server",
+            "public"
+          ]
+        },
+        "required": {
+          "type": "boolean",
+          "description": "No default, so startup refuses without it."
+        },
+        "default": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "set": {
+          "type": "boolean",
+          "description": "Set now: in the shell or one of the env files."
+        },
+        "description": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "internal": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "A public variable: the server variable with its internal URL; a server one: the public variable it serves."
+        }
+      },
+      "required": [
+        "name",
+        "side",
+        "required",
+        "default",
+        "set",
+        "description",
+        "internal"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

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": {
@@ -261,6 +303,13 @@
             }
           ],
           "description": "The feature's `fetch.ts` (ADR 0049): implementations of its `'either'` / `'browser'` effects."
+        },
+        "connect": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ConnectIR"
+          },
+          "description": "The origins its browser-run effects call, added to CSP `connect-src` (ADR 0051)."
         }
       },
       "required": [
@@ -280,7 +329,8 @@
         "endpoints",
         "contracts",
         "messages",
-        "fetch"
+        "fetch",
+        "connect"
       ],
       "additionalProperties": false
     },
@@ -785,15 +835,6 @@
       ],
       "additionalProperties": false
     },
-    "Runs": {
-      "type": "string",
-      "enum": [
-        "server",
-        "browser",
-        "either"
-      ],
-      "description": "What an effect's implementation needs (ADR 0049): server secrets, browser credentials, or neither."
-    },
     "MutationIR": {
       "type": "object",
       "properties": {
@@ -1966,6 +2007,35 @@
       ],
       "additionalProperties": false
     },
+    "ConnectIR": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "origin": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "origin"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "env": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "env"
+          ],
+          "additionalProperties": false
+        }
+      ],
+      "description": "An origin (`https://api.github.com`) or a public env variable holding a URL."
+    },
     "InspectComponentOutput": {
       "type": "object",
       "properties": {

package/schema/migrate.schema.json

@@ -236,13 +236,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
     },
@@ -481,7 +503,11 @@
         "HZ079",
         "HZ080",
         "HZ081",
-        "HZ082"
+        "HZ082",
+        "HZ083",
+        "HZ084",
+        "HZ085",
+        "HZ086"
       ]
     },
     "Severity": {

package/schema/render.schema.json

@@ -165,7 +165,11 @@
         "HZ079",
         "HZ080",
         "HZ081",
-        "HZ082"
+        "HZ082",
+        "HZ083",
+        "HZ084",
+        "HZ085",
+        "HZ086"
       ]
     },
     "Severity": {

package/schema/validate.schema.json

@@ -209,7 +209,11 @@
         "HZ079",
         "HZ080",
         "HZ081",
-        "HZ082"
+        "HZ082",
+        "HZ083",
+        "HZ084",
+        "HZ085",
+        "HZ086"
       ]
     },
     "Severity": {

package/dist/commands/add-widget.d.ts

@@ -1,5 +0,0 @@
-import type { AddOutput } from '../contract.ts';
-export declare const bundleSpec: (core: string | undefined) => string;
-export declare function runAddWidget(cwd: string, config: string | undefined, feature: string | undefined, name: string | undefined): Promise<AddOutput>;
-export declare function describeAddWidget(out: AddOutput, name: string): string;
-//# sourceMappingURL=add-widget.d.ts.map

package/dist/commands/add-widget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-widget.d.ts","sourceRoot":"","sources":["../../src/commands/add-widget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAuB/C,eAAO,MAAM,UAAU,SAAU,MAAM,GAAG,SAAS,WAC2D,CAAA;AAE9G,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAAC,SAAS,CAAC,CAiFpB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtE"}