@prisma-next/utils 0.8.0 → 0.9.0-dev.2

package/dist/json.d.mts

@@ -0,0 +1,25 @@
+//#region src/json.d.ts
+/**
+ * Structural types for values that can be losslessly round-tripped through
+ * `JSON.stringify` / `JSON.parse`.
+ *
+ * These are *structural* (no nominal brand): a value satisfying `JsonObject`
+ * is guaranteed only to have JSON-stringifiable shape, not to carry any
+ * particular semantic identity. Use these as the type of opaque "JSON-shaped"
+ * data crossing API boundaries when the consumer needs the JSON-cleanness
+ * promise but does not need a domain-specific shape.
+ *
+ * Notable consumers of `JsonObject` include the framework's
+ * `ContractSerializer` SPI: `serializeContract` returns `JsonObject` so that
+ * call sites can stringify, hash, or feed the result into another SPI without
+ * re-asserting JSON-cleanness.
+ */
+type JsonPrimitive = string | number | boolean | null;
+type JsonArray = readonly JsonValue[];
+type JsonObject = {
+  readonly [key: string]: JsonValue;
+};
+type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+//#endregion
+export { type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue };
+//# sourceMappingURL=json.d.mts.map

package/dist/json.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.mts","names":[],"sources":["../src/json.ts"],"mappings":";;AAgBA;;;;;AAEA;;;;;AAEA;;;;KAJY,aAAA;AAAA,KAEA,SAAA,YAAqB,SAAA;AAAA,KAErB,UAAA;EAAA,UAAyB,GAAA,WAAc,SAAA;AAAA;AAAA,KAEvC,SAAA,GAAY,aAAA,GAAgB,SAAA,GAAY,UAAA"}

package/dist/json.mjs

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@prisma-next/utils",
-  "version": "0.8.0",
+  "version": "0.9.0-dev.2",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "Shared utility functions for Prisma Next",
   "devDependencies": {
-    "@prisma-next/tsconfig": "0.8.0",
-    "@prisma-next/tsdown": "0.8.0",
+    "@prisma-next/tsconfig": "0.9.0-dev.2",
+    "@prisma-next/tsdown": "0.9.0-dev.2",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
     "vitest": "4.1.5"
@@ -26,6 +26,7 @@
     "./canonical-stringify": "./dist/canonical-stringify.mjs",
     "./defined": "./dist/defined.mjs",
     "./hash-content": "./dist/hash-content.mjs",
+    "./json": "./dist/json.mjs",
     "./redact-db-url": "./dist/redact-db-url.mjs",
     "./result": "./dist/result.mjs",
     "./simplify-deep": "./dist/simplify-deep.mjs",

package/src/exports/json.ts

@@ -0,0 +1 @@
+export type { JsonArray, JsonObject, JsonPrimitive, JsonValue } from '../json';

package/src/json.ts

@@ -0,0 +1,23 @@
+/**
+ * Structural types for values that can be losslessly round-tripped through
+ * `JSON.stringify` / `JSON.parse`.
+ *
+ * These are *structural* (no nominal brand): a value satisfying `JsonObject`
+ * is guaranteed only to have JSON-stringifiable shape, not to carry any
+ * particular semantic identity. Use these as the type of opaque "JSON-shaped"
+ * data crossing API boundaries when the consumer needs the JSON-cleanness
+ * promise but does not need a domain-specific shape.
+ *
+ * Notable consumers of `JsonObject` include the framework's
+ * `ContractSerializer` SPI: `serializeContract` returns `JsonObject` so that
+ * call sites can stringify, hash, or feed the result into another SPI without
+ * re-asserting JSON-cleanness.
+ */
+
+export type JsonPrimitive = string | number | boolean | null;
+
+export type JsonArray = readonly JsonValue[];
+
+export type JsonObject = { readonly [key: string]: JsonValue };
+
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;