feat: add safe parsing support

.changeset/curvy-laws-provide.md

@@ -0,0 +1,5 @@
+---
+'bodek': patch
+---
+
+Add safe parsing support

src/__tests__/index.test.ts

@@ -148,4 +148,25 @@ describe('Bodek', () => {
 		expect(() => schema.parse(-2)).toThrow('Number must be positive');
 		expect(() => schema.parse(3)).toThrow('Number must be even');
 	});
+
+	it('should support safe parsing', () => {
+		// Arrange.
+		const schema = b.number();
+
+		// Assert - valid.
+		expect(schema.safeParse(123)).toEqual({
+			success: true,
+			data: 123,
+		});
+
+		// Assert - invalid.
+		expect(schema.safeParse('hello')).toEqual({
+			success: false,
+			error: new Error('hello is not a number'),
+		});
+
+		expectTypeOf(schema.safeParse(123)).toEqualTypeOf<
+			{ success: true; data: number } | { success: false; error: Error }
+		>();
+	});
 });

src/schemas/schema.ts

@@ -4,6 +4,10 @@ type RefineParams = {
 	message?: string;
 };
 
+type SafeParseResult<T> =
+	| { success: true; data: T }
+	| { success: false; error: Error };
+
 export abstract class Schema<Type> {
 	private refinements: Array<{
 		validator: RefineValidator<Type>;
@@ -26,6 +30,22 @@ export abstract class Schema<Type> {
 		return parsed;
 	}
 
+	safeParse(value: unknown, message?: string): SafeParseResult<Type> {
+		try {
+			const data = this.parse(value, message);
+
+			return {
+				success: true,
+				data,
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: error as Error,
+			};
+		}
+	}
+
 	refine(validator: RefineValidator<Type>, params?: RefineParams) {
 		this.refinements.push({
 			validator,