sounding 0.0.2 → 0.0.3

package/README.md

@@ -28,8 +28,9 @@ Sounding also owns its own built-in world engine, so the same package can:
 - capture outgoing mail by wrapping `sails.helpers.mail.send` and storing normalized messages in `sails.sounding.mailbox`
 
 The default configuration story is intentionally calm:
-- Sounding disables its hook automatically when Sails runs in `production`
-- set `sounding.enableInProduction = true` only for controlled production-like environments such as staging
+- Sounding only enables its hook in the environments listed under `sounding.environments`
+- the default is `['test']`, so non-test boot paths stay dark unless you opt in explicitly
+- if you intentionally need Sounding in another environment, add that environment name to the list
 - auth conventions auto-detect `User`/`userId` and `Creator`/`creatorId`, with `sounding.auth` available for overrides
 - Sounding manages a temporary `sails-sqlite` datastore by default
 - managed SQLite artifacts live under `.tmp/db`
@@ -37,6 +38,16 @@ The default configuration story is intentionally calm:
 - browser projects start with `desktop`
 - `inherit` remains available when an app already has a serious test datastore story
 
+For example:
+
+```js
+module.exports.sounding = {
+  environments: ['test'],
+}
+```
+
+If you intentionally want Sounding during another boot path, widen the list explicitly, for example `['test', 'console']` or `['test', 'production']`.
+
 This repository starts with docs-driven product research and the first hook/runtime scaffolding for that vision.
 
 See `RESEARCH.md`.

package/index.js

@@ -14,12 +14,22 @@ const { createExpect } = require('./lib/create-expect')
 const { createTestApi } = require('./lib/create-test-api')
 const { getDefaultConfig } = require('./lib/default-config')
 
-function isProductionEnvironment(sails) {
-  return (sails.config?.environment || process.env.NODE_ENV) === 'production'
+function getCurrentEnvironment(sails) {
+  return sails.config?.environment || process.env.NODE_ENV
+}
+
+function getEnabledEnvironments(sails) {
+  const configured = sails.config?.sounding?.environments
+
+  if (Array.isArray(configured)) {
+    return configured
+  }
+
+  return getDefaultConfig().environments
 }
 
 function shouldEnableHook(sails) {
-  return sails.config?.sounding?.enableInProduction === true || !isProductionEnvironment(sails)
+  return getEnabledEnvironments(sails).includes(getCurrentEnvironment(sails))
 }
 
 function soundingHook(sails) {
@@ -27,6 +37,7 @@ function soundingHook(sails) {
 
   return {
     defaults: {
+      // Hook defaults live under `sails.config.sounding`.
       sounding: getDefaultConfig(),
     },
 

package/lib/default-config.js

@@ -1,5 +1,7 @@
 const DEFAULT_CONFIG = Object.freeze({
-  enableInProduction: false,
+  // Sails environments where the Sounding hook should boot.
+  // Keep this test-only by default so non-test processes stay dark.
+  environments: ['test'],
   app: {
     path: '.',
     environment: 'test',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sounding",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Testing framework for Sails applications and The Boring JavaScript Stack.",
   "main": "index.js",
   "license": "MIT",