envapt 8.0.0-next.0 → 8.0.0-next.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/dist/node/converters/BuiltInConverters.cjs +1 -1
  3. package/dist/node/converters/BuiltInConverters.cjs.map +1 -1
  4. package/dist/node/converters/BuiltInConverters.mjs +1 -1
  5. package/dist/node/converters/BuiltInConverters.mjs.map +1 -1
  6. package/dist/node/converters/Converters.cjs +1 -1
  7. package/dist/node/converters/Converters.cjs.map +1 -1
  8. package/dist/node/converters/Converters.mjs +1 -1
  9. package/dist/node/converters/Converters.mjs.map +1 -1
  10. package/dist/node/converters/ListOfBuiltInConverters.cjs +1 -1
  11. package/dist/node/converters/ListOfBuiltInConverters.cjs.map +1 -1
  12. package/dist/node/converters/ListOfBuiltInConverters.mjs +1 -1
  13. package/dist/node/converters/ListOfBuiltInConverters.mjs.map +1 -1
  14. package/dist/node/converters/ValueConverter.cjs +1 -1
  15. package/dist/node/converters/ValueConverter.cjs.map +1 -1
  16. package/dist/node/converters/ValueConverter.mjs +1 -1
  17. package/dist/node/converters/ValueConverter.mjs.map +1 -1
  18. package/dist/node/core/AdvancedMethods.cjs +1 -1
  19. package/dist/node/core/AdvancedMethods.cjs.map +1 -1
  20. package/dist/node/core/AdvancedMethods.mjs +1 -1
  21. package/dist/node/core/AdvancedMethods.mjs.map +1 -1
  22. package/dist/node/core/EnvapterBase.cjs +1 -1
  23. package/dist/node/core/EnvapterBase.cjs.map +1 -1
  24. package/dist/node/core/EnvapterBase.mjs +1 -1
  25. package/dist/node/core/EnvapterBase.mjs.map +1 -1
  26. package/dist/node/core/Environment.cjs +1 -1
  27. package/dist/node/core/Environment.cjs.map +1 -1
  28. package/dist/node/core/Environment.mjs +1 -1
  29. package/dist/node/core/Environment.mjs.map +1 -1
  30. package/dist/node/core/EnvironmentMethods.cjs +1 -1
  31. package/dist/node/core/EnvironmentMethods.cjs.map +1 -1
  32. package/dist/node/core/EnvironmentMethods.mjs +1 -1
  33. package/dist/node/core/EnvironmentMethods.mjs.map +1 -1
  34. package/dist/node/core/PrimitiveMethods.cjs.map +1 -1
  35. package/dist/node/core/PrimitiveMethods.mjs.map +1 -1
  36. package/dist/node/core/engine.cjs +1 -1
  37. package/dist/node/core/engine.cjs.map +1 -1
  38. package/dist/node/core/engine.mjs +1 -1
  39. package/dist/node/core/engine.mjs.map +1 -1
  40. package/dist/node/core/missing.cjs +2 -0
  41. package/dist/node/core/missing.cjs.map +1 -0
  42. package/dist/node/core/missing.mjs +2 -0
  43. package/dist/node/core/missing.mjs.map +1 -0
  44. package/dist/node/core/paths.cjs +1 -1
  45. package/dist/node/core/paths.cjs.map +1 -1
  46. package/dist/node/core/paths.mjs +1 -1
  47. package/dist/node/core/paths.mjs.map +1 -1
  48. package/dist/node/decorators/legacy/Envapt.cjs.map +1 -1
  49. package/dist/node/decorators/legacy/Envapt.mjs.map +1 -1
  50. package/dist/node/decorators/legacy/SugarDecorators.cjs.map +1 -1
  51. package/dist/node/decorators/legacy/SugarDecorators.mjs.map +1 -1
  52. package/dist/node/decorators/modern/Envapt.cjs.map +1 -1
  53. package/dist/node/decorators/modern/Envapt.mjs.map +1 -1
  54. package/dist/node/decorators/modern/SugarDecorators.cjs.map +1 -1
  55. package/dist/node/decorators/modern/SugarDecorators.mjs.map +1 -1
  56. package/dist/node/decorators/resolveDecoratorValue.cjs +1 -1
  57. package/dist/node/decorators/resolveDecoratorValue.cjs.map +1 -1
  58. package/dist/node/decorators/resolveDecoratorValue.mjs +1 -1
  59. package/dist/node/decorators/resolveDecoratorValue.mjs.map +1 -1
  60. package/dist/node/engine/Envapter.cjs +1 -1
  61. package/dist/node/engine/Envapter.cjs.map +1 -1
  62. package/dist/node/engine/Envapter.mjs +1 -1
  63. package/dist/node/engine/Envapter.mjs.map +1 -1
  64. package/dist/node/engine/NodeEnvapter.cjs +1 -1
  65. package/dist/node/engine/NodeEnvapter.cjs.map +1 -1
  66. package/dist/node/engine/NodeEnvapter.mjs +1 -1
  67. package/dist/node/engine/NodeEnvapter.mjs.map +1 -1
  68. package/dist/node/engine/TemplateResolver.cjs +1 -1
  69. package/dist/node/engine/TemplateResolver.cjs.map +1 -1
  70. package/dist/node/engine/TemplateResolver.mjs +1 -1
  71. package/dist/node/engine/TemplateResolver.mjs.map +1 -1
  72. package/dist/node/engine/Validators.cjs +1 -1
  73. package/dist/node/engine/Validators.mjs +1 -1
  74. package/dist/node/index.cjs +1 -1
  75. package/dist/node/index.mjs +1 -1
  76. package/dist/node/infra/Debug.cjs +1 -1
  77. package/dist/node/infra/Debug.cjs.map +1 -1
  78. package/dist/node/infra/Debug.mjs +1 -1
  79. package/dist/node/infra/Debug.mjs.map +1 -1
  80. package/dist/node/infra/Dotenv.cjs.map +1 -1
  81. package/dist/node/infra/Dotenv.mjs.map +1 -1
  82. package/dist/node/infra/Error.cjs.map +1 -1
  83. package/dist/node/infra/Error.mjs.map +1 -1
  84. package/dist/node/infra/runtime.cjs +1 -1
  85. package/dist/node/infra/runtime.cjs.map +1 -1
  86. package/dist/node/infra/runtime.mjs +1 -1
  87. package/dist/node/infra/runtime.mjs.map +1 -1
  88. package/dist/node/sources/FileSource.cjs.map +1 -1
  89. package/dist/node/sources/FileSource.mjs.map +1 -1
  90. package/dist/node/sources/PortableSource.cjs.map +1 -1
  91. package/dist/node/sources/PortableSource.mjs.map +1 -1
  92. package/dist/node/sources/merge.cjs +1 -1
  93. package/dist/node/sources/merge.cjs.map +1 -1
  94. package/dist/node/sources/merge.mjs +1 -1
  95. package/dist/node/sources/merge.mjs.map +1 -1
  96. package/dist/node/sources/normalizeSource.cjs +2 -0
  97. package/dist/node/sources/normalizeSource.cjs.map +1 -0
  98. package/dist/node/sources/normalizeSource.mjs +2 -0
  99. package/dist/node/sources/normalizeSource.mjs.map +1 -0
  100. package/dist/portable/converters/BuiltInConverters.mjs +1 -1
  101. package/dist/portable/converters/BuiltInConverters.mjs.map +1 -1
  102. package/dist/portable/converters/Converters.mjs +1 -1
  103. package/dist/portable/converters/Converters.mjs.map +1 -1
  104. package/dist/portable/converters/ListOfBuiltInConverters.mjs +1 -1
  105. package/dist/portable/converters/ListOfBuiltInConverters.mjs.map +1 -1
  106. package/dist/portable/converters/ValueConverter.mjs +1 -1
  107. package/dist/portable/converters/ValueConverter.mjs.map +1 -1
  108. package/dist/portable/core/AdvancedMethods.mjs +1 -1
  109. package/dist/portable/core/AdvancedMethods.mjs.map +1 -1
  110. package/dist/portable/core/EnvapterBase.mjs +1 -1
  111. package/dist/portable/core/EnvapterBase.mjs.map +1 -1
  112. package/dist/portable/core/Environment.mjs +1 -1
  113. package/dist/portable/core/Environment.mjs.map +1 -1
  114. package/dist/portable/core/EnvironmentMethods.mjs +1 -1
  115. package/dist/portable/core/EnvironmentMethods.mjs.map +1 -1
  116. package/dist/portable/core/PrimitiveMethods.mjs.map +1 -1
  117. package/dist/portable/core/engine.mjs +1 -1
  118. package/dist/portable/core/engine.mjs.map +1 -1
  119. package/dist/portable/core/missing.mjs +2 -0
  120. package/dist/portable/core/missing.mjs.map +1 -0
  121. package/dist/portable/core/paths.mjs +1 -1
  122. package/dist/portable/core/paths.mjs.map +1 -1
  123. package/dist/portable/decorators/legacy/Envapt.mjs.map +1 -1
  124. package/dist/portable/decorators/legacy/SugarDecorators.mjs.map +1 -1
  125. package/dist/portable/decorators/modern/Envapt.mjs.map +1 -1
  126. package/dist/portable/decorators/modern/SugarDecorators.mjs.map +1 -1
  127. package/dist/portable/decorators/resolveDecoratorValue.mjs +1 -1
  128. package/dist/portable/decorators/resolveDecoratorValue.mjs.map +1 -1
  129. package/dist/portable/engine/Envapter.mjs +1 -1
  130. package/dist/portable/engine/Envapter.mjs.map +1 -1
  131. package/dist/portable/engine/TemplateResolver.mjs +1 -1
  132. package/dist/portable/engine/TemplateResolver.mjs.map +1 -1
  133. package/dist/portable/engine/Validators.mjs +1 -1
  134. package/dist/portable/index.mjs +1 -1
  135. package/dist/portable/infra/Debug.mjs +1 -1
  136. package/dist/portable/infra/Debug.mjs.map +1 -1
  137. package/dist/portable/infra/Dotenv.mjs.map +1 -1
  138. package/dist/portable/infra/Error.mjs.map +1 -1
  139. package/dist/portable/infra/runtime.mjs +1 -1
  140. package/dist/portable/infra/runtime.mjs.map +1 -1
  141. package/dist/portable/sources/PortableSource.mjs.map +1 -1
  142. package/dist/portable/sources/merge.mjs +1 -1
  143. package/dist/portable/sources/merge.mjs.map +1 -1
  144. package/dist/portable/sources/normalizeSource.mjs +2 -0
  145. package/dist/portable/sources/normalizeSource.mjs.map +1 -0
  146. package/dist/types/converters/Converters.d.mts +7 -10
  147. package/dist/types/core/AdvancedMethods.d.mts +9 -0
  148. package/dist/types/core/EnvapterBase.d.mts +10 -2
  149. package/dist/types/core/Environment.d.mts +2 -1
  150. package/dist/types/core/EnvironmentMethods.d.mts +6 -0
  151. package/dist/types/core/PrimitiveMethods.d.mts +5 -0
  152. package/dist/types/decorators/legacy/SugarDecorators.d.mts +5 -0
  153. package/dist/types/decorators/modern/SugarDecorators.d.mts +5 -0
  154. package/dist/types/engine/Envapter.d.mts +4 -2
  155. package/dist/types/engine/NodeEnvapter.d.mts +14 -2
  156. package/dist/types/index.d.mts +3 -3
  157. package/dist/types/index.portable.d.mts +3 -3
  158. package/dist/types/infra/Debug.d.mts +1 -0
  159. package/dist/types/infra/Dotenv.d.mts +1 -0
  160. package/dist/types/infra/Error.d.mts +2 -0
  161. package/dist/types/infra/StandardSchema.d.mts +1 -0
  162. package/dist/types/sources/FileSource.d.mts +1 -0
  163. package/dist/types/sources/PortableSource.d.mts +1 -0
  164. package/dist/types/sources/merge.d.mts +7 -4
  165. package/dist/types/types/Conversion.d.mts +5 -5
  166. package/dist/types/types/Options.d.mts +4 -0
  167. package/dist/types/types/Source.d.mts +3 -0
  168. package/package.json +1 -1
@@ -2,6 +2,7 @@
2
2
  interface BareSource {
3
3
  readVars(): Record<string, string>;
4
4
  readonly supportsFiles?: false;
5
+ readVar?(key: string): string | undefined;
5
6
  }
6
7
  interface FileCapableSource {
7
8
  readVars(): Record<string, string>;
@@ -10,6 +11,7 @@ interface FileCapableSource {
10
11
  resolvePath(baseDir: string, candidate: string): string;
11
12
  normalizeBaseDir(value: string | URL): string;
12
13
  writeVars(vars: Record<string, string>): void;
14
+ readVar?(key: string): string | undefined;
13
15
  }
14
16
  /**
15
17
  * A pluggable source of environment variables. The default {@link FileSource} reads `process.env` plus
@@ -17,6 +19,7 @@ interface FileCapableSource {
17
19
  * environment (an injected object on the browser, the Cloudflare `env` binding on Workers). Bind one
18
20
  * with `Envapter.useSource`.
19
21
  * @public
22
+ * @see {@link https://envapt.materwelon.dev/docs/sources#any-object-can-be-a-source}
20
23
  */
21
24
  type Source = BareSource | FileCapableSource;
22
25
  //#endregion
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "envapt",
3
3
  "type": "module",
4
- "version": "8.0.0-next.0",
4
+ "version": "8.0.0-next.2",
5
5
  "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.",
6
6
  "types": "./dist/types/index.d.mts",
7
7
  "exports": {