@stacksjs/config 0.75.81 → 0.75.82

package/dist/features.d.ts

@@ -1,3 +1,4 @@
+import { type FeatureName } from '@stacksjs/features/names';
 export declare function feature(name: string): boolean;
 /**
  * Force-enable a feature in the running process. Intended for tests and
@@ -18,5 +19,28 @@ export declare function resetFeature(name: string): void;
  * framework features plus any runtime overrides for ad-hoc flags.
  */
 export declare function listFeatures(): Record<string, boolean>;
-export type StacksFeature = | 'auth' | 'marketing' | 'cms' | 'commerce' | 'forms'
-  | 'dashboard' | 'monitoring' | 'realtime' | 'queue';
+/**
+ * Every name `feature()` answers for: the installable bundles, plus `auth`.
+ *
+ * Derived rather than restated. The bundles were spelled out here as well as in
+ * `@stacksjs/features`, and nothing related the two lists, so a feature added
+ * to one and not the other shipped silently - config-only meant no install
+ * command and no migration gating, features-only meant `canonicalFeatures()`
+ * no longer forced it on and generated artifacts stopped being a function of
+ * the source alone (stacksjs/stacks#2867, #2408).
+ *
+ * Imported from `@stacksjs/features/names`, not the package root: the root also
+ * carries the file and table manifests and reaches `node:fs` and
+ * `@stacksjs/path` for them, which costs about a millisecond on a path every
+ * process walks before anything else. The names module imports nothing.
+ *
+ * `auth` is added here and is not an installable bundle, which looks backwards
+ * until you read why: `config/auth.ts` ships in every app with `enabled: true`,
+ * so gating the auth routes on `feature('auth')` would mount `/login`,
+ * `/register`, `/generate-two-factor-secret`, `/logout-all` and `/auth/tokens`
+ * into every app currently running with `dashboard` off. Route selection is
+ * explicit instead, through `STACKS_DEFAULT_ROUTES` - see the rationale in
+ * `router/src/route-loader.ts` and `defaults/bootstrap.ts`. It is a name
+ * `feature()` knows, and nothing gates on it.
+ */
+export type StacksFeature = FeatureName | 'auth';

package/dist/features.js

@@ -1 +1 @@
-import{config}from"./runtime";const FEATURE_NAMES=["auth","marketing","cms","commerce","forms","dashboard","monitoring","realtime","queue"],FEATURE_DEFAULTS={dashboard:!0},overrides=new Map;function configFor(name){const raw=config[name];return raw&&typeof raw==="object"?raw:void 0}function canonicalFeatures(){return process.env.STACKS_CANONICAL_FEATURES==="1"}export function feature(name){if(overrides.has(name))return overrides.get(name);if(canonicalFeatures()&&FEATURE_NAMES.includes(name))return!0;const cfg=configFor(name);if(cfg){const enabledField=cfg.enabled;if(enabledField===!1)return!1;if(Array.isArray(cfg.env)&&cfg.env.length>0){const currentEnv=(config.app?.env??"").toString();if(!cfg.env.includes(currentEnv))return!1}if(enabledField!==void 0)return!!enabledField;return!0}return FEATURE_DEFAULTS[name]??!1}export function enableFeature(name){overrides.set(name,!0)}export function disableFeature(name){overrides.set(name,!1)}export function resetFeature(name){overrides.delete(name)}export function listFeatures(){const out={};for(const name of FEATURE_NAMES)out[name]=feature(name);for(const name of overrides.keys())out[name]=feature(name);return out}
+import{FEATURE_NAMES as INSTALLABLE_FEATURES}from"@stacksjs/features/names";import{config}from"./runtime";const FEATURE_NAMES=[...INSTALLABLE_FEATURES,"auth"],FEATURE_DEFAULTS={dashboard:!0},overrides=new Map;function configFor(name){const raw=config[name];return raw&&typeof raw==="object"?raw:void 0}function canonicalFeatures(){return process.env.STACKS_CANONICAL_FEATURES==="1"}export function feature(name){if(overrides.has(name))return overrides.get(name);if(canonicalFeatures()&&FEATURE_NAMES.includes(name))return!0;const cfg=configFor(name);if(cfg){const enabledField=cfg.enabled;if(enabledField===!1)return!1;if(Array.isArray(cfg.env)&&cfg.env.length>0){const currentEnv=(config.app?.env??"").toString();if(!cfg.env.includes(currentEnv))return!1}if(enabledField!==void 0)return!!enabledField;return!0}return FEATURE_DEFAULTS[name]??!1}export function enableFeature(name){overrides.set(name,!0)}export function disableFeature(name){overrides.set(name,!1)}export function resetFeature(name){overrides.delete(name)}export function listFeatures(){const out={};for(const name of FEATURE_NAMES)out[name]=feature(name);for(const name of overrides.keys())out[name]=feature(name);return out}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/config",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.81",
+  "version": "0.75.82",
   "description": "The Stacks config helper methods.",
   "author": "Chris Breuer",
   "contributors": [
@@ -55,14 +55,15 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/events": "0.75.81",
-    "@stacksjs/path": "0.75.81",
-    "@stacksjs/tunnel": "0.75.81",
+    "@stacksjs/events": "0.75.82",
+    "@stacksjs/features": "0.75.82",
+    "@stacksjs/path": "0.75.82",
+    "@stacksjs/tunnel": "0.75.82",
     "ts-pantry": "^0.11.69"
   },
   "devDependencies": {
-    "@stacksjs/alias": "0.75.81",
-    "@stacksjs/types": "0.75.81",
+    "@stacksjs/alias": "0.75.82",
+    "@stacksjs/types": "0.75.82",
     "better-dx": "^0.2.24"
   }
 }