@stacksjs/env 0.72.98 → 0.72.99

package/dist/types.d.ts

@@ -149,7 +149,7 @@ export declare interface FrameworkEnv {
   CONNECT_INSTANCE_ALIAS: string | undefined
   PHONE_NOTIFY_EMAIL: string | undefined
   PHONE_FORWARD_NUMBER: string | undefined
-  STORAGE_DRIVER: string | undefined
+  STORAGE_DRIVER: 'local' | 'public' | 's3' | undefined
   STORAGE_ROOT: string | undefined
   STORAGE_PUBLIC_URL: string | undefined
   QUEUE_DRIVER: string | undefined
@@ -258,22 +258,21 @@ export declare interface FrameworkEnv {
 /**
  * Every environment variable the application can read through `env`.
  *
- * Extends the framework's own set; an application adds its variables by
- * augmenting this interface from `config/env.ts`, which is the file that
- * already declares them:
+ * Extends the framework's own set. An application adds its variables by
+ * declaring them in `config/env.ts` and nothing else:
  *
  * ```ts
- * const envSchema = defineEnv({
+ * export default defineEnv({
  *   STRIPE_WEBHOOK_SECRET: { validation: schema.string(), default: '' },
  * })
- *
- * declare module '@stacksjs/env' {
- *   interface StacksEnv extends InferEnv<typeof envSchema> {}
- * }
- *
- * export default envSchema
  * ```
  *
+ * `storage/framework/types/env.d.ts` reads that schema and augments this
+ * interface. It cannot live in this package: a published `.d.ts` naming
+ * `../../../config/env` resolves to nothing under `node_modules/`. Applications
+ * used to write the augmentation themselves, which is boilerplate with one
+ * correct spelling that silently types nothing when omitted.
+ *
  * Nothing is generated: the types follow the schema, so they are the same on a
  * fresh clone, in CI, and in production. They used to come from a generated
  * `storage/framework/types/env.d.ts` whose key set was scraped from whichever

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/env",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.98",
+  "version": "0.72.99",
   "description": "Stacks env helper methods.",
   "author": "Chris Breuer",
   "contributors": [
@@ -56,10 +56,10 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/path": "0.72.98"
+    "@stacksjs/path": "0.72.99"
   },
   "devDependencies": {
     "better-dx": "^0.2.24",
-    "@stacksjs/validation": "0.72.98"
+    "@stacksjs/validation": "0.72.99"
   }
 }