@jnode/db 1.0.0 → 1.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,13 @@
+# Contributing to JNode packages
+
+Hello there! Welcome to the contributing guildlines!
+
+I was a bit surprised to see you here, especially since we’re not as well-known right now, and our packages are quite straightforward, mainly designed for specific projects.
+
+If you’re here, perhaps you’ve spotted some bugs, security issues, or have an idea for something new. We’re happy to welcome any contributions!
+
+- **Bugs**: If you find any bugs, please let us know.
+- **Security Problems**: If a bug affects the package’s security, please reach out to JustApple via [email](mailto:ja@justapple.tw) or Discord!
+- **Docs and Tutorials**: This is the part I’m most excited about. The docs are mostly generated by Gemini, so they might not be perfectly clear. Feel free to update them while maintaining the Node.js official doc style.
+
+For new features, please always create an issue and wait for our response. Also, please remember to keep the package simple and free from third-party dependencies.

package/README.md

@@ -265,6 +265,7 @@ Access these via `require('@jnode/db/dble')` or `dble.defaultDBLETypes`:
 - `DBLEStringField(maxLength, name, isKey, isRelative)`
 - `DBLEBufferField(maxLength, name, isKey, isRelative)`
 - `DBLEAnyField(length, name, isKey, isRelative)`
+- `DBLEDateField(name, isKey, isRelative)`
 
 *Note: The `maxLength` argument is required for String and Buffer types to enforce DBLE's fixed-length binary schema standard.*
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnode/db",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Simple database package for Node.js.",
   "main": "./src/index.js",
   "exports": {

package/src/dble.js

@@ -1009,6 +1009,26 @@ class DBLEAnyField extends DBLEField {
     }
 }
 
+// Date (8 Bytes in BigUInt64 ms)
+class DBLEDateField extends DBLEField {
+    constructor(name, isKey, isRelative) {
+        super(8, 'Date', name, isKey, isRelative);
+    }
+
+    parse(buf, offset) {
+        return new Date(Number(buf.readBigInt64LE(offset)));
+    }
+
+    write(data, buf = Buffer.alloc(this.length), offset = 0) {
+        buf.writeBigInt64LE(BigInt(data.getTime()), offset);
+        return buf;
+    }
+
+    default() {
+        return new Date();
+    }
+}
+
 // dble default types
 const defaultDBLETypes = {
     Int8: DBLEInt8Field, i8: DBLEInt8Field,
@@ -1023,7 +1043,8 @@ const defaultDBLETypes = {
     Double: DBLEDoubleField, f64: DBLEDoubleField,
     String: DBLEStringField, str: DBLEStringField,
     Buffer: DBLEBufferField, buf: DBLEBufferField,
-    Any: DBLEAnyField, any: DBLEBufferField
+    Any: DBLEAnyField, any: DBLEBufferField,
+    Date: DBLEDateField, date: DBLEDateField
 };
 
 // export
@@ -1035,5 +1056,6 @@ module.exports = {
     DBLEFloatField, DBLEDoubleField,
     DBLEStringField, DBLEBufferField,
     DBLEAnyField,
+    DBLEDateField,
     defaultDBLETypes
 };