@romaintaillandier1978/dotenv-never-lies 1.1.1 → 1.3.0

package/dist/schemas/ip-and-version.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+const ipV4Regex = /^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/;
+const ipV6Regex = /^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/;
+export const looksLikeValidIp = (value) => {
+    return ipV4Regex.test(value) || ipV6Regex.test(value);
+};
+/**
+ * Creates a Zod schema for a IP address. (simple V4 address: 0.0.0.0 or V6 address: 0000:0000:0000:0000:0000:0000:0000:0000).
+ * compressed ip addresses like ::ffff:192.0.2.1 are not supported.
+ * @param name - The name of the environment variable.
+ * @returns A Zod schema for a IP address.
+ */
+export const ipSchema = (name) => {
+    return z.string().transform((v, ctx) => {
+        if (!looksLikeValidIp(v)) {
+            ctx.addIssue({ code: "custom", message: `${name} has invalid value: "${v}"` });
+            return z.NEVER;
+        }
+        return v;
+    });
+};
+/** semver 1.2.3 let it be simple !  no suffixes like -beta, -rc, etc.*/
+const VERSION_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+export const looksLikeValidVersion = (value) => {
+    return VERSION_REGEX.test(value);
+};
+export const versionSchema = (name) => {
+    return z.string().transform((v, ctx) => {
+        if (!VERSION_REGEX.test(v)) {
+            ctx.addIssue({ code: "custom", message: `${name} has invalid value: "${v}"` });
+            return z.NEVER;
+        }
+        return v;
+    });
+};

package/dist/schemas/ip.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const looksLikeValidIp: (value: string) => boolean;
+/**
+ * Creates a Zod schema for a boolean value.
+ * @param name - The name of the boolean value.
+ * @returns A Zod schema for a boolean value.
+ */
+export declare const ipSchema: (name: string) => z.ZodType<string>;
+export declare const looksLikeValidVersion: (value: string) => boolean;
+export declare const versionSchema: (name: string) => z.ZodType<string>;
+//# sourceMappingURL=ip.d.ts.map

package/dist/schemas/ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../../src/schemas/ip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,YAE7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAQvD,CAAC;AAGF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,YAElD,CAAC;AACF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAQ5D,CAAC"}

package/dist/schemas/ip.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+const ipV4Regex = /^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/;
+const ipV6Regex = /^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/;
+export const looksLikeValidIp = (value) => {
+    return ipV4Regex.test(value) || ipV6Regex.test(value);
+};
+/**
+ * Creates a Zod schema for a boolean value.
+ * @param name - The name of the boolean value.
+ * @returns A Zod schema for a boolean value.
+ */
+export const ipSchema = (name) => {
+    return z.string().transform((v, ctx) => {
+        if (!looksLikeValidIp(v)) {
+            ctx.addIssue({ code: "custom", message: `${name} has invalid value: "${v}"` });
+            return z.NEVER;
+        }
+        return v;
+    });
+};
+const VERSION_REGEX = /^(\d+\.\d+\.\d+)$/;
+export const looksLikeValidVersion = (value) => {
+    return VERSION_REGEX.test(value);
+};
+export const versionSchema = (name) => {
+    return z.string().transform((v, ctx) => {
+        if (!VERSION_REGEX.test(v)) {
+            ctx.addIssue({ code: "custom", message: `${name} has invalid value: "${v}"` });
+            return z.NEVER;
+        }
+        return v;
+    });
+};

package/dist/schemas/json.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * Creates a Zod schema for a JSON value.
+ * @param name - The name of the JSON value.
+ * @returns A Zod schema for a JSON value.
+ */
+export declare function jsonSchema(name: string): z.ZodType<unknown>;
+/**
+ * Creates a Zod schema for a JSON value with a specific schema.
+ * @param name - The name of the JSON value.
+ * @param of - The schema used to validate the JSON value.
+ * @returns A Zod schema for a JSON value.
+ */
+export declare function jsonSchema<T>(name: string, of: z.ZodSchema<T>): z.ZodType<T>;
+//# sourceMappingURL=json.d.ts.map

package/dist/schemas/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/schemas/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/schemas/json.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/**
+ * Creates a Zod schema for a JSON value with a specific schema.
+ * @param name - The name of the JSON value.
+ * @param of - The schema used to validate the JSON value.
+ * @returns A Zod schema for a JSON value.
+ */
+export function jsonSchema(name, of) {
+    return z.string().transform((v, ctx) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(v);
+        }
+        catch {
+            ctx.addIssue({
+                code: "custom",
+                message: `${name} is not a valid JSON`,
+            });
+            return z.NEVER;
+        }
+        if (!of) {
+            return parsed;
+        }
+        const result = of.safeParse(parsed);
+        if (!result.success) {
+            ctx.addIssue({
+                code: "custom",
+                message: `${name} does not match expected JSON schema`,
+            });
+            return z.NEVER;
+        }
+        return result.data;
+    });
+}

package/dist/schemas/list.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+/**
+ * Options for the listSchema function. (exemple : "a;b;c")
+ * @template T - The type of the elements in the list.
+ */
+export type SplitterSchemaOptions<T = string> = {
+    /**
+     * The separator used to split the string into a list.
+     */
+    splitter?: string;
+    /**
+     * The schema used to validate the elements in the list.
+     */
+    of?: z.ZodSchema<T>;
+};
+/**
+ * Options for key=value listSchema function. (exemple : "a=b&c=d")
+ * @template T - The type of the elements in the list.
+ */
+export type DoubleSplitterSchemaOptions<T = string> = {
+    /**
+     * first level separator used to split the string into a list.
+     */
+    splitter?: string;
+    /**
+     * The schema used to validate the elements in the list.
+     */
+    of?: {
+        /**
+         * second level separator used to split key-pair.
+         */
+        splitter?: string;
+        /**
+         * The schema used to validate the elements in the list.
+         */
+        of?: z.ZodSchema<T>;
+    };
+};
+/**
+ * Creates a Zod schema for a list of elements.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @param options.splitter - The separator used to split the string into a list. (default: ";")
+ * @param options.of - The schema used to validate the elements in the list. (default: z.string())
+ * @returns A Zod schema for a list of elements.
+ */
+export declare const listSchema: <T = string>(name: string, options?: SplitterSchemaOptions<T>) => z.ZodType<T[]>;
+/**
+ * Creates a Zod schema for a list of URLs.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @returns A Zod schema for a list of URLs.
+ */
+export declare const urlListSchema: (name: string, options?: Omit<SplitterSchemaOptions<string>, "of">) => z.ZodType<string[], unknown, z.core.$ZodTypeInternals<string[], unknown>>;
+/**
+ * Creates a Zod schema for a list of emails.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @returns A Zod schema for a list of emails.
+ */
+export declare const emailListSchema: (name: string, options?: Omit<SplitterSchemaOptions<string>, "of">) => z.ZodType<string[], unknown, z.core.$ZodTypeInternals<string[], unknown>>;
+/**
+ * Creates a Zod schema for a key-value pair.
+ * @param name - The name of the key-value pair.
+ * @param options - The options for the key-value pair schema.
+ * @returns an object with a single key
+ */
+export declare const keyValueSchema: <T = string>(name: string, options?: SplitterSchemaOptions<T>) => z.ZodType<Record<string, T>>;
+/**
+ * Creates a Zod schema for a list of key-value pairs using two separators.
+ * @Example firstname=Romain&lastname=Taillandier
+ * => will be parsed as an array of objects with a single key: [{ firstname: "Romain" }, { lastname: "Taillandier" }]
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @param options.splitter - The separator used to split the string into a list of key-value pairs. (default: "&")
+ * @param options.of - The schema used to validate the key-value pairs. (default: "=")
+ * @returns an array of objects with a single key
+ */
+export declare const keyValueListSchema: <T = string>(name: string, options?: DoubleSplitterSchemaOptions<T>) => z.ZodType<Record<string, T>[]>;
+/**
+ * Creates a Zod schema for a map of key-value pairs using two separators. Duplicate keys are rejected.
+ * @Example firstname=Romain&lastname=Taillandier
+ * => will be parsed as { firstname: "Romain", lastname: "Taillandier" }
+ * @param name - The name of the map.
+ * @param options - The options for the map schema.
+ * @returns a map of key-value pairs
+ */
+export declare const keyValueMapSchema: <T = string>(name: string, options?: DoubleSplitterSchemaOptions<T>) => z.ZodType<Record<string, T>>;
+//# sourceMappingURL=list.d.ts.map

package/dist/schemas/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/schemas/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,MAAM,IAAI;IAC5C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACvB,CAAC;AACF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,GAAG,MAAM,IAAI;IAClD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,EAAE,CAAC,EAAE;QACD;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB;;WAEG;QACH,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;KACvB,CAAC;CACL,CAAC;AAmBF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAkB1G,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,UAAU,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,8EAIzF,CAAC;AAEP;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,UAAU,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,8EAI3F,CAAC;AAEP;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CA4B5H,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,UAAS,2BAA2B,CAAC,CAAC,CAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAUxI,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,UAAS,2BAA2B,CAAC,CAAC,CAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAkBrI,CAAC"}

package/dist/schemas/list.js

@@ -0,0 +1,139 @@
+import { z } from "zod";
+const defaultListOptions = {
+    splitter: ";",
+    of: z.string(),
+};
+const defaultKeyValueOptions = {
+    splitter: "=",
+    of: z.string(),
+};
+const defaultKeyValueListOptions = {
+    splitter: "&",
+    of: {
+        splitter: "=",
+        of: z.string(),
+    },
+};
+/**
+ * Creates a Zod schema for a list of elements.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @param options.splitter - The separator used to split the string into a list. (default: ";")
+ * @param options.of - The schema used to validate the elements in the list. (default: z.string())
+ * @returns A Zod schema for a list of elements.
+ */
+export const listSchema = (name, options = {}) => {
+    const opts = { ...defaultListOptions, ...options };
+    return z.string().transform((v, ctx) => {
+        const values = v
+            .split(opts.splitter)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        return values.map((entry) => {
+            const res = opts.of.safeParse(entry);
+            if (!res.success) {
+                ctx.addIssue({ code: "custom", message: `${name} contains an invalid entry: "${entry}"` });
+                return z.NEVER;
+            }
+            return res.data;
+        });
+    });
+};
+/**
+ * Creates a Zod schema for a list of URLs.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @returns A Zod schema for a list of URLs.
+ */
+export const urlListSchema = (name, options) => listSchema(name, {
+    ...options,
+    of: z.url(),
+});
+/**
+ * Creates a Zod schema for a list of emails.
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @returns A Zod schema for a list of emails.
+ */
+export const emailListSchema = (name, options) => listSchema(name, {
+    ...options,
+    of: z.email(),
+});
+/**
+ * Creates a Zod schema for a key-value pair.
+ * @param name - The name of the key-value pair.
+ * @param options - The options for the key-value pair schema.
+ * @returns an object with a single key
+ */
+export const keyValueSchema = (name, options = {}) => {
+    const opts = { ...defaultKeyValueOptions, ...options };
+    return z.string().transform((v, ctx) => {
+        // if target value is "abc=def=ghi" => awaited result : { abc: "def=ghi" }
+        // So don't do that :
+        // const parts = v.split(opts.splitter);
+        const index = v.indexOf(opts.splitter);
+        if (index === -1) {
+            ctx.addIssue({ code: "custom", message: `${name} contains an invalid entry: "${v}"` });
+            return z.NEVER;
+        }
+        const keyPart = v.slice(0, index);
+        const valuePart = v.slice(index + opts.splitter.length);
+        const key = z.string().safeParse(keyPart);
+        if (!key.success) {
+            ctx.addIssue({ code: "custom", message: `${name} contains an invalid key: "${keyPart}"` });
+            return z.NEVER;
+        }
+        const value = opts.of.safeParse(valuePart);
+        if (!value.success) {
+            ctx.addIssue({ code: "custom", message: `${name} contains an invalid value: "${valuePart}"` });
+            return z.NEVER;
+        }
+        return { [key.data]: value.data };
+    });
+};
+/**
+ * Creates a Zod schema for a list of key-value pairs using two separators.
+ * @Example firstname=Romain&lastname=Taillandier
+ * => will be parsed as an array of objects with a single key: [{ firstname: "Romain" }, { lastname: "Taillandier" }]
+ * @param name - The name of the list.
+ * @param options - The options for the list schema.
+ * @param options.splitter - The separator used to split the string into a list of key-value pairs. (default: "&")
+ * @param options.of - The schema used to validate the key-value pairs. (default: "=")
+ * @returns an array of objects with a single key
+ */
+export const keyValueListSchema = (name, options = {}) => {
+    const outerSplitter = options.splitter ?? defaultKeyValueListOptions.splitter;
+    const innerOptions = {
+        splitter: options.of?.splitter ?? defaultKeyValueListOptions.of.splitter,
+        of: (options.of?.of ?? z.string()),
+    };
+    return listSchema(name, {
+        splitter: outerSplitter,
+        of: keyValueSchema(name, innerOptions),
+    });
+};
+/**
+ * Creates a Zod schema for a map of key-value pairs using two separators. Duplicate keys are rejected.
+ * @Example firstname=Romain&lastname=Taillandier
+ * => will be parsed as { firstname: "Romain", lastname: "Taillandier" }
+ * @param name - The name of the map.
+ * @param options - The options for the map schema.
+ * @returns a map of key-value pairs
+ */
+export const keyValueMapSchema = (name, options = {}) => {
+    return keyValueListSchema(name, options).transform((list, ctx) => {
+        const result = {};
+        for (const entry of list) {
+            const [key, value] = Object.entries(entry)[0];
+            if (key in result) {
+                ctx.addIssue({
+                    code: "custom",
+                    message: `${name} contains duplicate key: "${key}"`,
+                });
+                return z.NEVER;
+            }
+            result[key] = value;
+        }
+        return result;
+    });
+};

package/dist/schemas/path.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const looksLikePath: (value: string) => boolean;
+export declare const looksLikeFilename: (value: string) => boolean;
+export declare const looksLikeFilePath: (value: string) => boolean | undefined;
+/**
+ * Creates a Zod schema for a path.
+ * @param name - The name of the path.
+ * @returns A Zod schema for a path.
+ */
+export declare const pathSchema: (name: string) => z.ZodType<string>;
+/**
+ * Creates a Zod schema for a file path.
+ * @param name - The name of the file path.
+ * @returns A Zod schema for a file path.
+ */
+export declare const filePathSchema: (name: string) => z.ZodType<string>;
+/**
+ * Creates a Zod schema for a filename.
+ * @param name - The name of the filename.
+ * @returns A Zod schema for a filename.
+ */
+export declare const filenameSchema: (name: string) => z.ZodString;
+//# sourceMappingURL=path.d.ts.map

package/dist/schemas/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/schemas/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,YAAgD,CAAC;AAE5F,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,YAAyE,CAAC;AAEzH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,wBAA+F,CAAC;AAK/I;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAsB,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAsB,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,gBAI4D,CAAC"}

package/dist/schemas/path.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+// Note to myself :
+// On est volontairement permissifs.
+//
+// On fait au plus simple : un path contient au moins un / ou un \
+// sinon on sait pas.
+// si oui, c'est presque certain que c'est un path, dans un .env
+export const looksLikePath = (value) => value.includes("/") || value.includes("\\");
+export const looksLikeFilename = (value) => !value.includes("/") && !value.includes("\\") && value.includes(".");
+export const looksLikeFilePath = (value) => (value.includes("/") || value.includes("\\")) && value.split(/[\\/]/).pop()?.includes(".");
+//
+// Les schéma vont refléter ca
+/**
+ * Creates a Zod schema for a path.
+ * @param name - The name of the path.
+ * @returns A Zod schema for a path.
+ */
+export const pathSchema = (name) => z.string().min(1);
+/**
+ * Creates a Zod schema for a file path.
+ * @param name - The name of the file path.
+ * @returns A Zod schema for a file path.
+ */
+export const filePathSchema = (name) => z.string().min(1);
+/**
+ * Creates a Zod schema for a filename.
+ * @param name - The name of the filename.
+ * @returns A Zod schema for a filename.
+ */
+export const filenameSchema = (name) => z
+    .string()
+    .min(1)
+    .refine((v) => !v.includes("/") && !v.includes("\\"), `${name} must be a filename, not a path`);

package/dist/schemas/port.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+/**
+ * Creates a Zod schema for a port.
+ * @param name - The name of the port.
+ * @returns A Zod schema for a port.
+ */
+export declare const portSchema: (name: string) => z.ZodType<number>;
+//# sourceMappingURL=port.d.ts.map

package/dist/schemas/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/schemas/port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAEzD,CAAC"}

package/dist/schemas/port.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * Creates a Zod schema for a port.
+ * @param name - The name of the port.
+ * @returns A Zod schema for a port.
+ */
+export const portSchema = (name) => {
+    return z.coerce.number(`${name} must be a number`).int(`${name} must be an integer`).min(1, `${name} must be >= 1`).max(65535, `${name} must be <= 65535`);
+};

package/dist/schemas/urls.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export declare const looksLikeUrl: (value: string) => boolean;
+export declare const looksLikeHttpUrl: (value: string) => boolean;
+export declare const looksLikeDbUrl: (value: string) => boolean;
+export declare const looksLikeQueueUrl: (value: string) => boolean;
+export declare const looksLikeWsUrl: (value: string) => boolean;
+export declare const looksLikeStorageUrl: (value: string) => boolean;
+export declare const looksLikeOtherUrl: (value: string) => boolean;
+export declare const httpUrlSchema: (name: string) => z.ZodURL;
+export declare const databaseUrlSchema: (name: string) => z.ZodURL;
+export declare const queueUrlSchema: (name: string) => z.ZodURL;
+export declare const wsUrlSchema: (name: string) => z.ZodURL;
+export declare const storageUrlSchema: (name: string) => z.ZodURL;
+export declare const otherUrlSchema: (name: string) => z.ZodURL;
+//# sourceMappingURL=urls.d.ts.map

package/dist/schemas/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/schemas/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAO5C,CAAC;AAwCF,eAAO,MAAM,gBAAgB,UAhB4B,MAAM,KAAK,OAgBJ,CAAC;AACjE,eAAO,MAAM,cAAc,UAjB8B,MAAM,KAAK,OAiBR,CAAC;AAC7D,eAAO,MAAM,iBAAiB,UAlB2B,MAAM,KAAK,OAkBF,CAAC;AACnE,eAAO,MAAM,cAAc,UAnB8B,MAAM,KAAK,OAmBR,CAAC;AAC7D,eAAO,MAAM,mBAAmB,UApByB,MAAM,KAAK,OAoBE,CAAC;AACvE,eAAO,MAAM,iBAAiB,UArB2B,MAAM,KAAK,OAqBF,CAAC;AAEnE,eAAO,MAAM,aAAa,SAbf,MAAM,KAAG,CAAC,CAAC,MAa8C,CAAC;AACrE,eAAO,MAAM,iBAAiB,SAdnB,MAAM,KAAG,CAAC,CAAC,MAcoD,CAAC;AAC3E,eAAO,MAAM,cAAc,SAfhB,MAAM,KAAG,CAAC,CAAC,MAeiD,CAAC;AACxE,eAAO,MAAM,WAAW,SAhBb,MAAM,KAAG,CAAC,CAAC,MAgB+C,CAAC;AACtE,eAAO,MAAM,gBAAgB,SAjBlB,MAAM,KAAG,CAAC,CAAC,MAiBuD,CAAC;AAC9E,eAAO,MAAM,cAAc,SAlBhB,MAAM,KAAG,CAAC,CAAC,MAkBiD,CAAC"}

package/dist/schemas/urls.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+export const looksLikeUrl = (value) => {
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const HTTP_PROTOCOLS = ["http:", "https:"];
+const DB_PROTOCOLS = [
+    "postgres:",
+    "postgresql:",
+    "mysql:",
+    "mariadb:",
+    "mongodb:",
+    "mongodb+srv:",
+    "redis:",
+    "rediss:",
+    "cassandra:",
+    "mssql:",
+    "sqlserver:",
+    "oracle:",
+    "cockroachdb:",
+    "sqlite:",
+];
+const QUEUE_PROTOCOLS = ["amqp:", "amqps:", "mqtt:", "mqtt+ws:", "mqtt+wss:", "stomp:", "stomp+ssl:", "stomp+ws:", "stomp+wss:"];
+const WS_PROTOCOLS = ["ws:", "wss:"];
+const STORAGE_PROTOCOLS = ["s3:", "gs:", "azure:", "azblob:", "file:", "ftp:", "ftps:", "sftp:"];
+const OTHER_PROTOCOLS = ["ldap:", "ldaps:", "smtp:", "smtps:", "imap:", "imaps:", "pop3:", "pop3s:", "git:", "ssh:", "tcp:", "udp:"];
+const makeUrlLooksLike = (protocols) => {
+    return (value) => protocols.some((protocol) => new URL(value).protocol === protocol);
+};
+// Remark.
+// here each schema do a double url verification :
+// once in z.url(), once in looksLikeXUrl() with new URL().
+const makeUrlSchema = (message, looksLike) => (name) => {
+    return z.url().refine((v) => looksLike(v.toString()), {
+        message: `${name} has invalid ${message} URL`,
+    });
+};
+export const looksLikeHttpUrl = makeUrlLooksLike(HTTP_PROTOCOLS);
+export const looksLikeDbUrl = makeUrlLooksLike(DB_PROTOCOLS);
+export const looksLikeQueueUrl = makeUrlLooksLike(QUEUE_PROTOCOLS);
+export const looksLikeWsUrl = makeUrlLooksLike(WS_PROTOCOLS);
+export const looksLikeStorageUrl = makeUrlLooksLike(STORAGE_PROTOCOLS);
+export const looksLikeOtherUrl = makeUrlLooksLike(OTHER_PROTOCOLS);
+export const httpUrlSchema = makeUrlSchema("HTTP", looksLikeHttpUrl);
+export const databaseUrlSchema = makeUrlSchema("database", looksLikeDbUrl);
+export const queueUrlSchema = makeUrlSchema("queue", looksLikeQueueUrl);
+export const wsUrlSchema = makeUrlSchema("WebSocket", looksLikeWsUrl);
+export const storageUrlSchema = makeUrlSchema("storage", looksLikeStorageUrl);
+export const otherUrlSchema = makeUrlSchema("other", looksLikeOtherUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@romaintaillandier1978/dotenv-never-lies",
-    "version": "1.1.1",
+    "version": "1.3.0",
     "description": "Typed, validated, and explicit environment variables — powered by Zod.",
     "license": "MIT",
     "author": "Romain TAILLANDIER",
@@ -15,7 +15,11 @@
         "pack:check": "npm pack --dry-run",
         "release:patch": "npm version patch",
         "release:minor": "npm version minor",
-        "release:major": "npm version major"
+        "release:major": "npm version major",
+        "test": "vitest",
+        "test:run": "vitest run",
+        "test:watch": "vitest",
+        "start:infer": "yarn build && dnl infer --source .env --out src/sample/env.dnl.ts -f "
     },
     "keywords": [
         "env",
@@ -39,13 +43,13 @@
     "types": "./dist/index.d.ts",
     "exports": {
         ".": {
-            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts",
             "import": "./dist/index.js",
-            "types": "./dist/index.d.ts"
+            "require": "./dist/index.js"
         },
         "./cli": {
-            "require": "./dist/cli/index.js",
-            "import": "./dist/cli/index.js"
+            "import": "./dist/cli/index.js",
+            "require": "./dist/cli/index.js"
         }
     },
     "bin": {
@@ -68,6 +72,7 @@
         "eslint": "^9.39.2",
         "prettier": "^3.7.4",
         "typescript": "^5.9.3",
+        "vitest": "^4.0.17",
         "zod": "^4.2.1"
     }
 }

package/dist/DnlTest.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=DnlTest.d.ts.map

package/dist/DnlTest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DnlTest.d.ts","sourceRoot":"","sources":["../src/DnlTest.ts"],"names":[],"mappings":""}

package/dist/DnlTest.js

@@ -1,12 +0,0 @@
-export {};
-//envDefinition.explain({ key: "NODE_CORS_ORIGIN" });
-// const source: EnvSource = dnl.readEnvFile(".env");
-// let ok = envDefinition.check();
-// ok = envDefinition.check({ source: process.env });
-// const ENV = envDefinition.load({ source });
-// ok = envDefinition.check();
-// ok = envDefinition.check({ source: process.env });
-// // intellisens OK
-// ENV.NODE_ENV; //(property) NODE_ENV: "test" | "development" | "staging" | "production"
-// ENV.NODE_PORT; //(property) NODE_PORT: number
-// envDefinition.explain();

package/dist/cli/utils/exitCodes.d.ts

@@ -1,8 +0,0 @@
-export declare enum ExitCodes {
-    success = 0,
-    usageError = 1,
-    schemaNotFound = 2,
-    validationError = 3,
-    exportError = 4
-}
-//# sourceMappingURL=exitCodes.d.ts.map

package/dist/cli/utils/exitCodes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/exitCodes.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACjB,OAAO,IAAI;IACX,UAAU,IAAI;IACd,cAAc,IAAI;IAClB,eAAe,IAAI;IACnB,WAAW,IAAI;CAClB"}

package/dist/cli/utils/exitCodes.js

@@ -1,8 +0,0 @@
-export var ExitCodes;
-(function (ExitCodes) {
-    ExitCodes[ExitCodes["success"] = 0] = "success";
-    ExitCodes[ExitCodes["usageError"] = 1] = "usageError";
-    ExitCodes[ExitCodes["schemaNotFound"] = 2] = "schemaNotFound";
-    ExitCodes[ExitCodes["validationError"] = 3] = "validationError";
-    ExitCodes[ExitCodes["exportError"] = 4] = "exportError";
-})(ExitCodes || (ExitCodes = {}));