@azure-net/node-kit 0.1.0 → 0.1.2

package/VALIDATION.md

@@ -726,6 +726,7 @@ existence, ownership, authenticity, allocation, or reachability checks.
 | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `email(o?)`                            | ASCII dot-atom local part up to 64 characters, dotted DNS domain, total up to 254; not all RFC 5322 mailboxes, no quoted local parts or deliverability check |
 | `uuid(o?)`                             | RFC 9562 versions 1-8; `UuidOptions.version` restricts version; unrestricted also accepts Nil/Max UUIDs; case-insensitive                                    |
+| `nonEmptyUuid(o?)` | Like `uuid`, but rejects `00000000-0000-0000-0000-000000000000`; accepts `UuidOptions`, including version and custom message. |
 | `guid(o?)`                             | Hyphenated `8-4-4-4-12` hex shape without UUID version/variant constraints                                                                                   |
 | `url(o?)`                              | Absolute WHATWG URL, including non-HTTP schemes; `UrlOptions.protocol`/`hostname` RegExp filters                                                             |
 | `httpUrl(o?)`                          | HTTP/HTTPS with explicit `://` and hostname; same URL filters; localhost/IPs can pass                                                                        |

package/dist/infrastructure/environment/Env.d.ts

@@ -11,9 +11,9 @@ export interface EnvParseOptions<T> extends EnvGetOptions {
     parse: (context: EnvParseContext) => T;
 }
 /** Reads the supplied object on each get; never reads process.env implicitly. */
-export declare class Env {
+export declare class Env<TKey extends string = string> {
     private readonly values;
     constructor(values: EnvValues);
-    get<T>(name: string, options: EnvParseOptions<T>): T;
-    get(name: string, options?: EnvGetOptions): string;
+    get<T>(name: TKey, options: EnvParseOptions<T>): T;
+    get(name: TKey, options?: EnvGetOptions): string;
 }

package/dist/validation/messages/En.js

@@ -84,6 +84,7 @@ export const validationMessagesEn = Object.freeze({
     uppercase: "Must be uppercase.",
     email: "Must be a valid email address.",
     uuid: "Must be a valid UUID.",
+    nonEmptyUuid: "Must be a valid non-empty UUID.",
     guid: "Must be a valid GUID.",
     url: "Must be a valid absolute URL.",
     httpUrl: "Must be a valid HTTP or HTTPS URL.",

package/dist/validation/messages/Ru.js

@@ -84,6 +84,7 @@ export const validationMessagesRu = Object.freeze({
     uppercase: "Строка должна быть в верхнем регистре.",
     email: "Некорректный адрес электронной почты.",
     uuid: "Некорректный UUID.",
+    nonEmptyUuid: "Требуется корректный ненулевой UUID.",
     guid: "Некорректный GUID.",
     url: "Некорректный абсолютный URL.",
     httpUrl: "Некорректный HTTP или HTTPS URL.",

package/dist/validation/rules/StringRules.d.ts

@@ -30,11 +30,6 @@ export interface IsoDateTimeOptions extends IsoTimeOptions {
     readonly local?: boolean;
 }
 export type HashAlgorithm = "md5" | "sha1" | "sha256" | "sha384" | "sha512";
-/**
- * Noncoercive format checks. Format scope was reviewed against Zod 4.6.7's
- * src/v4/core/{regexes,schemas}.ts (MIT, Colin McDonnell and contributors).
- * Implementations below are independent; no Zod runtime dependency is required.
- */
 export declare const stringRules: {
     string(options?: RuleOptions): BuiltinRule<string>;
     /** Strings count Unicode code points by default, arrays count elements, maps/sets count entries. */
@@ -52,6 +47,8 @@ export declare const stringRules: {
     email(options?: RuleOptions): BuiltinRule<string>;
     /** RFC 9562 versions 1-8 and, without a version filter, Nil/Max UUIDs. */
     uuid(options?: UuidOptions): BuiltinRule<string>;
+    /** A valid UUID excluding the all-zero Nil UUID. */
+    nonEmptyUuid(options?: UuidOptions): BuiltinRule<string>;
     guid(options?: RuleOptions): BuiltinRule<string>;
     /** Absolute WHATWG URLs, including non-HTTP schemes; not a safe-URL/security policy. */
     url(options?: UrlOptions): BuiltinRule<string>;

package/dist/validation/rules/StringRules.js

@@ -174,6 +174,18 @@ let currencies;
  * src/v4/core/{regexes,schemas}.ts (MIT, Colin McDonnell and contributors).
  * Implementations below are independent; no Zod runtime dependency is required.
  */
+function uuidRule(options, nonNil) {
+    checkOptions(options);
+    const version = options.version;
+    if (version !== undefined &&
+        (!Number.isInteger(version) || version < 1 || version > 8))
+        throw new RangeError("UUID version must be 1 through 8.");
+    const normal = full(`[0-9a-f]{8}-[0-9a-f]{4}-${version ?? "[1-8]"}[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}`, "i");
+    return format(nonNil ? "nonEmptyUuid" : "uuid", (value) => normal.test(value) ||
+        (version === undefined &&
+            ((!nonNil && value === "00000000-0000-0000-0000-000000000000") ||
+                value.toLowerCase() === "ffffffff-ffff-ffff-ffff-ffffffffffff")), options, { version: version ?? "any" });
+}
 export const stringRules = {
     string(options = {}) {
         checkOptions(options);
@@ -241,16 +253,11 @@ export const stringRules = {
     },
     /** RFC 9562 versions 1-8 and, without a version filter, Nil/Max UUIDs. */
     uuid(options = {}) {
-        checkOptions(options);
-        const version = options.version;
-        if (version !== undefined &&
-            (!Number.isInteger(version) || version < 1 || version > 8))
-            throw new RangeError("UUID version must be 1 through 8.");
-        const normal = full(`[0-9a-f]{8}-[0-9a-f]{4}-${version ?? "[1-8]"}[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}`, "i");
-        return format("uuid", (value) => normal.test(value) ||
-            (version === undefined &&
-                (value === "00000000-0000-0000-0000-000000000000" ||
-                    value.toLowerCase() === "ffffffff-ffff-ffff-ffff-ffffffffffff")), options, { version: version ?? "any" });
+        return uuidRule(options, false);
+    },
+    /** A valid UUID excluding the all-zero Nil UUID. */
+    nonEmptyUuid(options = {}) {
+        return uuidRule(options, true);
     },
     guid(options = {}) {
         return pattern("guid", "[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}", options, "i");

package/dist/validation/rules/index.d.ts

@@ -44,6 +44,7 @@ export declare const rules: Readonly<{
     uppercase(options?: RuleOptions): BuiltinRule<string>;
     email(options?: RuleOptions): BuiltinRule<string>;
     uuid(options?: import("./StringRules.js").UuidOptions): BuiltinRule<string>;
+    nonEmptyUuid(options?: import("./StringRules.js").UuidOptions): BuiltinRule<string>;
     guid(options?: RuleOptions): BuiltinRule<string>;
     url(options?: import("./StringRules.js").UrlOptions): BuiltinRule<string>;
     httpUrl(options?: import("./StringRules.js").UrlOptions): BuiltinRule<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-net/node-kit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Framework-independent Node.js toolkit for the Azure-net ecosystem",
   "type": "module",
   "license": "MIT",