@voltro/database 0.6.0 → 0.8.0

package/dist/wire.d.ts

@@ -0,0 +1,44 @@
+import { Schema } from 'effect';
+
+/**
+ * The timestamp mapping as a STANDALONE field schema: `Date` in the
+ * handler, epoch-ms `number` on the wire.
+ *
+ * A `timestamp()` column comes back from the store as a `Date`, and `Date`
+ * is not JSON. Declaring that field `Schema.Number` describes the WIRE type
+ * rather than the domain type — which leaves the schema nothing to convert
+ * and pushes the conversion back into the handler, one `.getTime()` at a
+ * time. Declare this instead and the framework performs the conversion,
+ * because a descriptor's `output` IS the serializer (it is handed to the
+ * rpc as the success schema).
+ *
+ *     output: Schema.Struct({
+ *       id: Schema.String,
+ *       name: Schema.String,
+ *       addedAt: timestampMs,             // Date in, epoch ms on the wire
+ *       archivedAt: timestampMsOrNull,    // for a nullable column
+ *       seenAt: Schema.optional(timestampMs),
+ *     })
+ *
+ * This is the SAME schema `columnSchema` maps a `timestamp()` / `date()`
+ * column to — it reads the value from here — so a hand-written struct and a
+ * derived row can never drift into different wire representations.
+ *
+ * There is deliberately no `timestampMsOptional`: an absent field is
+ * `Schema.optional(timestampMs)`, which composes without a third export.
+ */
+export declare const timestampMs: Schema.Schema<Date, number>;
+
+/**
+ * `timestampMs` for a NULLABLE timestamp column — `Date | null` in the
+ * handler, `number | null` on the wire.
+ *
+ * The mistake this exists to prevent is writing `timestampMs` for a
+ * nullable column and converting by hand at the tail: `new Date(null)` is
+ * 1970-01-01, so a "never archived" row renders as a plausible date
+ * instead of as nothing. Mirrors what `columnSchema` does for a
+ * `.nullable()` timestamp.
+ */
+export declare const timestampMsOrNull: Schema.Schema<Date | null, number | null>;
+
+export { }

package/dist/wire.js

@@ -0,0 +1,5 @@
+import { Schema as e } from "effect";
+//#region src/wire.ts
+var t = e.DateFromNumber, n = e.NullOr(t);
+//#endregion
+export { t as timestampMs, n as timestampMsOrNull };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/database",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Browser-safe schema DSL, query builder, and cross-dialect migration planner for Voltro — one schema, every SQL backend.",
   "keywords": [
     "voltro",
@@ -27,6 +27,11 @@
       "types": "./dist/sql.d.ts",
       "import": "./dist/sql.js",
       "default": "./dist/sql.js"
+    },
+    "./wire": {
+      "types": "./dist/wire.d.ts",
+      "import": "./dist/wire.js",
+      "default": "./dist/wire.js"
     }
   },
   "main": "./dist/index.js",
@@ -38,7 +43,7 @@
   },
   "dependencies": {
     "@effect/sql": "^0.51.1",
-    "@voltro/logger": "0.6.0",
+    "@voltro/logger": "0.8.0",
     "typeid-js": "^1.2.0",
     "ulidx": "^2.4.1"
   },