@luckystack/server 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.2] - 2026-07-27
+
+### Fixed
+
+- Processes can compose non-overlapping atomic presets whose generated maps repeat the same full function registry; equivalent function entries deduplicate while conflicting function implementations and duplicate API/sync ownership still fail closed.
+
+## [0.8.1] - 2026-07-27
+
+### Fixed
+
+- Production route maps, dev-tool startup, cookie security, bootstrap checks and port auto-increment now follow `NODE_ENV`; named topology environments remain available for health and routing identity.
+
 ## [0.8.0] - 2026-07-27
 
 ### Added

package/CLAUDE.md

@@ -36,7 +36,7 @@ One-call server bootstrap for a LuckyStack project. Wires together a raw Node.js
 | `getParsedBundles()` | Returns the preset list parsed by `applyServerArgv()` (empty array before first call). | -> docs/argv-parsing.md |
 | `getParsedPort()` | Returns the port parsed by `applyServerArgv()` (`null` if argv omitted it). | -> docs/argv-parsing.md |
 | `@luckystack/server/parseArgv` (side-effect import) | First-line import that runs `applyServerArgv()` before any module reads `process.env.SERVER_PORT` (notably `config.ts`). | -> docs/argv-parsing.md |
-| `createProdRuntimeMapsProvider(options)` | Build a `RuntimeMapsProvider` that loads generated maps in prod and delegates to devkit discovery in dev. Returns the provider without registering. | -> docs/runtime-maps.md |
+| `createProdRuntimeMapsProvider(options)` | Build a `RuntimeMapsProvider` that loads generated maps in prod and delegates to devkit discovery in dev. Composed presets reject duplicate API/sync ownership, deduplicate equivalent full-registry function entries, and reject differing function implementations. Returns the provider without registering. | -> docs/runtime-maps.md |
 | `registerProdRuntimeMapsProvider(options)` | Convenience wrapper: builds the provider AND calls `registerRuntimeMapsProvider`. Most consumers want this. | -> docs/runtime-maps.md |
 | `registerCustomRoute(handler, options?)` | Append a custom HTTP route handler. `options.phase`: `'post-params'` (default, runs after body parse) or `'pre-params'` (runs before `getParams`, raw `req` stream intact — webhooks + streaming uploads). | -> /docs/ARCHITECTURE_HTTP.md |
 | `getCustomRoutes()` | Read the `'post-params'` registry snapshot (the default phase). | -> /docs/ARCHITECTURE_HTTP.md |

package/dist/index.d.ts

@@ -110,7 +110,7 @@ interface CreateLuckyStackServerOptions {
     customRoutes?: CustomRouteHandler;
     /**
      * Enable dev-mode tooling (devkit hot reload, REPL, console init).
-     * Defaults to `resolveEnvKey() !== 'production'`.
+     * Defaults to `resolveRuntimeMode() !== 'production'` (NODE_ENV-based).
      */
     enableDevTools?: boolean;
     /**

package/dist/index.js

@@ -9,7 +9,7 @@ import {
 
 // src/createServer.ts
 import http from "http";
-import { registerBindAddress, registerBoundAddress, writeBootUuid, startBootUuidHeartbeat, getLogger as getLogger13, getProjectConfig as getProjectConfig15, tryCatch as tryCatch10, tryCatchSync as tryCatchSync3, resolveEnvKey as resolveEnvKey5, dispatchHook as dispatchHook8 } from "@luckystack/core";
+import { registerBindAddress, registerBoundAddress, writeBootUuid, startBootUuidHeartbeat, getLogger as getLogger13, getProjectConfig as getProjectConfig15, tryCatch as tryCatch10, tryCatchSync as tryCatchSync3, resolveRuntimeMode, dispatchHook as dispatchHook8 } from "@luckystack/core";
 
 // src/httpHandler.ts
 import { randomUUID } from "crypto";
@@ -475,11 +475,11 @@ import {
 } from "@luckystack/core";
 
 // src/httpRoutes/sessionCookie.ts
-import { resolveEnvKey as resolveEnvKey2 } from "@luckystack/core";
+import { isProductionRuntime } from "@luckystack/core";
 var resolveCookieSecure = (sessionCookieSecure, secureEnv) => {
   if (sessionCookieSecure !== void 0) return sessionCookieSecure;
   if (secureEnv === "true") return true;
-  return resolveEnvKey2() === "production";
+  return isProductionRuntime();
 };
 
 // src/httpRoutes/authApiRoute.ts
@@ -2020,7 +2020,7 @@ import {
   isLocalizedNormalizerRegistered,
   isProjectConfigRegistered,
   isRuntimeMapsProviderRegistered,
-  resolveEnvKey as resolveEnvKey3
+  isProductionRuntime as isProductionRuntime2
 } from "@luckystack/core";
 var verifyBootstrap = async (requirements = {}) => {
   const missing = [];
@@ -2059,7 +2059,7 @@ var verifyBootstrap = async (requirements = {}) => {
     }
   }
   if (!isRuntimeMapsProviderRegistered()) {
-    if (resolveEnvKey3() === "production") {
+    if (isProductionRuntime2()) {
       missing.push(
         "RuntimeMapsProvider \u2014 call `registerRuntimeMapsProvider({...})` from `server/prod/runtimeMaps.ts`. Without it, every api/sync request returns notFound."
       );
@@ -2070,7 +2070,7 @@ var verifyBootstrap = async (requirements = {}) => {
     }
   }
   if (!isLocalizedNormalizerRegistered()) {
-    if (resolveEnvKey3() === "production") {
+    if (isProductionRuntime2()) {
       missing.push(
         "LocalizedNormalizer \u2014 call `registerLocalizedNormalizer({...})` from your bootstrap. Without it, error response messages will be the raw errorCode (no i18n)."
       );
@@ -2113,7 +2113,7 @@ var verifyBootstrap = async (requirements = {}) => {
 import {
   getLogger as getLogger10,
   registerRuntimeMapsProvider,
-  resolveEnvKey as resolveEnvKey4
+  isProductionRuntime as isProductionRuntime3
 } from "@luckystack/core";
 var emptyRuntimeMaps = {
   apisObject: {},
@@ -2151,10 +2151,20 @@ var resolvePresets = (options) => {
   }
   return ["default"];
 };
+var areEquivalentFunctionEntries = (left, right) => {
+  if (Object.is(left, right)) return true;
+  if (!isRuntimeMapRecord(left) || !isRuntimeMapRecord(right)) return false;
+  const leftKeys = Object.keys(left);
+  const rightKeys = Object.keys(right);
+  return leftKeys.length === rightKeys.length && leftKeys.every((key) => Object.hasOwn(right, key) && Object.is(left[key], right[key]));
+};
 var mergeInto = (target, source, kind, fromPreset, keyOrigin) => {
   for (const key of Object.keys(source)) {
     const previousPreset = keyOrigin.get(key);
     if (previousPreset !== void 0 && previousPreset !== fromPreset) {
+      if (kind === "function" && areEquivalentFunctionEntries(target[key], source[key])) {
+        continue;
+      }
       throw new Error(
         `[luckystack:runtimeMaps] ${kind} key collision: "${key}" present in both preset "${previousPreset}" and preset "${fromPreset}". Services must belong to exactly one preset (see docs/ARCHITECTURE_PACKAGING.md \xA710).`
       );
@@ -2163,7 +2173,7 @@ var mergeInto = (target, source, kind, fromPreset, keyOrigin) => {
     target[key] = source[key];
   }
 };
-var isProduction = () => resolveEnvKey4() === "production";
+var isProduction = () => isProductionRuntime3();
 var createProdRuntimeMapsProvider = (options) => {
   let prodMapsPromise = null;
   let devkitModulePromise = null;
@@ -2371,9 +2381,9 @@ var initDevTools = async () => {
 };
 var listenLuckyStackServer = (httpServer, ip, port, callback) => new Promise((resolve, reject) => {
   const startPort = normalizeServerPort(port);
-  const environmentKey = resolveEnvKey5();
-  const production = environmentKey === "production";
-  const test = environmentKey === "test";
+  const runtimeMode = resolveRuntimeMode();
+  const production = runtimeMode === "production";
+  const test = runtimeMode === "test";
   const autoIncrementEnv = (process.env.SERVER_PORT_AUTO_INCREMENT ?? "").toLowerCase();
   let autoIncrement;
   if (["0", "false"].includes(autoIncrementEnv)) autoIncrement = false;
@@ -2456,7 +2466,7 @@ var createLuckyStackServer = async (options = {}) => {
     envPort: process.env.SERVER_PORT
   });
   const ip = options.ip ?? process.env.SERVER_IP ?? "127.0.0.1";
-  const enableDevTools = options.enableDevTools ?? resolveEnvKey5() !== "production";
+  const enableDevTools = options.enableDevTools ?? resolveRuntimeMode() !== "production";
   registerBindAddress({ ip, port });
   if (enableDevTools) {
     await initDevTools();