@demicodes/utils 0.10.3 → 0.11.0

package/dist/index.d.mts

@@ -34,6 +34,8 @@ declare function throwIfAborted(signal: AbortSignal): void;
  * promise is not canceled; this only stops the caller from awaiting it past the abort.
  */
 declare function abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+/** Returns the string `code` of an errno-style error (`ENOENT`, `EEXIST`, …), or null. */
+declare function errorCode(error: unknown): string | null;
 /** Reports whether an unknown thrown value is a file-not-found error (ENOENT). */
 declare function isFileNotFoundError(error: unknown): boolean;
 //#endregion
@@ -68,6 +70,12 @@ declare function encodeUtf8(text: string): Uint8Array;
 declare function decodeUtf8(data: Uint8Array): string;
 /** Returns the UTF-8 byte length of a string. */
 declare function utf8Bytes(text: string): number;
+/** Packs a latin1 byte-string (each char = one byte, 0–255) into bytes. */
+declare function encodeLatin1(text: string): Uint8Array;
+/** Unpacks bytes into a latin1 byte-string (each char = one byte). */
+declare function decodeLatin1(bytes: Uint8Array): string;
+/** Strictly decodes UTF-8; returns null when the bytes are not valid UTF-8. */
+declare function decodeUtf8Strict(bytes: Uint8Array): string | null;
 /** Slices a string by UTF-8 byte offsets, returning the decoded substring. */
 declare function utf8Slice(text: string, start: number, end: number): string;
 /** Concatenates byte chunks into a single `Uint8Array`. */
@@ -90,6 +98,10 @@ declare function tail(text: string, maxChars: number): string;
 declare function shortHash(value: string): string;
 //#endregion
 //#region src/json.d.ts
+/** Values preserved by Demi's transport-neutral portable JSON codec. */
+type PortableJsonValue = null | boolean | number | string | bigint | Uint8Array | readonly PortableJsonValue[] | {
+  readonly [key: string]: PortableJsonValue;
+};
 /** Parses JSON, returning the value, or the original string if it is not valid JSON. */
 declare function parseJsonOrString(value: string): unknown;
 /** Parses JSON and returns it only when it is a plain object; otherwise `null`. */
@@ -125,4 +137,4 @@ declare function isAbsolutePath(path: string): boolean;
 /** Generates a random UUID. */
 declare function createId(): string;
 //#endregion
-export { AbortError, Deferred, abortable, asError, asRecord, asString, base64ToBytes, bytesToBase64, clamp, concatBytes, createId, decodeUtf8, deferred, delay, dirnamePath, encodeUtf8, errorMessage, isAbortError, isAbsolutePath, isFileNotFoundError, isRecord, nonEmptyString, noop, normalizeBaseUrl, normalizePath, numberOrNull, numberOrZero, parseJsonObject, parseJsonOrString, parsePortableJson, safeJsonStringify, shortHash, stringOrNull, stringifyPortableJson, tail, throwIfAborted, truncate, utf8Bytes, utf8Slice, waitFor, withTimeout };
+export { AbortError, Deferred, PortableJsonValue, abortable, asError, asRecord, asString, base64ToBytes, bytesToBase64, clamp, concatBytes, createId, decodeLatin1, decodeUtf8, decodeUtf8Strict, deferred, delay, dirnamePath, encodeLatin1, encodeUtf8, errorCode, errorMessage, isAbortError, isAbsolutePath, isFileNotFoundError, isRecord, nonEmptyString, noop, normalizeBaseUrl, normalizePath, numberOrNull, numberOrZero, parseJsonObject, parseJsonOrString, parsePortableJson, safeJsonStringify, shortHash, stringOrNull, stringifyPortableJson, tail, throwIfAborted, truncate, utf8Bytes, utf8Slice, waitFor, withTimeout };

package/dist/index.mjs

@@ -84,9 +84,15 @@ function abortable(promise, signal) {
 		});
 	});
 }
+/** Returns the string `code` of an errno-style error (`ENOENT`, `EEXIST`, …), or null. */
+function errorCode(error) {
+	if (typeof error !== "object" || error === null) return null;
+	const code = error.code;
+	return typeof code === "string" ? code : null;
+}
 /** Reports whether an unknown thrown value is a file-not-found error (ENOENT). */
 function isFileNotFoundError(error) {
-	return typeof error === "object" && error !== null && error.code === "ENOENT";
+	return errorCode(error) === "ENOENT";
 }
 //#endregion
 //#region src/async.ts
@@ -154,6 +160,27 @@ function decodeUtf8(data) {
 function utf8Bytes(text) {
 	return encoder.encode(text).byteLength;
 }
+/** Packs a latin1 byte-string (each char = one byte, 0–255) into bytes. */
+function encodeLatin1(text) {
+	const out = new Uint8Array(text.length);
+	for (let i = 0; i < text.length; i += 1) out[i] = text.charCodeAt(i) & 255;
+	return out;
+}
+/** Unpacks bytes into a latin1 byte-string (each char = one byte). */
+function decodeLatin1(bytes) {
+	let out = "";
+	const chunk = 32768;
+	for (let i = 0; i < bytes.length; i += chunk) out += String.fromCharCode(...bytes.subarray(i, i + chunk));
+	return out;
+}
+/** Strictly decodes UTF-8; returns null when the bytes are not valid UTF-8. */
+function decodeUtf8Strict(bytes) {
+	try {
+		return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+	} catch {
+		return null;
+	}
+}
 /** Slices a string by UTF-8 byte offsets, returning the decoded substring. */
 function utf8Slice(text, start, end) {
 	if (start <= 0 && end >= utf8Bytes(text)) return text;
@@ -362,4 +389,4 @@ function createId() {
 	return globalThis.crypto.randomUUID();
 }
 //#endregion
-export { AbortError, abortable, asError, asRecord, asString, base64ToBytes, bytesToBase64, clamp, concatBytes, createId, decodeUtf8, deferred, delay, dirnamePath, encodeUtf8, errorMessage, isAbortError, isAbsolutePath, isFileNotFoundError, isRecord, nonEmptyString, noop, normalizeBaseUrl, normalizePath, numberOrNull, numberOrZero, parseJsonObject, parseJsonOrString, parsePortableJson, safeJsonStringify, shortHash, stringOrNull, stringifyPortableJson, tail, throwIfAborted, truncate, utf8Bytes, utf8Slice, waitFor, withTimeout };
+export { AbortError, abortable, asError, asRecord, asString, base64ToBytes, bytesToBase64, clamp, concatBytes, createId, decodeLatin1, decodeUtf8, decodeUtf8Strict, deferred, delay, dirnamePath, encodeLatin1, encodeUtf8, errorCode, errorMessage, isAbortError, isAbsolutePath, isFileNotFoundError, isRecord, nonEmptyString, noop, normalizeBaseUrl, normalizePath, numberOrNull, numberOrZero, parseJsonObject, parseJsonOrString, parsePortableJson, safeJsonStringify, shortHash, stringOrNull, stringifyPortableJson, tail, throwIfAborted, truncate, utf8Bytes, utf8Slice, waitFor, withTimeout };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/utils",
   "description": "Shared zero-dependency utilities for Demi (type guards, errors, async, bytes, strings, paths, JSON).",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.mjs",