From 0817f85f5d84d7e4b175bee92d2c741cd2cc5f63 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Valverd=C3=A9?= <me@julienvalver.de>
Date: Fri, 5 Jan 2024 00:39:32 +0100
Subject: [PATCH] 0.1.0 (#1)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Julien Valverdé <julien.valverde@mailo.com>
Reviewed-on: https://git.jvalver.de/Thilawyn/schemable-class/pulls/1
---
 .drone.jsonnet                                | 110 ++++++++++++++++++
 .gitignore                                    |   1 -
 .npmrc                                        |   1 +
 README.md                                     |   4 +-
 bun.lockb                                     | Bin 0 -> 154055 bytes
 bunfig.toml                                   |   2 +
 package.json                                  |  59 ++++++++++
 rollup.config.ts                              |  43 +++++++
 src/SchemableClass.ts                         |  90 ++++++++++++++
 src/index.ts                                  |   3 +
 src/jsonifiable/JsonifiableSchemableClass.ts  |  66 +++++++++++
 src/jsonifiable/dejsonifySchemable.ts         |  47 ++++++++
 src/jsonifiable/index.ts                      |   4 +
 .../makeJsonifiableSchemableClass.ts          |  98 ++++++++++++++++
 src/jsonifiable/schema/bigint.ts              |  18 +++
 src/jsonifiable/schema/date.ts                |  18 +++
 src/jsonifiable/schema/decimal.ts             |  19 +++
 src/jsonifiable/schema/index.ts               |   4 +
 src/jsonifiable/schema/schemable.ts           |  25 ++++
 src/makeSchemableClass.ts                     |  49 ++++++++
 src/newSchemable.ts                           |  77 ++++++++++++
 src/tests.ts                                  |  64 ++++++++++
 src/util.ts                                   |  82 +++++++++++++
 tsconfig.json                                 |  24 ++++
 24 files changed, 905 insertions(+), 3 deletions(-)
 create mode 100644 .drone.jsonnet
 create mode 100644 .npmrc
 create mode 100755 bun.lockb
 create mode 100644 bunfig.toml
 create mode 100644 package.json
 create mode 100644 rollup.config.ts
 create mode 100644 src/SchemableClass.ts
 create mode 100644 src/index.ts
 create mode 100644 src/jsonifiable/JsonifiableSchemableClass.ts
 create mode 100644 src/jsonifiable/dejsonifySchemable.ts
 create mode 100644 src/jsonifiable/index.ts
 create mode 100644 src/jsonifiable/makeJsonifiableSchemableClass.ts
 create mode 100644 src/jsonifiable/schema/bigint.ts
 create mode 100644 src/jsonifiable/schema/date.ts
 create mode 100644 src/jsonifiable/schema/decimal.ts
 create mode 100644 src/jsonifiable/schema/index.ts
 create mode 100644 src/jsonifiable/schema/schemable.ts
 create mode 100644 src/makeSchemableClass.ts
 create mode 100644 src/newSchemable.ts
 create mode 100644 src/tests.ts
 create mode 100644 src/util.ts
 create mode 100644 tsconfig.json

diff --git a/.drone.jsonnet b/.drone.jsonnet
new file mode 100644
index 0000000..fefec26
--- /dev/null
+++ b/.drone.jsonnet
@@ -0,0 +1,110 @@
+local bun_image = "oven/bun:1";
+local node_image = "node:20";
+
+
+local install_step = {
+    name: "install",
+    image: bun_image,
+    commands: ["bun install --frozen-lockfile"],
+};
+
+local lint_step = {
+    name: "lint",
+    image: bun_image,
+    commands: ["bun lint:tsc"],
+};
+
+local build_step = {
+    name: "build",
+    image: bun_image,
+    commands: ["bun run build"],
+};
+
+local pack_step = {
+    name: "pack",
+    image: node_image,
+    commands: ["npm pack --dry-run"],
+};
+
+local publish_step = {
+    name: "publish",
+    image: node_image,
+
+    environment: {
+        NPM_TOKEN: { from_secret: "npm_token" }
+    },
+
+    commands: [
+        "npm set @thilawyn:registry https://git.jvalver.de/api/packages/thilawyn/npm/",
+        "npm config set -- //git.jvalver.de/api/packages/thilawyn/npm/:_authToken $NPM_TOKEN",
+        "npm publish",
+    ],
+};
+
+
+[
+    // Lint the whole project when not in master, not in a PR nor on a tag
+    {
+        kind: "pipeline",
+        type: "docker",
+        name: "lint",
+
+        trigger: {
+            ref: {
+                exclude: [
+                    "refs/heads/master",
+                    "refs/pull/**",
+                    "refs/tags/**",
+                ]
+            }
+        },
+
+        steps: [
+            install_step,
+            lint_step,
+        ],
+    },
+
+    // Build the package without publishing for pull requests
+    {
+        kind: "pipeline",
+        type: "docker",
+        name: "build",
+
+        trigger: {
+            ref: {
+                include: ["refs/pull/**"]
+            }
+        },
+
+        steps: [
+            install_step,
+            lint_step,
+            build_step,
+            pack_step,
+        ],
+    },
+
+    // Build and publish the package for master and tags
+    {
+        kind: "pipeline",
+        type: "docker",
+        name: "build-publish",
+
+        trigger: {
+            ref: {
+                include: [
+                    "refs/heads/master",
+                    "refs/tags/**",
+                ]
+            }
+        },
+
+        steps: [
+            install_step,
+            lint_step,
+            build_step,
+            publish_step,
+        ],
+    },
+]
diff --git a/.gitignore b/.gitignore
index ceaea36..745264f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -129,4 +129,3 @@ dist
 .yarn/build-state.yml
 .yarn/install-state.gz
 .pnp.*
-
diff --git a/.npmrc b/.npmrc
new file mode 100644
index 0000000..93f962e
--- /dev/null
+++ b/.npmrc
@@ -0,0 +1 @@
+@thilawyn:registry=https://git.jvalver.de/api/packages/thilawyn/npm/
diff --git a/README.md b/README.md
index b731fa9..adb9b58 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,3 @@
-# schemable-classes
+# schemable-class
 
-Create TypeScript classes out of Zod schemas
\ No newline at end of file
+Create TypeScript classes out of Zod schemas
diff --git a/bun.lockb b/bun.lockb
new file mode 100755
index 0000000000000000000000000000000000000000..4e23eb8b4364adf2258b86fdc025f2982746ab68
GIT binary patch
literal 154055
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
BMnnJr

literal 0
HcmV?d00001

diff --git a/bunfig.toml b/bunfig.toml
new file mode 100644
index 0000000..bb40fbe
--- /dev/null
+++ b/bunfig.toml
@@ -0,0 +1,2 @@
+[install.scopes]
+"@thilawyn" = "https://git.jvalver.de/api/packages/thilawyn/npm/"
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..547eb5f
--- /dev/null
+++ b/package.json
@@ -0,0 +1,59 @@
+{
+  "name": "@thilawyn/schemable-class",
+  "version": "0.1.0",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://git.jvalver.de/api/packages/thilawyn/npm/"
+  },
+  "files": [
+    "./dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/schemable.d.mts",
+        "default": "./dist/schemable.mjs"
+      },
+      "require": {
+        "types": "./dist/schemable.d.cts",
+        "default": "./dist/schemable.cjs"
+      }
+    },
+    "./jsonifiable": {
+      "import": {
+        "types": "./dist/jsonifiable.d.mts",
+        "default": "./dist/jsonifiable.mjs"
+      },
+      "require": {
+        "types": "./dist/jsonifiable.d.cts",
+        "default": "./dist/jsonifiable.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "rollup -c rollup.config.ts",
+    "lint:tsc": "tsc --noEmit",
+    "clean:cache": "rm -f tsconfig.tsbuildinfo",
+    "clean:dist": "rm -rf dist",
+    "clean:node": "rm -rf node_modules"
+  },
+  "dependencies": {
+    "decimal.js": "^10.4.3",
+    "effect": "^2.0.0-next.62",
+    "lodash-es": "^4.17.21",
+    "type-fest": "^4.9.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@types/lodash-es": "^4.17.12",
+    "bun-types": "latest",
+    "npm-check-updates": "^16.14.12",
+    "npm-sort": "^0.0.4",
+    "rollup": "^4.9.1",
+    "rollup-plugin-cleanup": "^3.2.1",
+    "rollup-plugin-ts": "^3.4.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}
diff --git a/rollup.config.ts b/rollup.config.ts
new file mode 100644
index 0000000..8625946
--- /dev/null
+++ b/rollup.config.ts
@@ -0,0 +1,43 @@
+import { nodeResolve } from "@rollup/plugin-node-resolve"
+import { defineConfig } from "rollup"
+import cleanup from "rollup-plugin-cleanup"
+import ts from "rollup-plugin-ts"
+import pkg from "./package.json" assert { type: "json" }
+
+
+export const createBundleConfig = (
+    input:  string,
+    name:   keyof typeof pkg.exports,
+) =>
+    defineConfig({
+        input,
+
+        output: [
+            {
+                file:    pkg.exports[name].import.default,
+                format:  "esm",
+            },
+            {
+                file:    pkg.exports[name].require.default,
+                format:  "cjs",
+            },
+        ],
+
+        external: id => !/^[./]/.test(id),
+
+        plugins: [
+            nodeResolve(),
+            ts(),
+
+            cleanup({
+                comments: "jsdoc",
+                extensions: ["ts"],
+            }),
+        ],
+    })
+
+
+export default [
+    createBundleConfig("src/index.ts", "."),
+    createBundleConfig("src/jsonifiable/index.ts", "./jsonifiable"),
+]
diff --git a/src/SchemableClass.ts b/src/SchemableClass.ts
new file mode 100644
index 0000000..f85216c
--- /dev/null
+++ b/src/SchemableClass.ts
@@ -0,0 +1,90 @@
+import { Class } from "type-fest"
+import { z } from "zod"
+
+
+/**
+ * Configuration for creating a schemable object with validation schemas.
+ * @template Values - The type representing the expected values.
+ * @template Input - The type representing the input values.
+ * @template SchemaT - The type representing the base validation schema.
+ * @template SchemaUnknownKeys - The type representing the unknown keys behavior in the base validation schema.
+ * @template SchemaCatchall - The type representing the catchall behavior in the base validation schema.
+ * @template SchemaWithDefaultValuesT - The type representing the validation schema with default values.
+ * @template SchemaWithDefaultValuesUnknownKeys - The type representing the unknown keys behavior in the validation schema with default values.
+ * @template SchemaWithDefaultValuesCatchall - The type representing the catchall behavior in the validation schema with default values.
+ */
+export type SchemableConfig<
+    Values                             extends {}                 = {},
+    Input                              extends {}                 = {},
+
+    SchemaT                            extends z.ZodRawShape      = z.ZodRawShape,
+    SchemaUnknownKeys                  extends z.UnknownKeysParam = z.UnknownKeysParam,
+    SchemaCatchall                     extends z.ZodTypeAny       = z.ZodTypeAny,
+
+    SchemaWithDefaultValuesT           extends z.ZodRawShape      = z.ZodRawShape,
+    SchemaWithDefaultValuesUnknownKeys extends z.UnknownKeysParam = z.UnknownKeysParam,
+    SchemaWithDefaultValuesCatchall    extends z.ZodTypeAny       = z.ZodTypeAny,
+> = {
+    readonly values: Values
+    readonly input: Input
+
+    readonly schema: z.ZodObject<
+        SchemaT,
+        SchemaUnknownKeys,
+        SchemaCatchall,
+        Values,
+        Values
+    >
+
+    readonly schemaWithDefaultValues: z.ZodObject<
+        SchemaWithDefaultValuesT,
+        SchemaWithDefaultValuesUnknownKeys,
+        SchemaWithDefaultValuesCatchall,
+        Values,
+        Input
+    >
+}
+
+
+/**
+ * Represents a class with validation schemas.
+ * @template $Config - The configuration type for the schemable object.
+ */
+export type SchemableClass<
+    $Config extends SchemableConfig
+> = (
+    Class<
+        SchemableObject<$Config>,
+        SchemableClassConstructorParams<$Config>
+    > & {
+        readonly $schemableConfig:         $Config
+        readonly schema:                   $Config["schema"]
+        readonly schemaWithDefaultValues:  $Config["schemaWithDefaultValues"]
+    }
+)
+
+/**
+ * Represents the constructor parameters for the schemable object class.
+ * @template $Config - The configuration type for the schemable object.
+ */
+export type SchemableClassConstructorParams<
+    $Config extends SchemableConfig
+> = (
+    Parameters<
+        (data: $Config["values"]) => void
+    >
+)
+
+/**
+ * Represents an object with validation schemas.
+ * @template $Config - The configuration type for the schemable object.
+ */
+export type SchemableObject<
+    $Config extends SchemableConfig
+> = (
+    {
+        readonly $schemableConfig:         $Config
+        readonly schema:                   $Config["schema"]
+        readonly schemaWithDefaultValues:  $Config["schemaWithDefaultValues"]
+    } & $Config["values"]
+)
diff --git a/src/index.ts b/src/index.ts
new file mode 100644
index 0000000..17d8b56
--- /dev/null
+++ b/src/index.ts
@@ -0,0 +1,3 @@
+export * from "./SchemableClass"
+export * from "./makeSchemableClass"
+export * from "./newSchemable"
diff --git a/src/jsonifiable/JsonifiableSchemableClass.ts b/src/jsonifiable/JsonifiableSchemableClass.ts
new file mode 100644
index 0000000..c0dc3c0
--- /dev/null
+++ b/src/jsonifiable/JsonifiableSchemableClass.ts
@@ -0,0 +1,66 @@
+import { Effect } from "effect"
+import { Class } from "type-fest"
+import { JsonifiableObject } from "type-fest/source/jsonifiable"
+import { z } from "zod"
+import { SchemableClassConstructorParams, SchemableConfig } from ".."
+
+
+export type JsonifiableSchemableConfig<
+    $SchemableConfig           extends SchemableConfig    = SchemableConfig,
+
+    JsonifiedValues            extends JsonifiableObject  = {},
+
+    JsonifySchemaT             extends z.ZodRawShape      = z.ZodRawShape,
+    JsonifySchemaUnknownKeys   extends z.UnknownKeysParam = z.UnknownKeysParam,
+    JsonifySchemaCatchall      extends z.ZodTypeAny       = z.ZodTypeAny,
+
+    DejsonifySchemaT           extends z.ZodRawShape      = z.ZodRawShape,
+    DejsonifySchemaUnknownKeys extends z.UnknownKeysParam = z.UnknownKeysParam,
+    DejsonifySchemaCatchall    extends z.ZodTypeAny       = z.ZodTypeAny,
+> = {
+    readonly $schemableConfig: $SchemableConfig
+
+    readonly jsonifiedValues: JsonifiedValues
+
+    readonly jsonifySchema: z.ZodObject<
+        JsonifySchemaT,
+        JsonifySchemaUnknownKeys,
+        JsonifySchemaCatchall,
+        JsonifiedValues,
+        $SchemableConfig["values"]
+    >
+
+    readonly dejsonifySchema: z.ZodObject<
+        DejsonifySchemaT,
+        DejsonifySchemaUnknownKeys,
+        DejsonifySchemaCatchall,
+        $SchemableConfig["values"],
+        JsonifiedValues
+    >
+}
+
+
+export type JsonifiableSchemableClass<
+    $Config extends JsonifiableSchemableConfig
+> = (
+    Class<
+        JsonifiableSchemableObject<$Config>,
+        SchemableClassConstructorParams<$Config["$schemableConfig"]>
+    > & {
+        readonly $jsonifiableSchemableConfig:  $Config
+        readonly jsonifySchema:                $Config["jsonifySchema"]
+        readonly dejsonifySchema:              $Config["dejsonifySchema"]
+    }
+)
+
+export type JsonifiableSchemableObject<
+    $Config extends JsonifiableSchemableConfig
+> = {
+    readonly $jsonifiableSchemableConfig:  $Config
+    readonly jsonifySchema:                $Config["jsonifySchema"]
+    readonly dejsonifySchema:              $Config["dejsonifySchema"]
+
+    jsonify():         $Config["jsonifiedValues"]
+    jsonifyPromise():  Promise<$Config["jsonifiedValues"]>
+    jsonifyEffect():   Effect.Effect<never, z.ZodError<$Config["$schemableConfig"]["values"]>, $Config["jsonifiedValues"]>
+}
diff --git a/src/jsonifiable/dejsonifySchemable.ts b/src/jsonifiable/dejsonifySchemable.ts
new file mode 100644
index 0000000..35ceafb
--- /dev/null
+++ b/src/jsonifiable/dejsonifySchemable.ts
@@ -0,0 +1,47 @@
+import { Effect, pipe } from "effect"
+import { z } from "zod"
+import { JsonifiableSchemableClass, JsonifiableSchemableConfig } from "."
+import { parseZodTypeEffect } from "../util"
+
+
+export const dejsonifySchemable = <
+    C       extends JsonifiableSchemableClass<$Config>,
+    $Config extends JsonifiableSchemableConfig,
+>(
+    class_:   C | JsonifiableSchemableClass<$Config>,
+    values:   $Config["jsonifiedValues"],
+    params?:  Partial<z.ParseParams>,
+) =>
+    new class_(class_.dejsonifySchema.parse(values, params)) as InstanceType<C>
+
+
+export const dejsonifySchemablePromise = async <
+    C       extends JsonifiableSchemableClass<$Config>,
+    $Config extends JsonifiableSchemableConfig,
+>(
+    class_:   C | JsonifiableSchemableClass<$Config>,
+    values:   $Config["jsonifiedValues"],
+    params?:  Partial<z.ParseParams>,
+) =>
+    new class_(await class_.dejsonifySchema.parseAsync(values, params)) as InstanceType<C>
+
+
+export const dejsonifySchemableEffect = <
+    C       extends JsonifiableSchemableClass<$Config>,
+    $Config extends JsonifiableSchemableConfig,
+>(
+    class_:   C | JsonifiableSchemableClass<$Config>,
+    values:   $Config["jsonifiedValues"],
+    params?:  Partial<z.ParseParams>,
+) => pipe(
+    parseZodTypeEffect<
+        z.output<typeof class_.dejsonifySchema>,
+        z.input<typeof class_.dejsonifySchema>
+    >(
+        class_.dejsonifySchema,
+        values,
+        params,
+    ),
+
+    Effect.map(values => new class_(values) as InstanceType<C>),
+)
diff --git a/src/jsonifiable/index.ts b/src/jsonifiable/index.ts
new file mode 100644
index 0000000..74e7d23
--- /dev/null
+++ b/src/jsonifiable/index.ts
@@ -0,0 +1,4 @@
+export * from "./JsonifiableSchemableClass"
+export * from "./dejsonifySchemable"
+export * from "./makeJsonifiableSchemableClass"
+export * from "./schema"
diff --git a/src/jsonifiable/makeJsonifiableSchemableClass.ts b/src/jsonifiable/makeJsonifiableSchemableClass.ts
new file mode 100644
index 0000000..a956b0b
--- /dev/null
+++ b/src/jsonifiable/makeJsonifiableSchemableClass.ts
@@ -0,0 +1,98 @@
+import { Class } from "type-fest"
+import { JsonifiableObject } from "type-fest/source/jsonifiable"
+import { z } from "zod"
+import { JsonifiableSchemableClass, JsonifiableSchemableConfig, JsonifiableSchemableObject } from "."
+import { SchemableClass, SchemableConfig } from ".."
+import { StaticMembers, parseZodTypeEffect } from "../util"
+
+
+export function makeJsonifiableSchemableClass<
+    C                          extends SchemableClass<$SchemableConfig>,
+    $SchemableConfig           extends SchemableConfig,
+
+    JsonifiedValues            extends JsonifiableObject,
+
+    JsonifySchemaT             extends z.ZodRawShape,
+    JsonifySchemaUnknownKeys   extends z.UnknownKeysParam,
+    JsonifySchemaCatchall      extends z.ZodTypeAny,
+
+    DejsonifySchemaT           extends z.ZodRawShape,
+    DejsonifySchemaUnknownKeys extends z.UnknownKeysParam,
+    DejsonifySchemaCatchall    extends z.ZodTypeAny,
+>(
+    class_: C | SchemableClass<$SchemableConfig>,
+
+    props: {
+        jsonifySchema: (props: {
+            schema:  $SchemableConfig["schema"]
+            s:       $SchemableConfig["schema"]["shape"]
+        }) => z.ZodObject<
+            JsonifySchemaT,
+            JsonifySchemaUnknownKeys,
+            JsonifySchemaCatchall,
+            JsonifiedValues,
+            $SchemableConfig["values"]
+        >
+
+        dejsonifySchema: (props: {
+            schema:  $SchemableConfig["schema"]
+            s:       $SchemableConfig["schema"]["shape"]
+        }) => z.ZodObject<
+            DejsonifySchemaT,
+            DejsonifySchemaUnknownKeys,
+            DejsonifySchemaCatchall,
+            $SchemableConfig["values"],
+            JsonifiedValues
+        >
+    },
+) {
+
+    const jsonifySchema = props.jsonifySchema({
+        schema:  class_.schema,
+        s:       class_.schema.shape,
+    })
+
+    const dejsonifySchema = props.dejsonifySchema({
+        schema:  class_.schema,
+        s:       class_.schema.shape,
+    })
+
+    const $jsonifiableSchemableConfig = {
+        $schemableConfig:  class_.$schemableConfig,
+        jsonifiedValues:   undefined as unknown as JsonifiedValues,
+        jsonifySchema:     undefined as unknown as typeof jsonifySchema,
+        dejsonifySchema:   undefined as unknown as typeof dejsonifySchema,
+    } as const satisfies JsonifiableSchemableConfig
+
+    const jsonifiableClass = class JsonifiableSchemableObject extends class_ {
+        static readonly $jsonifiableSchemableConfig = $jsonifiableSchemableConfig
+        static readonly jsonifySchema               = jsonifySchema
+        static readonly dejsonifySchema             = dejsonifySchema
+
+        readonly $jsonifiableSchemableConfig = $jsonifiableSchemableConfig
+        readonly jsonifySchema               = jsonifySchema
+        readonly dejsonifySchema             = dejsonifySchema
+
+        jsonify() {
+            return this.jsonifySchema.parse(this)
+        }
+
+        jsonifyPromise() {
+            return this.jsonifySchema.parseAsync(this)
+        }
+
+        jsonifyEffect() {
+            return parseZodTypeEffect(this.jsonifySchema, this)
+        }
+    } satisfies JsonifiableSchemableClass<typeof $jsonifiableSchemableConfig>
+
+    return jsonifiableClass as unknown as (
+        Class<
+            InstanceType<C> & JsonifiableSchemableObject<typeof $jsonifiableSchemableConfig>,
+            ConstructorParameters<C>
+        > &
+        StaticMembers<C> &
+        StaticMembers<JsonifiableSchemableClass<typeof $jsonifiableSchemableConfig>>
+    )
+
+}
diff --git a/src/jsonifiable/schema/bigint.ts b/src/jsonifiable/schema/bigint.ts
new file mode 100644
index 0000000..b0f0093
--- /dev/null
+++ b/src/jsonifiable/schema/bigint.ts
@@ -0,0 +1,18 @@
+import { z } from "zod"
+
+
+export const jsonifyBigIntSchema = <S extends z.ZodBigInt>(schema: S) =>
+    schema.transform(v => v.toString())
+
+export const dejsonifyBigIntSchema = <S extends z.ZodBigInt>(schema: S) =>
+    z
+        .string()
+        .transform(v => {
+            try {
+                return BigInt(v)
+            }
+            catch (e) {
+                return v
+            }
+        })
+        .pipe(schema)
diff --git a/src/jsonifiable/schema/date.ts b/src/jsonifiable/schema/date.ts
new file mode 100644
index 0000000..b5ac677
--- /dev/null
+++ b/src/jsonifiable/schema/date.ts
@@ -0,0 +1,18 @@
+import { z } from "zod"
+
+
+export const jsonifyDateSchema = <S extends z.ZodDate>(schema: S) =>
+    schema.transform(v => v.toString())
+
+export const dejsonifyDateSchema = <S extends z.ZodDate>(schema: S) =>
+    z
+        .string()
+        .transform(v => {
+            try {
+                return new Date(v)
+            }
+            catch (e) {
+                return v
+            }
+        })
+        .pipe(schema)
diff --git a/src/jsonifiable/schema/decimal.ts b/src/jsonifiable/schema/decimal.ts
new file mode 100644
index 0000000..58c492d
--- /dev/null
+++ b/src/jsonifiable/schema/decimal.ts
@@ -0,0 +1,19 @@
+import { Decimal } from "decimal.js"
+import { z } from "zod"
+
+
+export const jsonifyDecimalSchema = <S extends z.ZodType<Decimal, z.ZodTypeDef, Decimal>>(schema: S) =>
+    schema.transform(v => v.toJSON())
+
+export const dejsonifyDecimalSchema = <S extends z.ZodType<Decimal, z.ZodTypeDef, Decimal>>(schema: S) =>
+    z
+        .string()
+        .transform(v => {
+            try {
+                return new Decimal(v)
+            }
+            catch (e) {
+                return v
+            }
+        })
+        .pipe(schema)
diff --git a/src/jsonifiable/schema/index.ts b/src/jsonifiable/schema/index.ts
new file mode 100644
index 0000000..08ecef8
--- /dev/null
+++ b/src/jsonifiable/schema/index.ts
@@ -0,0 +1,4 @@
+export * from "./bigint"
+export * from "./date"
+export * from "./decimal"
+export * from "./schemable"
diff --git a/src/jsonifiable/schema/schemable.ts b/src/jsonifiable/schema/schemable.ts
new file mode 100644
index 0000000..c6e2a2d
--- /dev/null
+++ b/src/jsonifiable/schema/schemable.ts
@@ -0,0 +1,25 @@
+import { z } from "zod"
+import { JsonifiableSchemableClass, JsonifiableSchemableConfig } from ".."
+
+
+// TODO: try to find a way to get rid of the 'class_' arg
+export const jsonifySchemableSchema = <
+    C       extends JsonifiableSchemableClass<$Config>,
+    $Config extends JsonifiableSchemableConfig,
+    S       extends z.ZodType<InstanceType<C>, z.ZodTypeDef, InstanceType<C>>,
+>(
+    class_:  C | JsonifiableSchemableClass<$Config>,
+    schema:  S,
+) =>
+    schema.pipe(class_.jsonifySchema)
+
+// TODO: try to find a way to get rid of the 'class_' arg
+export const dejsonifySchemableSchema = <
+    C       extends JsonifiableSchemableClass<$Config>,
+    $Config extends JsonifiableSchemableConfig,
+    S       extends z.ZodType<InstanceType<C>, z.ZodTypeDef, InstanceType<C>>,
+>(
+    class_:  C | JsonifiableSchemableClass<$Config>,
+    schema:  S,
+) =>
+    class_.dejsonifySchema.transform(v => new class_(v)).pipe(schema)
diff --git a/src/makeSchemableClass.ts b/src/makeSchemableClass.ts
new file mode 100644
index 0000000..88bcf72
--- /dev/null
+++ b/src/makeSchemableClass.ts
@@ -0,0 +1,49 @@
+import { z } from "zod"
+import { SchemableClass, SchemableConfig } from "."
+import { zodObjectRemoveDefaults } from "./util"
+
+
+export function makeSchemableClass<
+    SchemaWithDefaultValuesT           extends z.ZodRawShape,
+    SchemaWithDefaultValuesUnknownKeys extends z.UnknownKeysParam,
+    SchemaWithDefaultValuesCatchall    extends z.ZodTypeAny,
+    SchemaWithDefaultValuesOutput      extends SchemaWithDefaultValuesInput,  // TODO: apply "StripSchemaInputDefaults"?
+    SchemaWithDefaultValuesInput       extends {},
+>(
+    {
+        schema: schemaWithDefaultValues
+    }: {
+        schema: z.ZodObject<
+            SchemaWithDefaultValuesT,
+            SchemaWithDefaultValuesUnknownKeys,
+            SchemaWithDefaultValuesCatchall,
+            SchemaWithDefaultValuesOutput,
+            SchemaWithDefaultValuesInput
+        >
+    }
+) {
+
+    const schema = zodObjectRemoveDefaults(schemaWithDefaultValues)
+
+    const $schemableConfig = {
+        values:                   undefined as unknown as z.output<typeof schemaWithDefaultValues>,
+        input:                    undefined as unknown as z.input<typeof schemaWithDefaultValues>,
+        schema:                   undefined as unknown as typeof schema,
+        schemaWithDefaultValues:  undefined as unknown as typeof schemaWithDefaultValues,
+    } as const satisfies SchemableConfig
+
+    return class SchemableObject {
+        static readonly $schemableConfig        = $schemableConfig
+        static readonly schema                  = schema
+        static readonly schemaWithDefaultValues = schemaWithDefaultValues
+
+        readonly $schemableConfig        = $schemableConfig
+        readonly schema                  = schema
+        readonly schemaWithDefaultValues = schemaWithDefaultValues
+
+        constructor(data: z.output<typeof schema>) {
+            Object.assign(this, data)
+        }
+    } as SchemableClass<typeof $schemableConfig>
+
+}
diff --git a/src/newSchemable.ts b/src/newSchemable.ts
new file mode 100644
index 0000000..da0be36
--- /dev/null
+++ b/src/newSchemable.ts
@@ -0,0 +1,77 @@
+import { Effect, pipe } from "effect"
+import { HasRequiredKeys } from "type-fest"
+import { z } from "zod"
+import { SchemableClass, SchemableConfig } from "."
+import { parseZodTypeEffect } from "./util"
+
+
+type ParamsArgs = [] | [Partial<z.ParseParams>]
+
+type NewSchemableArgs<Input extends object> =
+    HasRequiredKeys<Input> extends true
+        ? [Input, ...ParamsArgs]
+        : [] | [Input, ...ParamsArgs]
+
+
+/**
+ * Creates a new instance of a SchemableClass with default values.
+ *
+ * @param class_ - The SchemableClass.
+ * @param values - The values to be parsed and used to create the instance.
+ * @param params - Optional parameters for parsing.
+ * @returns A new instance of the specified SchemableClass.
+ */
+export const newSchemable = <
+    C       extends SchemableClass<$Config>,
+    $Config extends SchemableConfig,
+>(
+    class_:               C | SchemableClass<$Config>,
+    ...[values, params]:  NewSchemableArgs<$Config["input"]>
+) =>
+    new class_(class_.schemaWithDefaultValues.parse(values || {}, params)) as InstanceType<C>
+
+
+/**
+ * Creates a new instance of a SchemableClass with default values asynchronously.
+ *
+ * @param class_ - The SchemableClass.
+ * @param values - The values to be parsed and used to create the instance.
+ * @param params - Optional parameters for parsing.
+ * @returns A Promise resolving to a new instance of the specified SchemableClass.
+ */
+export const newSchemablePromise = async <
+    C       extends SchemableClass<$Config>,
+    $Config extends SchemableConfig,
+>(
+    class_:               C | SchemableClass<$Config>,
+    ...[values, params]:  NewSchemableArgs<$Config["input"]>
+) =>
+    new class_(await class_.schemaWithDefaultValues.parseAsync(values || {}, params)) as InstanceType<C>
+
+
+/**
+ * Creates a new instance of a SchemableClass with default values as an Effect.
+ *
+ * @param class_ - The SchemableClass.
+ * @param values - The values to be parsed and used to create the instance.
+ * @param params - Optional parameters for parsing.
+ * @returns An Effect producing a new instance of the specified SchemableClass.
+ */
+export const newSchemableEffect = <
+    C       extends SchemableClass<$Config>,
+    $Config extends SchemableConfig,
+>(
+    class_:               C | SchemableClass<$Config>,
+    ...[values, params]:  NewSchemableArgs<$Config["input"]>
+) => pipe(
+    parseZodTypeEffect<
+        z.output<typeof class_.schemaWithDefaultValues>,
+        z.input<typeof class_.schemaWithDefaultValues>
+    >(
+        class_.schemaWithDefaultValues,
+        values || {},
+        params,
+    ),
+
+    Effect.map(values => new class_(values) as InstanceType<C>),
+)
diff --git a/src/tests.ts b/src/tests.ts
new file mode 100644
index 0000000..c19daf7
--- /dev/null
+++ b/src/tests.ts
@@ -0,0 +1,64 @@
+import { z } from "zod"
+import { makeSchemableClass, newSchemable } from "."
+import { dejsonifyBigIntSchema, dejsonifySchemable, dejsonifySchemableSchema, jsonifyBigIntSchema, jsonifySchemableSchema, makeJsonifiableSchemableClass } from "./jsonifiable"
+
+
+const GroupSchema = z.object({
+    /** Group ID */
+    id: z.bigint(),
+
+    /** Group name */
+    name: z.string(),
+})
+
+const GroupSchemableObject = makeSchemableClass({ schema: GroupSchema })
+
+const GroupJsonifiableSchemableObject = makeJsonifiableSchemableClass(GroupSchemableObject, {
+    jsonifySchema: ({ schema, s }) => schema.extend({
+        id: jsonifyBigIntSchema(s.id)
+    }),
+
+    dejsonifySchema: ({ schema, s }) => schema.extend({
+        id: dejsonifyBigIntSchema(s.id)
+    }),
+})
+
+class Group extends GroupJsonifiableSchemableObject {}
+
+
+const UserSchema = z.object({
+    /** User ID */
+    id: z.bigint(),
+
+    /** Name string */
+    name: z.string(),
+
+    /** User group */
+    group: z.instanceof(Group),
+})
+
+const UserSchemableObject = makeSchemableClass({ schema: UserSchema })
+
+const UserJsonifiableSchemableObject = makeJsonifiableSchemableClass(UserSchemableObject, {
+    jsonifySchema: ({ schema, s }) => schema.extend({
+        id: jsonifyBigIntSchema(s.id),
+        group: jsonifySchemableSchema(Group, s.group),
+    }),
+
+    dejsonifySchema: ({ schema, s }) => schema.extend({
+        id: dejsonifyBigIntSchema(s.id),
+        group: dejsonifySchemableSchema(Group, s.group),
+    }),
+})
+
+class User extends UserJsonifiableSchemableObject {}
+
+
+const group1 = new Group({ id: 1n, name: "Group 1" })
+
+const user1 = new User({ id: 1n, name: "User 1", group: group1 })
+const user2 = newSchemable(User, { id: 2n, name: "User 2", group: group1 })
+
+const jsonifiedUser2 = user2.jsonify()
+const dejsonifiedUser2 = dejsonifySchemable(User, jsonifiedUser2)
+console.log(dejsonifiedUser2)
diff --git a/src/util.ts b/src/util.ts
new file mode 100644
index 0000000..2cf7b08
--- /dev/null
+++ b/src/util.ts
@@ -0,0 +1,82 @@
+import { Effect, pipe } from "effect"
+import { mapValues } from "lodash-es"
+import { z } from "zod"
+
+
+/**
+ * Represents the static members of a class.
+ * @template C - The class type.
+ */
+export type StaticMembers<C> = {
+    [Key in keyof C as Key extends "prototype" ? never : Key]: C[Key]
+}
+
+
+/**
+ * Removes default values from a ZodObject schema and returns a new schema.
+ *
+ * @param schema - The ZodObject schema to process.
+ * @returns A new ZodObject schema with default values removed.
+ */
+export const zodObjectRemoveDefaults = <
+    T           extends z.ZodRawShape,
+    UnknownKeys extends z.UnknownKeysParam,
+    Catchall    extends z.ZodTypeAny,
+    Output      extends {},
+    Input       extends {},
+>(
+    schema: z.ZodObject<
+        T,
+        UnknownKeys,
+        Catchall,
+        Output,
+        Input
+    >
+) =>
+    schema.extend(zodShapeRemoveDefaults(schema.shape))
+
+/**
+ * Removes default values from a ZodObject shape and returns a new shape.
+ *
+ * @param shape - The ZodObject shape to process.
+ * @returns A new shape with default values removed.
+ */
+export const zodShapeRemoveDefaults = <
+    Shape extends z.ZodRawShape
+>(
+    shape: Shape
+): {
+    [K in keyof Shape]:
+        Shape[K] extends z.ZodDefault<infer T>
+            ? T
+            : Shape[K]
+} =>
+    mapValues(shape, el =>
+        el instanceof z.ZodDefault
+            ? el.removeDefault()
+            : el
+    )
+
+
+/**
+ * Parses a value using a ZodType schema wrapped in an Effect monad.
+ *
+ * @param schema - The ZodType schema to use for parsing.
+ * @param args - The arguments to pass to the `safeParseAsync` method of the schema.
+ * @returns An Effect monad representing the parsing result.
+ */
+export const parseZodTypeEffect = <
+    Output,
+    Input,
+>(
+    schema:   z.ZodType<Output, z.ZodTypeDef, Input>,
+    ...args:  Parameters<typeof schema.safeParseAsync>
+) => pipe(
+    Effect.promise(() => schema.safeParseAsync(...args)),
+
+    Effect.flatMap(response =>
+        response.success
+            ? Effect.succeed(response.data)
+            : Effect.fail(response.error)
+    ),
+)
diff --git a/tsconfig.json b/tsconfig.json
new file mode 100644
index 0000000..5470793
--- /dev/null
+++ b/tsconfig.json
@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "module": "esnext",
+    "target": "esnext",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    // "allowImportingTsExtensions": true,
+    // "noEmit": true,
+    "declaration": true,
+    "composite": true,
+    "strict": true,
+    "downlevelIteration": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowJs": true,
+    "types": [
+      "bun-types"
+    ]
+  },
+  "include": ["src"]
+}