envapt 8.0.0-next.1 → 8.0.0-next.3

package/dist/types/decorators/legacy/Envapt.d.mts

@@ -32,7 +32,7 @@ import { EnvaptFieldDecorator } from "../../types/Decorator.mjs";
  * }
  * ```
  */
-declare function Envapt(key: EnvKeyInput, options: {
+declare function Envapt(key: EnvKeyInput, options?: {
   fallback: undefined;
   converter?: undefined;
 }): EnvaptFieldDecorator<string | undefined>;
@@ -96,7 +96,7 @@ declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
  *
  *   // prefers CANARY_URL when present, otherwise APP_URL
  *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static readonly canaryUrl: URL | null;
+ *   static readonly canaryUrl: URL | undefined;
  *
  *   // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)
  *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
@@ -123,13 +123,9 @@ declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvK
 }): EnvaptFieldDecorator<InferConverterReturnType<TConverter>>;
 declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
   converter: TConverter;
-  fallback: undefined;
+  fallback?: undefined;
   required?: false;
 }): EnvaptFieldDecorator<InferConverterReturnType<TConverter> | undefined>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  required?: false;
-}): EnvaptFieldDecorator<InferConverterReturnType<TConverter> | null>;
 /**
  * A primitive constructor (`Number`, `Boolean`) with an optional fallback.
  *
@@ -157,13 +153,9 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
 }): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor>>;
 declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
   converter: TConstructor;
-  fallback: undefined;
+  fallback?: undefined;
   required?: false;
 }): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  required?: false;
-}): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> | null>;
 /**
  * Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env
  * value is missing or empty after trimming, independent of the global `Envapter.strict` flag.
@@ -184,20 +176,6 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
 declare function Envapt(key: EnvKeyInput, options: {
   required: true;
 }): EnvaptFieldDecorator<string>;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('SIMPLE_VALUE')
- *   static readonly simple?: string | null;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput): EnvaptFieldDecorator<string | null>;
 /**
  * A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,
  * so a Promise-returning `validate` throws `InvalidUserDefinedConfig` at runtime. Pairing

package/dist/types/decorators/legacy/SugarDecorators.d.mts

@@ -9,21 +9,21 @@ import { EnvaptFieldDecorator } from "../../types/Decorator.mjs";
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptFieldDecorator<boolean>;
-declare function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean | null>;
+declare function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptFieldDecorator<number>;
-declare function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number | null>;
+declare function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptFieldDecorator<string>;
-declare function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string | null>;
+declare function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a
  * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.
@@ -31,7 +31,7 @@ declare function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string | null>;
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptFieldDecorator<number>;
-declare function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number | null>;
+declare function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a `URL`
  * instance, not a URL string.
@@ -39,7 +39,7 @@ declare function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number | null>;
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptFieldDecorator<URL>;
-declare function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL | null>;
+declare function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL | undefined>;
 //#endregion
 export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl };
 //# sourceMappingURL=SugarDecorators.d.mts.map

package/dist/types/decorators/modern/Envapt.d.mts

@@ -32,7 +32,7 @@ import { EnvaptAccessorDecorator } from "../../types/Decorator.mjs";
  * }
  * ```
  */
-declare function Envapt(key: EnvKeyInput, options: {
+declare function Envapt(key: EnvKeyInput, options?: {
   fallback: undefined;
   converter?: undefined;
 }): EnvaptAccessorDecorator<string | undefined>;
@@ -96,7 +96,7 @@ declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
  *
  *   // prefers CANARY_URL when present, otherwise APP_URL
  *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static accessor canaryUrl: URL | null;
+ *   static accessor canaryUrl: URL | undefined;
  *
  *   // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)
  *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
@@ -123,13 +123,9 @@ declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvK
 }): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;
 declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
   converter: TConverter;
-  fallback: undefined;
+  fallback?: undefined;
   required?: false;
 }): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> | undefined>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  required?: false;
-}): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> | null>;
 /**
  * A primitive constructor (`Number`, `Boolean`) with an optional fallback.
  *
@@ -157,13 +153,9 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
 }): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;
 declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
   converter: TConstructor;
-  fallback: undefined;
+  fallback?: undefined;
   required?: false;
 }): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  required?: false;
-}): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> | null>;
 /**
  * Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env
  * value is missing or empty after trimming, independent of the global `Envapter.strict` flag.
@@ -184,20 +176,6 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
 declare function Envapt(key: EnvKeyInput, options: {
   required: true;
 }): EnvaptAccessorDecorator<string>;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * class Config {
- *   \@Envapt('SIMPLE_VALUE')
- *   static accessor simple: string | null;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput): EnvaptAccessorDecorator<string | null>;
 /**
  * A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,
  * so a Promise-returning `validate` throws `InvalidUserDefinedConfig` at runtime. Pairing

package/dist/types/decorators/modern/SugarDecorators.d.mts

@@ -9,21 +9,21 @@ import { EnvaptAccessorDecorator } from "../../types/Decorator.mjs";
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptAccessorDecorator<boolean>;
-declare function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean | null>;
+declare function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptAccessorDecorator<number>;
-declare function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number | null>;
+declare function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptAccessorDecorator<string>;
-declare function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string | null>;
+declare function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a
  * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.
@@ -31,7 +31,7 @@ declare function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string | null
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptAccessorDecorator<number>;
-declare function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number | null>;
+declare function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a `URL`
  * instance, not a URL string.
@@ -39,7 +39,7 @@ declare function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number | nul
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
 declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptAccessorDecorator<URL>;
-declare function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL | null>;
+declare function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL | undefined>;
 //#endregion
 export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl };
 //# sourceMappingURL=SugarDecorators.d.mts.map

package/dist/types/types/Conversion.d.mts

@@ -39,6 +39,8 @@ interface ConverterMap {
   regexp: RegExp;
   date: Date;
   time: number;
+  port: number;
+  email: string;
 }
 type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "envapt",
   "type": "module",
-  "version": "8.0.0-next.1",
+  "version": "8.0.0-next.3",
   "description": "Type-safe config for TypeScript. Read typed values from any source, process.env, .env files, Cloudflare Workers bindings, browser bundles, or any object you supply. Zero runtime dependencies, one API across Node, Bun, Deno, Workers, and the browser. TC39 accessor decorators (legacy decorators at envapt/legacy), converters, and Standard Schema (zod/valibot/arktype) validation.",
   "types": "./dist/types/index.d.mts",
   "exports": {