@crustjs/store 0.4.4 → 0.5.0

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import { JsonCompatible } from "@crustjs/utils/json";
 import { BaseValueType, ResolvePrimitive } from "@crustjs/utils/primitive";
 import { InferOutput, StandardSchema } from "@crustjs/utils/schema";
-//#region src/types.d.ts
 /** Supported type literals for store fields. */
 type ValueType = BaseValueType;
 /** Shared fields present on every store field definition. */
@@ -109,8 +108,10 @@ type FieldDef = StringFieldDef | NumberFieldDef | BooleanFieldDef | StringArrayF
 /** Record mapping field names to their definitions. */
 type FieldsDef = Record<string, FieldDef>;
 type JsonCompatibleFields<F extends FieldsDef> = { [K in keyof F]: F[K] extends {
-  schema: StandardSchema<unknown, infer Output>;
-} ? Exclude<Output, undefined> extends JsonCompatible<Exclude<Output, undefined>> ? F[K] : never : F[K]; };
+  schema: infer S extends StandardSchema;
+} ? Exclude<InferOutput<S>, undefined> extends JsonCompatible<Exclude<InferOutput<S>, undefined>> ? F[K] : F[K] & {
+  readonly FIX_JSON_OUTPUT: "store schema output must be JSON-compatible data (no Date, Map, bigint, or functions)";
+} : F[K]; };
 /**
  * Infer the resolved type for a single field definition.
  *
@@ -350,8 +351,6 @@ interface Store<TConfig> {
    */
   reset(): Promise<void>;
 }
-//#endregion
-//#region src/errors.d.ts
 /**
  * Contextual details attached to an `IO` error.
  *
@@ -464,8 +463,6 @@ export declare class CrustStoreError<C extends StoreErrorCode = StoreErrorCode>
    */
   is<T extends StoreErrorCode>(code: T): this is CrustStoreError<T>;
 }
-//#endregion
-//#region src/path.d.ts
 /**
  * Encapsulates runtime environment values needed for path resolution.
  *
@@ -584,8 +581,6 @@ export declare function stateDir(appName: string, env?: PlatformEnv): string;
  * ```
  */
 export declare function cacheDir(appName: string, env?: PlatformEnv): string;
-//#endregion
-//#region src/store.d.ts
 /**
  * Creates a typed async config store backed by a local JSON file.
  *
@@ -623,5 +618,4 @@ export declare function cacheDir(appName: string, env?: PlatformEnv): string;
  * ```
  */
 export declare function createStore<const F extends FieldsDef>(options: CreateStoreOptions<F>): Store<InferStoreConfig<F>>;
-//#endregion
 export type { CreateStoreOptions, FieldDef, FieldsDef, InferStoreConfig, PlatformEnv, Store, StoreAccess, StoreErrorCode, StorePermissionBits, StoreUpdater, StoreValidatorIssue, ValidationErrorDetails, ValueType };

package/dist/index.js

@@ -1,12 +1,12 @@
 import { homedir } from "node:os";
-import { dirname, join, win32 } from "node:path";
+import { dirname, join, posix, win32 } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { isJsonObject } from "@crustjs/utils/json";
 import { coerceBooleanString, tryCoerceNumber } from "@crustjs/utils/primitive";
 import { normalizeStandardIssues } from "@crustjs/utils/schema";
 import { chmod, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { isErrnoException } from "@crustjs/utils/error";
-//#region src/errors.ts
+// src/errors.ts
 /**
 * A typed error thrown by `@crustjs/store` for path, parse, IO, and validation failures.
 *
@@ -56,8 +56,7 @@ var CrustStoreError = class extends Error {
 		return Object.is(this.code, code);
 	}
 };
-//#endregion
-//#region src/path.ts
+// src/path.ts
 /**
 * Returns the current runtime environment for path resolution.
 *
@@ -119,7 +118,7 @@ function resolvePlatformDir(kind, appName, env = getRuntimeEnv()) {
 	const config = DIRECTORY_CONFIG[kind];
 	if (env.platform === "linux" || env.platform === "darwin") {
 		const configured = env.env[config.xdg];
-		const base = configured?.trim() ? configured : join(env.homedir, ...config.unixFallback);
+		const base = configured && posix.isAbsolute(configured) ? configured : join(env.homedir, ...config.unixFallback);
 		return join(base, appName);
 	}
 	if (env.platform === "win32") {
@@ -258,8 +257,7 @@ function resolveStorePath(dirPath, name) {
 	validateSegment(name, "name");
 	return join(dirPath, `${name}.json`);
 }
-//#endregion
-//#region src/merge.ts
+// src/merge.ts
 /**
 * Sets an own enumerable data property. Plain assignment would invoke the
 * inherited `__proto__` setter instead of storing a `__proto__` field.
@@ -299,8 +297,7 @@ function applyFieldDefaults(persisted, fields, pruneUnknown = true) {
 	}
 	return result;
 }
-//#endregion
-//#region src/persistence.ts
+// src/persistence.ts
 /**
 * Reads and parses a JSON config file from disk.
 *
@@ -415,8 +412,7 @@ async function deleteJson(filePath) {
 		}, err);
 	}
 }
-//#endregion
-//#region src/store.ts
+// src/store.ts
 function makeSchemaValidator(schema) {
 	return async (value) => {
 		const result = await schema["~standard"].validate(value);
@@ -653,5 +649,4 @@ function createStore(options) {
 		reset
 	};
 }
-//#endregion
 export { CrustStoreError, cacheDir, configDir, createStore, dataDir, stateDir };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crustjs/store",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "Typed JSON persistence for CLI config, data, state, and cache files",
   "type": "module",
   "sideEffects": false,
@@ -40,12 +40,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@crustjs/utils": "^0.2.2"
+    "@crustjs/utils": "^0.3.0"
   },
   "devDependencies": {
     "@crustjs/config": "0.0.0",
-    "zod": "^4.6.5",
-    "vite-plus": "1.0.0"
+    "zod": "^4.6.7",
+    "vite-plus": "1.4.0"
   },
   "peerDependencies": {
     "typescript": "^7.0.0"
@@ -57,8 +57,7 @@
   },
   "engines": {
     "bun": ">=1.4.0",
-    "node": ">=24",
-    "deno": ">=2.8"
+    "node": ">=24"
   },
   "scripts": {
     "build": "vp run build:task",