bunsane 0.1.0

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 BunSane contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,60 @@
+<div align="center">
+
+<img src="./BunSane.jpg" alt="BunSane" width="520" />
+
+# BunSane — Batteries‑included TypeScript API framework for Bun
+
+### Entity–Component storage on Postgres, a fluent query builder, and zero‑boilerplate GraphQL with GraphQL Yoga.
+#### Skip Boilerplating and FOCUS writing Business Flow code 😉
+
+### BunSane currently in `EXPERIMENTAL` state Not Production Ready
+</div>
+
+## Features
+
+- Entity–Component model backed by PostgreSQL (auto-migrates base tables on first run)
+- Declarative Components with decorators and indexed fields
+- Fluent, performant Query builder (with/without population, filters, exclusions)
+- Pluggable Services with decorators that generate a GraphQL schema automatically
+- GraphQL Yoga server bootstrap out of the box
+- Pino logging, pretty mode in development
+- Zod-friendly GraphQL error helper
+
+## Install
+
+Requires Bun and PostgreSQL.
+
+```cmd
+bun install @yaaruu/bunsane
+```
+
+Ensure your tsconfig enables decorators in your app:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+Full documentation visit: [Documentation](https://example.com)
+
+## Core concepts
+
+### ECS ( Entity Component Services )
+TODO
+
+
+## LICENSE 
+MIT
+
+---
+
+## Made with⚡
+- Bun
+- GraphQL
+- GraphQL Yoga
+- PostgreSQL
+

package/TODO.md

@@ -0,0 +1 @@
+// TODO: Add index when component was registered but changed

package/bun.lock

@@ -0,0 +1,147 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "bunsane",
+      "dependencies": {
+        "graphql": "^16.11.0",
+        "graphql-yoga": "^5.15.1",
+        "pino": "^9.9.0",
+        "pino-pretty": "^13.1.1",
+        "reflect-metadata": "^0.2.2",
+        "zod": "^4.1.5",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@envelop/core": ["@envelop/core@5.3.0", "", { "dependencies": { "@envelop/instrumentation": "^1.0.0", "@envelop/types": "^5.2.1", "@whatwg-node/promise-helpers": "^1.2.4", "tslib": "^2.5.0" } }, "sha512-xvUkOWXI8JsG2OOnqiI2tOkEc52wbmIqWORr7yGc8B8E53Oh1MMGGGck4mbR80s25LnHVzfNIiIlNkuDgZRuuA=="],
+
+    "@envelop/instrumentation": ["@envelop/instrumentation@1.0.0", "", { "dependencies": { "@whatwg-node/promise-helpers": "^1.2.1", "tslib": "^2.5.0" } }, "sha512-cxgkB66RQB95H3X27jlnxCRNTmPuSTgmBAq6/4n2Dtv4hsk4yz8FadA1ggmd0uZzvKqWD6CR+WFgTjhDqg7eyw=="],
+
+    "@envelop/types": ["@envelop/types@5.2.1", "", { "dependencies": { "@whatwg-node/promise-helpers": "^1.0.0", "tslib": "^2.5.0" } }, "sha512-CsFmA3u3c2QoLDTfEpGr4t25fjMU31nyvse7IzWTvb0ZycuPjMjb0fjlheh+PbhBYb9YLugnT2uY6Mwcg1o+Zg=="],
+
+    "@fastify/busboy": ["@fastify/busboy@3.2.0", "", {}, "sha512-m9FVDXU3GT2ITSe0UaMA5rU3QkfC/UXtCU8y0gSN/GugTqtVldOBWIB5V6V3sbmenVZUIpU6f+mPEO2+m5iTaA=="],
+
+    "@graphql-tools/executor": ["@graphql-tools/executor@1.4.9", "", { "dependencies": { "@graphql-tools/utils": "^10.9.1", "@graphql-typed-document-node/core": "^3.2.0", "@repeaterjs/repeater": "^3.0.4", "@whatwg-node/disposablestack": "^0.0.6", "@whatwg-node/promise-helpers": "^1.0.0", "tslib": "^2.4.0" }, "peerDependencies": { "graphql": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-SAUlDT70JAvXeqV87gGzvDzUGofn39nvaVcVhNf12Dt+GfWHtNNO/RCn/Ea4VJaSLGzraUd41ObnN3i80EBU7w=="],
+
+    "@graphql-tools/merge": ["@graphql-tools/merge@9.1.1", "", { "dependencies": { "@graphql-tools/utils": "^10.9.1", "tslib": "^2.4.0" }, "peerDependencies": { "graphql": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-BJ5/7Y7GOhTuvzzO5tSBFL4NGr7PVqTJY3KeIDlVTT8YLcTXtBR+hlrC3uyEym7Ragn+zyWdHeJ9ev+nRX1X2w=="],
+
+    "@graphql-tools/schema": ["@graphql-tools/schema@10.0.25", "", { "dependencies": { "@graphql-tools/merge": "^9.1.1", "@graphql-tools/utils": "^10.9.1", "tslib": "^2.4.0" }, "peerDependencies": { "graphql": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-/PqE8US8kdQ7lB9M5+jlW8AyVjRGCKU7TSktuW3WNKSKmDO0MK1wakvb5gGdyT49MjAIb4a3LWxIpwo5VygZuw=="],
+
+    "@graphql-tools/utils": ["@graphql-tools/utils@10.9.1", "", { "dependencies": { "@graphql-typed-document-node/core": "^3.1.1", "@whatwg-node/promise-helpers": "^1.0.0", "cross-inspect": "1.0.1", "dset": "^3.1.4", "tslib": "^2.4.0" }, "peerDependencies": { "graphql": "^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-B1wwkXk9UvU7LCBkPs8513WxOQ2H8Fo5p8HR1+Id9WmYE5+bd51vqN+MbrqvWczHCH2gwkREgHJN88tE0n1FCw=="],
+
+    "@graphql-typed-document-node/core": ["@graphql-typed-document-node/core@3.2.0", "", { "peerDependencies": { "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-mB9oAsNCm9aM3/SOv4YtBMqZbYj10R7dkq8byBqxGY/ncFwhf2oQzMV+LCRlWoDSEBJ3COiR1yeDvMtsoOsuFQ=="],
+
+    "@graphql-yoga/logger": ["@graphql-yoga/logger@2.0.1", "", { "dependencies": { "tslib": "^2.8.1" } }, "sha512-Nv0BoDGLMg9QBKy9cIswQ3/6aKaKjlTh87x3GiBg2Z4RrjyrM48DvOOK0pJh1C1At+b0mUIM67cwZcFTDLN4sA=="],
+
+    "@graphql-yoga/subscription": ["@graphql-yoga/subscription@5.0.5", "", { "dependencies": { "@graphql-yoga/typed-event-target": "^3.0.2", "@repeaterjs/repeater": "^3.0.4", "@whatwg-node/events": "^0.1.0", "tslib": "^2.8.1" } }, "sha512-oCMWOqFs6QV96/NZRt/ZhTQvzjkGB4YohBOpKM4jH/lDT4qb7Lex/aGCxpi/JD9njw3zBBtMqxbaC22+tFHVvw=="],
+
+    "@graphql-yoga/typed-event-target": ["@graphql-yoga/typed-event-target@3.0.2", "", { "dependencies": { "@repeaterjs/repeater": "^3.0.4", "tslib": "^2.8.1" } }, "sha512-ZpJxMqB+Qfe3rp6uszCQoag4nSw42icURnBRfFYSOmTgEeOe4rD0vYlbA8spvCu2TlCesNTlEN9BLWtQqLxabA=="],
+
+    "@repeaterjs/repeater": ["@repeaterjs/repeater@3.0.6", "", {}, "sha512-Javneu5lsuhwNCryN+pXH93VPQ8g0dBX7wItHFgYiwQmzE1sVdg5tWHiOgHywzL2W21XQopa7IwIEnNbmeUJYA=="],
+
+    "@types/bun": ["@types/bun@1.2.21", "", { "dependencies": { "bun-types": "1.2.21" } }, "sha512-NiDnvEqmbfQ6dmZ3EeUO577s4P5bf4HCTXtI6trMc6f6RzirY5IrF3aIookuSpyslFzrnvv2lmEWv5HyC1X79A=="],
+
+    "@types/node": ["@types/node@24.3.0", "", { "dependencies": { "undici-types": "~7.10.0" } }, "sha512-aPTXCrfwnDLj4VvXrm+UUCQjNEvJgNA8s5F1cvwQU+3KNltTOkBm1j30uNLyqqPNe7gE3KFzImYoZEfLhp4Yow=="],
+
+    "@types/react": ["@types/react@19.1.12", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-cMoR+FoAf/Jyq6+Df2/Z41jISvGZZ2eTlnsaJRptmZ76Caldwy1odD4xTr/gNV9VLj0AWgg/nmkevIyUfIIq5w=="],
+
+    "@whatwg-node/disposablestack": ["@whatwg-node/disposablestack@0.0.6", "", { "dependencies": { "@whatwg-node/promise-helpers": "^1.0.0", "tslib": "^2.6.3" } }, "sha512-LOtTn+JgJvX8WfBVJtF08TGrdjuFzGJc4mkP8EdDI8ADbvO7kiexYep1o8dwnt0okb0jYclCDXF13xU7Ge4zSw=="],
+
+    "@whatwg-node/events": ["@whatwg-node/events@0.1.2", "", { "dependencies": { "tslib": "^2.6.3" } }, "sha512-ApcWxkrs1WmEMS2CaLLFUEem/49erT3sxIVjpzU5f6zmVcnijtDSrhoK2zVobOIikZJdH63jdAXOrvjf6eOUNQ=="],
+
+    "@whatwg-node/fetch": ["@whatwg-node/fetch@0.10.10", "", { "dependencies": { "@whatwg-node/node-fetch": "^0.7.25", "urlpattern-polyfill": "^10.0.0" } }, "sha512-watz4i/Vv4HpoJ+GranJ7HH75Pf+OkPQ63NoVmru6Srgc8VezTArB00i/oQlnn0KWh14gM42F22Qcc9SU9mo/w=="],
+
+    "@whatwg-node/node-fetch": ["@whatwg-node/node-fetch@0.7.25", "", { "dependencies": { "@fastify/busboy": "^3.1.1", "@whatwg-node/disposablestack": "^0.0.6", "@whatwg-node/promise-helpers": "^1.3.2", "tslib": "^2.6.3" } }, "sha512-szCTESNJV+Xd56zU6ShOi/JWROxE9IwCic8o5D9z5QECZloas6Ez5tUuKqXTAdu6fHFx1t6C+5gwj8smzOLjtg=="],
+
+    "@whatwg-node/promise-helpers": ["@whatwg-node/promise-helpers@1.3.2", "", { "dependencies": { "tslib": "^2.6.3" } }, "sha512-Nst5JdK47VIl9UcGwtv2Rcgyn5lWtZ0/mhRQ4G8NN2isxpq2TO30iqHzmwoJycjWuyUfg3GFXqP/gFHXeV57IA=="],
+
+    "@whatwg-node/server": ["@whatwg-node/server@0.10.12", "", { "dependencies": { "@envelop/instrumentation": "^1.0.0", "@whatwg-node/disposablestack": "^0.0.6", "@whatwg-node/fetch": "^0.10.10", "@whatwg-node/promise-helpers": "^1.3.2", "tslib": "^2.6.3" } }, "sha512-MQIvvQyPvKGna586MzXhgwnEbGtbm7QtOgJ/KPd/tC70M/jbhd1xHdIQQbh3okBw+MrDF/EvaC2vB5oRC7QdlQ=="],
+
+    "atomic-sleep": ["atomic-sleep@1.0.0", "", {}, "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ=="],
+
+    "bun-types": ["bun-types@1.2.21", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-sa2Tj77Ijc/NTLS0/Odjq/qngmEPZfbfnOERi0KRUYhT9R8M4VBioWVmMWE5GrYbKMc+5lVybXygLdibHaqVqw=="],
+
+    "colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="],
+
+    "cross-inspect": ["cross-inspect@1.0.1", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-Pcw1JTvZLSJH83iiGWt6fRcT+BjZlCDRVwYLbUcHzv/CRpB7r0MlSrGbIyQvVSNyGnbt7G4AXuyCiDR3POvZ1A=="],
+
+    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
+
+    "dateformat": ["dateformat@4.6.3", "", {}, "sha512-2P0p0pFGzHS5EMnhdxQi7aJN+iMheud0UhG4dlE1DLAlvL8JHjJJTX/CSm4JXwV0Ka5nGk3zC5mcb5bUQUxxMA=="],
+
+    "dset": ["dset@3.1.4", "", {}, "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA=="],
+
+    "end-of-stream": ["end-of-stream@1.4.5", "", { "dependencies": { "once": "^1.4.0" } }, "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg=="],
+
+    "fast-copy": ["fast-copy@3.0.2", "", {}, "sha512-dl0O9Vhju8IrcLndv2eU4ldt1ftXMqqfgN4H1cpmGV7P6jeB9FwpN9a2c8DPGE1Ys88rNUJVYDHq73CGAGOPfQ=="],
+
+    "fast-redact": ["fast-redact@3.5.0", "", {}, "sha512-dwsoQlS7h9hMeYUq1W++23NDcBLV4KqONnITDV9DjfS3q1SgDGVrBdvvTLUotWtPSD7asWDV9/CmsZPy8Hf70A=="],
+
+    "fast-safe-stringify": ["fast-safe-stringify@2.1.1", "", {}, "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA=="],
+
+    "graphql": ["graphql@16.11.0", "", {}, "sha512-mS1lbMsxgQj6hge1XZ6p7GPhbrtFwUFYi3wRzXAC/FmYnyXMTvvI3td3rjmQ2u8ewXueaSvRPWaEcgVVOT9Jnw=="],
+
+    "graphql-yoga": ["graphql-yoga@5.15.1", "", { "dependencies": { "@envelop/core": "^5.3.0", "@envelop/instrumentation": "^1.0.0", "@graphql-tools/executor": "^1.4.0", "@graphql-tools/schema": "^10.0.11", "@graphql-tools/utils": "^10.6.2", "@graphql-yoga/logger": "^2.0.1", "@graphql-yoga/subscription": "^5.0.5", "@whatwg-node/fetch": "^0.10.6", "@whatwg-node/promise-helpers": "^1.2.4", "@whatwg-node/server": "^0.10.5", "dset": "^3.1.4", "lru-cache": "^10.0.0", "tslib": "^2.8.1" }, "peerDependencies": { "graphql": "^15.2.0 || ^16.0.0" } }, "sha512-wCSnviFFGC4CF9lyeRNMW1p55xVWkMRLPu9iHYbBd8WCJEjduDTo3nh91sVktpbJdUQ6rxNBN6hhpTYMFZuMwg=="],
+
+    "help-me": ["help-me@5.0.0", "", {}, "sha512-7xgomUX6ADmcYzFik0HzAxh/73YlKR9bmFzf51CZwR+b6YtzU2m0u49hQCqV6SvlqIqsaxovfwdvbnsw3b/zpg=="],
+
+    "joycon": ["joycon@3.1.1", "", {}, "sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw=="],
+
+    "lru-cache": ["lru-cache@10.4.3", "", {}, "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ=="],
+
+    "minimist": ["minimist@1.2.8", "", {}, "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA=="],
+
+    "on-exit-leak-free": ["on-exit-leak-free@2.1.2", "", {}, "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA=="],
+
+    "once": ["once@1.4.0", "", { "dependencies": { "wrappy": "1" } }, "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w=="],
+
+    "pino": ["pino@9.9.0", "", { "dependencies": { "atomic-sleep": "^1.0.0", "fast-redact": "^3.1.1", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^2.0.0", "pino-std-serializers": "^7.0.0", "process-warning": "^5.0.0", "quick-format-unescaped": "^4.0.3", "real-require": "^0.2.0", "safe-stable-stringify": "^2.3.1", "sonic-boom": "^4.0.1", "thread-stream": "^3.0.0" }, "bin": { "pino": "bin.js" } }, "sha512-zxsRIQG9HzG+jEljmvmZupOMDUQ0Jpj0yAgE28jQvvrdYTlEaiGwelJpdndMl/MBuRr70heIj83QyqJUWaU8mQ=="],
+
+    "pino-abstract-transport": ["pino-abstract-transport@2.0.0", "", { "dependencies": { "split2": "^4.0.0" } }, "sha512-F63x5tizV6WCh4R6RHyi2Ml+M70DNRXt/+HANowMflpgGFMAym/VKm6G7ZOQRjqN7XbGxK1Lg9t6ZrtzOaivMw=="],
+
+    "pino-pretty": ["pino-pretty@13.1.1", "", { "dependencies": { "colorette": "^2.0.7", "dateformat": "^4.6.3", "fast-copy": "^3.0.2", "fast-safe-stringify": "^2.1.1", "help-me": "^5.0.0", "joycon": "^3.1.1", "minimist": "^1.2.6", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^2.0.0", "pump": "^3.0.0", "secure-json-parse": "^4.0.0", "sonic-boom": "^4.0.1", "strip-json-comments": "^5.0.2" }, "bin": { "pino-pretty": "bin.js" } }, "sha512-TNNEOg0eA0u+/WuqH0MH0Xui7uqVk9D74ESOpjtebSQYbNWJk/dIxCXIxFsNfeN53JmtWqYHP2OrIZjT/CBEnA=="],
+
+    "pino-std-serializers": ["pino-std-serializers@7.0.0", "", {}, "sha512-e906FRY0+tV27iq4juKzSYPbUj2do2X2JX4EzSca1631EB2QJQUqGbDuERal7LCtOpxl6x3+nvo9NPZcmjkiFA=="],
+
+    "process-warning": ["process-warning@5.0.0", "", {}, "sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA=="],
+
+    "pump": ["pump@3.0.3", "", { "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" } }, "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA=="],
+
+    "quick-format-unescaped": ["quick-format-unescaped@4.0.4", "", {}, "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg=="],
+
+    "real-require": ["real-require@0.2.0", "", {}, "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg=="],
+
+    "reflect-metadata": ["reflect-metadata@0.2.2", "", {}, "sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q=="],
+
+    "safe-stable-stringify": ["safe-stable-stringify@2.5.0", "", {}, "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA=="],
+
+    "secure-json-parse": ["secure-json-parse@4.0.0", "", {}, "sha512-dxtLJO6sc35jWidmLxo7ij+Eg48PM/kleBsxpC8QJE0qJICe+KawkDQmvCMZUr9u7WKVHgMW6vy3fQ7zMiFZMA=="],
+
+    "sonic-boom": ["sonic-boom@4.2.0", "", { "dependencies": { "atomic-sleep": "^1.0.0" } }, "sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww=="],
+
+    "split2": ["split2@4.2.0", "", {}, "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg=="],
+
+    "strip-json-comments": ["strip-json-comments@5.0.3", "", {}, "sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw=="],
+
+    "thread-stream": ["thread-stream@3.1.0", "", { "dependencies": { "real-require": "^0.2.0" } }, "sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A=="],
+
+    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "typescript": ["typescript@5.9.2", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A=="],
+
+    "undici-types": ["undici-types@7.10.0", "", {}, "sha512-t5Fy/nfn+14LuOc2KNYg75vZqClpAiqscVvMygNnlsHBFpSXdJaYtXMcdNLpl/Qvc3P2cB3s6lOV51nqsFq4ag=="],
+
+    "urlpattern-polyfill": ["urlpattern-polyfill@10.1.0", "", {}, "sha512-IGjKp/o0NL3Bso1PymYURCJxMPNAf/ILOpendP9f5B6e1rTJgdgiOvgfoT8VxCAdY+Wisb9uhGaJJf3yZ2V9nw=="],
+
+    "wrappy": ["wrappy@1.0.2", "", {}, "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="],
+
+    "zod": ["zod@4.1.5", "", {}, "sha512-rcUUZqlLJgBC33IT3PNMgsCq6TzLQEG/Ei/KTCU0PedSWRMAXoOUN+4t/0H+Q8bdnLPdqUYnvboJT0bn/229qg=="],
+  }
+}

package/core/App.ts

@@ -0,0 +1,81 @@
+import ApplicationLifecycle, {ApplicationPhase} from "core/ApplicationLifecycle";
+import { HasValidBaseTable, PrepareDatabase } from "database/DatabaseHelper";
+import ComponentRegistry from "core/ComponentRegistry";
+import { logger } from "core/Logger";
+import { createYogaInstance } from "gql";
+import ServiceRegistry from "service/ServiceRegistry";
+
+export default class App {
+    private yoga: any;
+
+    constructor() {
+        this.init();
+    }
+
+    async init() {
+        logger.trace(`Initializing App`);
+        ComponentRegistry.init();
+        ServiceRegistry.init();
+        if(ApplicationLifecycle.getCurrentPhase() === ApplicationPhase.DATABASE_INITIALIZING) {
+            if(!await HasValidBaseTable()) {
+                await PrepareDatabase();
+            }
+            logger.trace(`Database prepared...`);
+            ApplicationLifecycle.setPhase(ApplicationPhase.DATABASE_READY);
+        }
+
+        ApplicationLifecycle.addPhaseListener((event) => {
+            const phase = event.detail;
+            logger.info(`Application phase changed to: ${phase}`);
+            switch(phase) {
+                case ApplicationPhase.DATABASE_READY: {
+                    break;
+                }
+                case ApplicationPhase.COMPONENTS_READY: {
+                    ApplicationLifecycle.setPhase(ApplicationPhase.SYSTEM_REGISTERING);
+                    break;
+                }
+                case ApplicationPhase.SYSTEM_READY: {
+                    try {
+                        const schema = ServiceRegistry.getSchema();
+                        if (schema) {
+                            this.yoga = createYogaInstance(schema);
+                        } else {
+                            this.yoga = createYogaInstance();
+                        }
+                        ApplicationLifecycle.setPhase(ApplicationPhase.APPLICATION_READY);
+                    } catch (error) {
+                        logger.error("Error during SYSTEM_READY phase:");
+                        logger.error(error);
+                    }
+                    break;
+                }
+                case ApplicationPhase.APPLICATION_READY: {
+                    if(process.env.NODE_ENV !== "test") {
+                        this.start();
+                    }
+                    break;
+                }
+            }
+        });
+    }
+
+    waitForAppReady(): Promise<void> {
+        return new Promise(resolve => {
+            const interval = setInterval(() => {
+                if (ApplicationLifecycle.getCurrentPhase() === ApplicationPhase.APPLICATION_READY) {
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 100);
+        });
+    }
+
+    async start() {
+        logger.info("Application Started");
+        const server = Bun.serve({
+            fetch: this.yoga
+        });
+        logger.info(`Server is running on ${new URL(this.yoga.graphqlEndpoint, `http://${server.hostname}:${server.port}`)}`)
+    }
+}

package/core/ApplicationLifecycle.ts

@@ -0,0 +1,57 @@
+
+export enum ApplicationPhase {
+    DATABASE_INITIALIZING = "database_initializing",
+    DATABASE_READY = "database_ready",
+    COMPONENTS_REGISTERING = "components_registering",
+    COMPONENTS_READY = "components_ready",
+    SYSTEM_REGISTERING = "system_registering",
+    SYSTEM_READY = "system_ready",
+    APPLICATION_READY = "application_ready"
+}
+
+export interface PhaseChangeEvent extends CustomEvent {
+    detail: ApplicationPhase;
+}
+
+
+class ApplicationLifecycle {
+    static #instance : ApplicationLifecycle;
+    constructor() {
+    }
+
+    public static get instance(): ApplicationLifecycle {
+        if(ApplicationLifecycle.#instance === undefined) {
+            ApplicationLifecycle.#instance = new ApplicationLifecycle();
+        }
+        return ApplicationLifecycle.#instance;
+    }
+
+    private eventEmitter = new EventTarget();
+    private currentPhase = ApplicationPhase.DATABASE_INITIALIZING;
+
+
+    async waitForPhase(phase: ApplicationPhase): Promise<void> {
+        while (this.currentPhase !== phase) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+    }
+
+    addPhaseListener(listener: (event: PhaseChangeEvent) => void) {
+        this.eventEmitter.addEventListener("phaseChanged", listener as EventListener);
+        return listener;
+    }
+
+    removePhaseListener(listener: (event: PhaseChangeEvent) => void) {
+        this.eventEmitter.removeEventListener("phaseChanged", listener as EventListener);
+    }
+
+    setPhase(phase: ApplicationPhase) {
+        this.currentPhase = phase;
+        this.eventEmitter.dispatchEvent(new CustomEvent("phaseChanged", { detail: phase }));
+    }
+    getCurrentPhase() {
+        return this.currentPhase;
+    }
+}
+
+export default ApplicationLifecycle.instance;

package/core/ComponentRegistry.ts

@@ -0,0 +1,116 @@
+import { generateTypeId, type BaseComponent } from "./Components";
+import ApplicationLifecycle, { ApplicationPhase } from "./ApplicationLifecycle";
+import { CreateComponentPartitionTable } from "database/DatabaseHelper";
+import { GetSchema } from "database/DatabaseHelper";
+import { logger as MainLogger } from "./Logger";
+const logger = MainLogger.child({ scope: "ComponentRegistry" });
+
+class ComponentRegistry {
+    static #instance: ComponentRegistry;
+    private componentQueue = new Map<string, new () => BaseComponent>();
+    private currentTables: string[] = [];
+    private componentsMap = new Map<string, string>();
+    private typeIdToCtor = new Map<string, new () => BaseComponent>();
+    private instantRegister: boolean = false;
+
+    constructor() {
+        
+    }
+
+    public init() {
+        ApplicationLifecycle.addPhaseListener(async (event) => {
+            if(event.detail === ApplicationPhase.DATABASE_READY) {
+                logger.trace("Registering Components...");
+                ApplicationLifecycle.setPhase(ApplicationPhase.COMPONENTS_REGISTERING);
+                logger.trace(`Total Components to register: ${this.componentQueue.size}`);
+                await this.populateCurrentTables();
+                await this.registerAllComponents();
+                this.instantRegister = true;
+            }
+        });
+    }
+
+    public static get instance(): ComponentRegistry {
+        if (!this.#instance) {
+            this.#instance = new ComponentRegistry();
+        }
+        return this.#instance;
+    }
+
+    private async populateCurrentTables() {
+        try {
+            this.currentTables = await GetSchema();
+        } catch (error) {
+            logger.warn(`Failed to populate current tables: ${error}`);
+            this.currentTables = [];
+        }
+    }
+
+    define(
+        name: string,
+        ctor: new () => BaseComponent
+    ) {
+        if(!this.instantRegister) {
+            if(!this.componentQueue.has(name)) {
+                this.componentQueue.set(name, ctor);
+                return;
+            }
+        }
+        if(this.instantRegister) {
+            if(this.componentsMap.has(name)) {
+                logger.trace(`Component already registered: ${name}`);
+                return;
+            }
+            this.register(name, generateTypeId(name), ctor);
+        }
+    }
+
+    componentSize() {
+        return this.componentQueue.size;
+    }
+
+    isComponentReady(name: string): boolean {
+        return this.componentsMap.has(name);
+    }
+
+    getComponentId(name: string) {
+        return this.componentsMap.get(name);
+    }
+
+    getConstructor(typeId: string) {
+        return this.typeIdToCtor.get(typeId);
+    }
+
+    async registerAllComponents(): Promise<void> {
+        logger.trace(`Registering all components`);
+        for(const [name, ctor] of this.componentQueue) {
+            const typeId = generateTypeId(name);
+            await this.register(name, typeId, ctor);
+        }
+        ApplicationLifecycle.setPhase(ApplicationPhase.COMPONENTS_READY);
+    }
+
+    register(name: string, typeid: string, ctor: new () => BaseComponent) {
+        return new Promise<boolean>(async resolve => {
+            const partitionTableName = `components_${this.sluggifyName(name)}`;
+            await this.populateCurrentTables();
+            if (!this.currentTables.includes(partitionTableName)) {
+                logger.trace(`Partition table ${partitionTableName} does not exist. Creating... name: ${name}, typeId: ${typeid}`);
+                const instance = new ctor();
+                const indexedProps = instance.indexedProperties();
+                await CreateComponentPartitionTable(name, typeid, indexedProps);
+                await this.populateCurrentTables();
+            }
+            this.componentsMap.set(name, typeid);
+            this.typeIdToCtor.set(typeid, ctor);
+            resolve(true);
+        });
+    }
+
+
+    private sluggifyName(name: string) {
+        return name.toLowerCase().replace(/\s+/g, '_');
+    }
+}
+
+export default ComponentRegistry.instance;

package/core/Components.ts

@@ -0,0 +1,124 @@
+import { createHash } from 'crypto';
+import "reflect-metadata";
+import { logger as MainLogger } from "./Logger";
+import ComponentRegistry from "./ComponentRegistry";
+import { uuidv7 } from 'utils/uuid';
+const logger = MainLogger.child({ scope: "Components" });
+
+export function generateTypeId(name: string): string {
+  return createHash('sha256').update(name).digest('hex');
+}
+
+export function CompData(options?: { indexed?: boolean }) {
+    return Reflect.metadata("compData", { isData: true, indexed: options?.indexed ?? false });
+}
+
+// Type helper to extract only data properties (excludes methods and private properties)
+export type ComponentDataType<T extends BaseComponent> = {
+    [K in keyof T as T[K] extends Function ? never : 
+                    K extends `_${string}` ? never : 
+                    K extends 'id' | 'getTypeID' | 'properties' | 'data' | 'save' | 'insert' | 'update' ? never : 
+                    K]: T[K];
+};
+
+export function Component(target: any) {
+    ComponentRegistry.define(target.name, target);
+    return target;
+}
+
+export class BaseComponent {
+    public id: string = "";
+    protected _comp_name: string = "";
+    protected _typeId: string = "";
+    protected _persisted: boolean = false;
+    protected _dirty: boolean = false;
+
+    constructor() {
+        this._comp_name = this.constructor.name;
+        this._typeId = ComponentRegistry.getComponentId(this._comp_name) || generateTypeId(this._comp_name);
+        this._dirty = false;
+    }
+
+    getTypeID(): string {
+        return this._typeId;
+    }
+
+    properties(): string[] {
+        return Object.keys(this).filter(prop => {
+            const meta = Reflect.getMetadata("compData", this, prop);
+            return meta && meta.isData;
+        });
+    }
+
+    /**
+     * Get data for this component
+     * @returns Object containing only properties marked with @CompData decorator
+     */
+    data<T extends this>(): ComponentDataType<T> {
+        const data: Record<string, any> = {};
+        this.properties().forEach((prop: string) => {
+            data[prop] = (this as any)[prop];
+        });
+        return data as ComponentDataType<T>;
+    }
+
+    async save(trx: Bun.SQL, entity_id: string) {
+        logger.trace(`Saving component ${this._comp_name} for entity ${entity_id}`);
+        logger.trace(`Checking is Component can be saved (is registered)`);
+        await new Promise(resolve => {
+            if(ComponentRegistry.isComponentReady(this._comp_name)) {
+                resolve(true);
+            } else {
+                const interval = setInterval(() => {
+                    if (ComponentRegistry.isComponentReady(this._comp_name)) {
+                        clearInterval(interval);
+                        resolve(true);
+                    }
+                }, 100);
+            }
+        });
+        logger.trace(`Component Registered`);
+        if(this._persisted) {
+            await this.update(trx);
+        } else {
+            await this.insert(trx, entity_id);
+            this._persisted = true;
+        }
+    }
+
+    async insert(trx: Bun.SQL, entity_id: string) {
+        if(this.id === "") {
+            this.id = uuidv7();
+        }
+        await trx`INSERT INTO components 
+        (id, entity_id, name, type_id, data)
+        VALUES (${this.id}, ${entity_id}, ${this._comp_name}, ${this._typeId}, ${this.data()})`
+        await trx`INSERT INTO entity_components (entity_id, type_id) VALUES (${entity_id}, ${this._typeId}) ON CONFLICT DO NOTHING`
+    }
+
+    async update(trx: Bun.SQL) {
+        if(this.id === "") {
+            throw new Error("Component must have an ID to be updated");
+        }
+        await trx`UPDATE components SET data = ${this.data()} WHERE id = ${this.id}`
+    }
+
+    public setPersisted(persisted: boolean) {
+        this._persisted = persisted;
+    }
+
+    public setDirty(dirty: boolean) {
+        this._dirty = dirty;
+    }
+
+    indexedProperties(): string[] {
+        return Object.keys(this).filter(prop => {
+            const meta = Reflect.getMetadata("compData", this, prop);
+            return meta && meta.isData && meta.indexed;
+        });
+    }
+}
+
+export type ComponentGetter<T extends BaseComponent> = Pick<T, "properties" | "id"> & {
+    data(): ComponentDataType<T>;
+};

package/core/Decorators.ts

@@ -0,0 +1,20 @@
+export function log(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+  const originalMethod = descriptor.value;
+
+  descriptor.value = function(...args: any[]) {
+    console.log(`Calling ${propertyKey} with:`, args);
+    return originalMethod.apply(this, args);
+  };
+}
+
+export function timed(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+  const originalMethod = descriptor.value;
+
+  descriptor.value = async function(...args: any[]) {
+    const start = performance.now();
+    const result = await originalMethod.apply(this, args);
+    const end = performance.now();
+    console.log(`Execution time for ${propertyKey}: ${end - start} ms`);
+    return result;
+  };
+}