add cause in errors thrown by asserts, closes #2729 (#2738)

.changeset/fifty-clocks-fail.md

@@ -0,0 +1,5 @@
+---
+"@effect/schema": patch
+---
+
+add `cause` in errors thrown by `asserts`, closes #2729

packages/schema/src/ParseResult.ts

@@ -731,7 +731,7 @@ export const asserts = <A, I, R>(schema: Schema.Schema<A, I, R>, options?: AST.P
       isExact: true
     }) as any
     if (Either.isLeft(result)) {
-      throw new Error(TreeFormatter.formatIssueSync(result.left))
+      throw new Error(TreeFormatter.formatIssueSync(result.left), { cause: result.left })
     }
   }
 }

packages/schema/test/Schema/asserts.test.ts

@@ -11,6 +11,15 @@ const expectAssertsFailure = <A, I>(schema: S.Schema<A, I>, input: unknown, mess
 }
 
 describe("asserts", () => {
+  it("the returned error should include a cause", () => {
+    const asserts: (u: unknown) => asserts u is string = S.asserts(S.String)
+    try {
+      asserts(1)
+    } catch (e: any) {
+      expect(e.cause).exist
+    }
+  })
+
   it("should respect outer/inner options", () => {
     const schema = S.Struct({ a: Util.NumberFromChar })
     const input = { a: 1, b: "b" }

packages/schema/test/Schema/decodeUnknownSync.test.ts

@@ -3,6 +3,14 @@ import * as Util from "@effect/schema/test/TestUtils"
 import { describe, expect, it } from "vitest"
 
 describe("decodeUnknownSync", () => {
+  it("the returned error should include a cause", () => {
+    try {
+      S.decodeUnknownSync(S.String)(1)
+    } catch (e: any) {
+      expect(e.cause).exist
+    }
+  })
+
   it("should throw on async", () => {
     expect(() => S.decodeUnknownSync(Util.AsyncString)("a")).toThrow(
       new Error(