@seljs/env 1.0.0 → 1.0.1

package/dist/builtins.mjs

@@ -0,0 +1,371 @@
+import { SOLIDITY_TYPES } from "@seljs/types";
+//#region src/builtins.ts
+/**
+* Built-in CEL functions available in SEL expressions.
+* These functions are part of the CEL standard library.
+*/
+const CEL_BUILTIN_FUNCTIONS = [
+	{
+		name: "size",
+		signature: "size(list|map|string|bytes): int",
+		description: "Returns the size of a collection or string",
+		params: [{
+			name: "value",
+			type: "list|map|string|bytes"
+		}],
+		returns: "int"
+	},
+	{
+		name: "size",
+		signature: "string.size(): int",
+		description: "Returns the length of the string",
+		params: [],
+		returns: "int",
+		receiverType: "string"
+	},
+	{
+		name: "size",
+		signature: "list.size(): int",
+		description: "Returns the number of elements in the list",
+		params: [],
+		returns: "int",
+		receiverType: "list"
+	},
+	{
+		name: "size",
+		signature: "map.size(): int",
+		description: "Returns the number of entries in the map",
+		params: [],
+		returns: "int",
+		receiverType: "map"
+	},
+	{
+		name: "size",
+		signature: "bytes.size(): int",
+		description: "Returns the number of bytes",
+		params: [],
+		returns: "int",
+		receiverType: "bytes"
+	},
+	{
+		name: "type",
+		signature: "type(value): type",
+		description: "Returns the type of a value",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "type"
+	},
+	{
+		name: "int",
+		signature: "int(value): int",
+		description: "Converts a value to an integer",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "int"
+	},
+	{
+		name: "uint",
+		signature: "uint(value): uint",
+		description: "Converts a value to an unsigned integer",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "uint"
+	},
+	{
+		name: "double",
+		signature: "double(value): double",
+		description: "Converts a value to a double",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "double"
+	},
+	{
+		name: "string",
+		signature: "string(value): string",
+		description: "Converts a value to a string",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "string"
+	},
+	{
+		name: "bytes",
+		signature: "bytes(value): bytes",
+		description: "Converts a value to bytes",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "bytes"
+	},
+	{
+		name: "dyn",
+		signature: "dyn(value): dyn",
+		description: "Converts a value to a dynamic type",
+		params: [{
+			name: "value",
+			type: "any"
+		}],
+		returns: "dyn"
+	},
+	{
+		name: "bool",
+		signature: "bool(value): bool",
+		description: "Converts a value to a boolean",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "bool"
+	},
+	{
+		name: "solInt",
+		signature: "solInt(string): sol_int",
+		description: "Converts a string or int to a sol_int (arbitrary-precision integer)",
+		params: [{
+			name: "value",
+			type: "string|int"
+		}],
+		returns: "sol_int"
+	},
+	{
+		name: "solAddress",
+		signature: "solAddress(string): sol_address",
+		description: "Converts a hex string to a sol_address type",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "sol_address"
+	},
+	{
+		name: "parseUnits",
+		signature: "parseUnits(string|int|double|sol_int, int): sol_int",
+		description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits.",
+		params: [{
+			name: "value",
+			type: "string|int|double|sol_int"
+		}, {
+			name: "decimals",
+			type: "int"
+		}],
+		returns: "sol_int"
+	},
+	{
+		name: "formatUnits",
+		signature: "formatUnits(sol_int|int, int): double",
+		description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons.",
+		params: [{
+			name: "value",
+			type: "sol_int|int"
+		}, {
+			name: "decimals",
+			type: "int"
+		}],
+		returns: "double"
+	},
+	{
+		name: "min",
+		signature: "min(sol_int|int, sol_int|int): sol_int",
+		description: "Returns the smaller of two integer values",
+		params: [{
+			name: "a",
+			type: "sol_int|int"
+		}, {
+			name: "b",
+			type: "sol_int|int"
+		}],
+		returns: "sol_int"
+	},
+	{
+		name: "max",
+		signature: "max(sol_int|int, sol_int|int): sol_int",
+		description: "Returns the larger of two integer values",
+		params: [{
+			name: "a",
+			type: "sol_int|int"
+		}, {
+			name: "b",
+			type: "sol_int|int"
+		}],
+		returns: "sol_int"
+	},
+	{
+		name: "abs",
+		signature: "abs(sol_int|int): sol_int",
+		description: "Returns the absolute value of an integer",
+		params: [{
+			name: "value",
+			type: "sol_int|int"
+		}],
+		returns: "sol_int"
+	},
+	{
+		name: "isZeroAddress",
+		signature: "isZeroAddress(sol_address|string): bool",
+		description: "Returns true if the address is the zero address (0x0000...0000)",
+		params: [{
+			name: "address",
+			type: "sol_address|string"
+		}],
+		returns: "bool"
+	},
+	{
+		name: "timestamp",
+		signature: "timestamp(string): timestamp",
+		description: "Parses a timestamp string",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "timestamp"
+	},
+	{
+		name: "duration",
+		signature: "duration(string): duration",
+		description: "Parses a duration string",
+		params: [{
+			name: "value",
+			type: "string"
+		}],
+		returns: "duration"
+	},
+	{
+		name: "matches",
+		signature: "string.matches(pattern): bool",
+		description: "Tests if a string matches a regex pattern",
+		params: [{
+			name: "pattern",
+			type: "string"
+		}],
+		returns: "bool",
+		receiverType: "string"
+	},
+	{
+		name: "contains",
+		signature: "string.contains(substring): bool",
+		description: "Tests if a string contains a substring",
+		params: [{
+			name: "substring",
+			type: "string"
+		}],
+		returns: "bool",
+		receiverType: "string"
+	},
+	{
+		name: "startsWith",
+		signature: "string.startsWith(prefix): bool",
+		description: "Tests if a string starts with a prefix",
+		params: [{
+			name: "prefix",
+			type: "string"
+		}],
+		returns: "bool",
+		receiverType: "string"
+	},
+	{
+		name: "endsWith",
+		signature: "string.endsWith(suffix): bool",
+		description: "Tests if a string ends with a suffix",
+		params: [{
+			name: "suffix",
+			type: "string"
+		}],
+		returns: "bool",
+		receiverType: "string"
+	}
+];
+/**
+* Built-in CEL macros available in SEL expressions.
+* Macros are syntactic sugar that expand to function calls.
+*/
+const CEL_BUILTIN_MACROS = [
+	{
+		name: "all",
+		pattern: "list.all(identifier, predicate)",
+		description: "Returns true if all elements satisfy the predicate",
+		example: "tokens.all(t, t.balance > 0)"
+	},
+	{
+		name: "exists",
+		pattern: "list.exists(identifier, predicate)",
+		description: "Returns true if any element satisfies the predicate",
+		example: "users.exists(u, u.isAdmin)"
+	},
+	{
+		name: "exists_one",
+		pattern: "list.exists_one(identifier, predicate)",
+		description: "Returns true if exactly one element satisfies the predicate",
+		example: "tokens.exists_one(t, t.id == 123)"
+	},
+	{
+		name: "map",
+		pattern: "list.map(identifier, transform)",
+		description: "Transforms each element in the list",
+		example: "tokens.map(t, t.balance)"
+	},
+	{
+		name: "map",
+		pattern: "list.map(identifier, predicate, transform)",
+		description: "Transforms elements that satisfy the predicate",
+		example: "tokens.map(t, t.balance > 0, t.balance)"
+	},
+	{
+		name: "filter",
+		pattern: "list.filter(identifier, predicate)",
+		description: "Filters elements by predicate",
+		example: "users.filter(u, u.age >= 18)"
+	},
+	{
+		name: "has",
+		pattern: "has(e.f)",
+		description: "Tests if a field exists on an object",
+		example: "has(user.email)"
+	},
+	{
+		name: "cel.bind",
+		pattern: "cel.bind(var, value, expr)",
+		description: "Binds a variable for use in an expression",
+		example: "cel.bind(x, user.balance, x > 1000)"
+	}
+];
+/**
+* Primitive types from Solidity available in SEL.
+* These are the basic type building blocks for the schema.
+*/
+const SOLIDITY_PRIMITIVE_TYPES = [
+	...SOLIDITY_TYPES.map((it) => {
+		if (it.type !== "custom") return null;
+		return {
+			name: it.name,
+			kind: "primitive",
+			description: it.schema.description
+		};
+	}).filter((it) => it !== null),
+	{
+		name: "bool",
+		kind: "primitive",
+		description: "Boolean value (true or false)"
+	},
+	{
+		name: "string",
+		kind: "primitive",
+		description: "UTF-8 string"
+	},
+	{
+		name: "bytes32",
+		kind: "primitive",
+		description: "32-byte fixed array"
+	}
+];
+//#endregion
+export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES };

package/dist/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_builtins = require("./builtins.cjs");
+const require_builder = require("./builder.cjs");
+exports.CEL_BUILTIN_FUNCTIONS = require_builtins.CEL_BUILTIN_FUNCTIONS;
+exports.CEL_BUILTIN_MACROS = require_builtins.CEL_BUILTIN_MACROS;
+exports.SOLIDITY_PRIMITIVE_TYPES = require_builtins.SOLIDITY_PRIMITIVE_TYPES;
+exports.buildSchema = require_builder.buildSchema;
+exports.buildStructFields = require_builder.buildStructFields;

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+import { BuildStructFieldsResult, ContractInput, SchemaBuilderConfig, StructTypeDefinition, buildSchema, buildStructFields } from "./builder.cjs";
+import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.cjs";
+export { BuildStructFieldsResult, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, StructTypeDefinition, buildSchema, buildStructFields };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+import { BuildStructFieldsResult, ContractInput, SchemaBuilderConfig, StructTypeDefinition, buildSchema, buildStructFields } from "./builder.mjs";
+import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
+export { BuildStructFieldsResult, CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, ContractInput, SOLIDITY_PRIMITIVE_TYPES, SchemaBuilderConfig, StructTypeDefinition, buildSchema, buildStructFields };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES } from "./builtins.mjs";
+import { buildSchema, buildStructFields } from "./builder.mjs";
+export { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES, buildSchema, buildStructFields };

package/package.json

@@ -1,30 +1,36 @@
 {
   "name": "@seljs/env",
-  "version": "1.0.0",
+  "version": "1.0.1",
+  "repository": {
+    "url": "https://github.com/abinnovision/seljs"
+  },
   "license": "Apache-2.0",
   "author": {
     "name": "abi group GmbH",
     "email": "info@abigroup.io",
     "url": "https://abigroup.io/"
   },
-  "repository": {
-    "url": "https://github.com/abinnovision/seljs"
-  },
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
   "files": [
     "dist",
     "LICENSE.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsdown",
     "format:check": "prettier --check '{{src,test}/**/*,*}.{{t,j}s{,x},json{,5},md,y{,a}ml}'",
     "format:fix": "prettier --write '{{src,test}/**/*,*}.{{t,j}s{,x},json{,5},md,y{,a}ml}'",
     "lint:check": "eslint '{{src,test}/**/*,*}.{t,j}s{,x}'",
@@ -42,9 +48,9 @@
     ]
   },
   "dependencies": {
-    "@seljs/common": "1.0.0",
-    "@seljs/schema": "1.0.0",
-    "@seljs/types": "1.0.0",
+    "@seljs/common": "1.0.1",
+    "@seljs/schema": "1.0.1",
+    "@seljs/types": "1.0.1",
     "abitype": "^1.2.3",
     "viem": "^2.47.2"
   },
@@ -54,6 +60,7 @@
     "@seljs-internal/tsconfig": "^0.0.0",
     "eslint": "^9.39.4",
     "prettier": "^3.8.1",
+    "tsdown": "^0.21.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },

package/dist/builder.d.ts

@@ -1,36 +0,0 @@
-import type { SELSchema } from "@seljs/schema";
-import type { ContextDefinition } from "@seljs/types";
-import type { AbiParameter } from "abitype";
-import type { Abi, Address } from "viem";
-export interface StructTypeDefinition {
-    typeName: string;
-    fields: Record<string, string>;
-}
-export interface BuildStructFieldsResult {
-    fields: Record<string, string>;
-    nestedTypes: StructTypeDefinition[];
-}
-/**
- * Recursively builds struct field definitions.
- *
- * @param components Array of ABI parameters representing the components of a tuple type.
- * @param parentTypeName Name to use for the struct type representing the current level of nesting.
- */
-export declare const buildStructFields: (components: readonly AbiParameter[], parentTypeName: string) => BuildStructFieldsResult;
-export interface ContractInput {
-    address: Address;
-    abi: Abi;
-    description?: string;
-}
-export interface SchemaBuilderConfig {
-    contracts?: Record<string, ContractInput>;
-    context?: ContextDefinition;
-}
-/**
- * Builds a SELSchema based on the provided configuration, which includes contract definitions and an optional context for variables.
- *
- * @param config Configuration object containing contract definitions and an optional context for variables.
- * @returns A SELSchema object representing the schema for the SEL environment.
- */
-export declare const buildSchema: (config: SchemaBuilderConfig) => SELSchema;
-//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGX,SAAS,EAGT,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEX,iBAAiB,EAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAe,OAAO,EAAE,MAAM,MAAM,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAiDD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,YAAY,SAAS,YAAY,EAAE,EACnC,gBAAgB,MAAM,KACpB,uBAiCF,CAAC;AAoMF,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,mBAAmB,KAAG,SAezD,CAAC"}