envio 3.0.0-alpha.21 → 3.0.0-alpha.23

package/README.md

@@ -107,9 +107,9 @@ This scaffolds your entire indexer project, config, schema, and handler function
 
 From there, three files define your indexer:
 
-- `config.yaml` — networks, contracts, events, and indexing behaviour
-- `schema.graphql` — the shape of your indexed data
-- `src/EventHandlers.*` — your handler logic in TypeScript, JavaScript, or ReScript
+- `config.yaml`: networks, contracts, events, and indexing behaviour
+- `schema.graphql`: the shape of your indexed data
+- `src/EventHandlers.*`: your handler logic in TypeScript, JavaScript, or ReScript
 
 [Full getting started guide →](https://docs.envio.dev/docs/HyperIndex/getting-started)
 

package/bin.mjs

@@ -1,49 +1,3 @@
 #!/usr/bin/env node
-//@ts-check
-
-import { spawnSync } from "child_process";
-import { createRequire } from "module";
-
-const require = createRequire(import.meta.url);
-
-/**
- * Returns the executable path for envio located inside node_modules.
- * The naming convention is envio-${os}-${arch}
- * @see https://nodejs.org/api/os.html#osarch
- * @see https://nodejs.org/api/os.html#osplatform
- * @example "x/xx/node_modules/envio-darwin-arm64"
- */
-function getExePath() {
-  const pkg = `envio-${process.platform}-${process.arch}`;
-  const bin = "bin/envio";
-
-  try {
-    return require.resolve(`${pkg}/${bin}`);
-  } catch {}
-
-  throw new Error(
-    `Couldn't find envio binary package "${pkg}".\n` +
-      `Checked: require.resolve("${pkg}/${bin}")\n` +
-      `If you're using pnpm, yarn, or npm with --omit=optional, ensure optional ` +
-      `dependencies are installed:\n` +
-      `  npm install ${pkg}\n`
-  );
-}
-
-/**
- * Runs `envio` with args using nodejs spawn
- */
-function runEnvio() {
-  const args = process.argv.slice(2);
-  const exePath = getExePath();
-
-  const processResult = spawnSync(exePath, args, { stdio: "inherit" });
-
-  if (processResult.error) {
-    console.error(`Failed to run envio binary at ${exePath}: ${processResult.error.message}`);
-    process.exit(1);
-  }
-  process.exit(processResult.status ?? 1);
-}
-
-runEnvio();
+import { run } from "./src/Bin.res.mjs";
+await run(process.argv.slice(2));

package/evm.schema.json

@@ -45,6 +45,17 @@
       "format": "uint64",
       "minimum": 0
     },
+    "storage": {
+      "description": "Configuration for the storage backends the indexer writes to. Defaults to `postgres: true` when omitted. ClickHouse requires Postgres to be enabled (it is not supported as a single storage yet), and at least one backend must be enabled.",
+      "anyOf": [
+        {
+          "$ref": "#/$defs/StorageConfig"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
     "ecosystem": {
       "description": "Ecosystem of the project.",
       "anyOf": [
@@ -123,6 +134,62 @@
     "chains"
   ],
   "$defs": {
+    "StorageConfig": {
+      "type": "object",
+      "properties": {
+        "postgres": {
+          "description": "Whether to use Postgres as a storage backend (default: true).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "clickhouse": {
+          "description": "Whether to additionally sync the indexed data to ClickHouse. Requires Postgres to be enabled (default: false).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "not": {
+            "properties": {
+              "postgres": {
+                "const": false
+              }
+            },
+            "required": [
+              "postgres"
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "clickhouse": {
+                "const": true
+              }
+            },
+            "required": [
+              "clickhouse"
+            ]
+          },
+          "then": {
+            "properties": {
+              "postgres": {
+                "const": true
+              }
+            },
+            "required": [
+              "postgres"
+            ]
+          }
+        }
+      ]
+    },
     "EcosystemTag": {
       "type": "string",
       "enum": [

package/fuel.schema.json

@@ -45,6 +45,17 @@
       "format": "uint64",
       "minimum": 0
     },
+    "storage": {
+      "description": "Configuration for the storage backends the indexer writes to. Defaults to `postgres: true` when omitted. ClickHouse requires Postgres to be enabled (it is not supported as a single storage yet), and at least one backend must be enabled.",
+      "anyOf": [
+        {
+          "$ref": "#/$defs/StorageConfig"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
     "ecosystem": {
       "description": "Ecosystem of the project.",
       "$ref": "#/$defs/EcosystemTag"
@@ -81,6 +92,62 @@
     "chains"
   ],
   "$defs": {
+    "StorageConfig": {
+      "type": "object",
+      "properties": {
+        "postgres": {
+          "description": "Whether to use Postgres as a storage backend (default: true).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "clickhouse": {
+          "description": "Whether to additionally sync the indexed data to ClickHouse. Requires Postgres to be enabled (default: false).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "not": {
+            "properties": {
+              "postgres": {
+                "const": false
+              }
+            },
+            "required": [
+              "postgres"
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "clickhouse": {
+                "const": true
+              }
+            },
+            "required": [
+              "clickhouse"
+            ]
+          },
+          "then": {
+            "properties": {
+              "postgres": {
+                "const": true
+              }
+            },
+            "required": [
+              "postgres"
+            ]
+          }
+        }
+      ]
+    },
     "EcosystemTag": {
       "type": "string",
       "enum": [