@cedarjs/project-config 6.0.0-canary.2818 → 6.0.0-canary.2819

package/dist/cjs/envVars.d.ts

@@ -0,0 +1,32 @@
+interface ReadEnvVarOptions {
+    /**
+     * The pre-fork `REDWOOD_`-prefixed name for this env var. Still read, so
+     * projects don't break on upgrade, but the `CEDAR_`-prefixed name wins.
+     */
+    deprecatedAlias: string;
+}
+/**
+ * Read an env var that was renamed when Cedar forked from Redwood.
+ *
+ * The `CEDAR_`-prefixed name wins. The `REDWOOD_`-prefixed one keeps working
+ * so existing projects don't break on upgrade.
+ *
+ * Empty strings are treated as unset, matching how a `.env` file with a blank
+ * value behaves.
+ */
+export declare function readEnvVar(name: string, { deprecatedAlias }: ReadEnvVarOptions): string | undefined;
+/**
+ * Parse a port from an env var, rejecting anything that isn't a usable port.
+ *
+ * `parseInt` alone is not enough here: it stops at the first non-digit, so
+ * `"8080abc"` would become `8080` and `"1.5"` would become `1`. Silently
+ * binding a port the user didn't ask for is how a deployment ends up
+ * unreachable, so the whole value has to look like an integer.
+ *
+ * Out-of-range values are rejected here too, so a bad env var is reported as
+ * a bad env var rather than surfacing later as a `ERR_SOCKET_BAD_PORT` from
+ * `listen()`. Port 0 is allowed — it means "pick a free port".
+ */
+export declare function parsePort(value: string, envVarName: string): number;
+export {};
+//# sourceMappingURL=envVars.d.ts.map

package/dist/cjs/envVars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../../src/envVars.ts"],"names":[],"mappings":"AAAA,UAAU,iBAAiB;IACzB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,EAAE,eAAe,EAAE,EAAE,iBAAiB,GACrC,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBnE"}

package/dist/cjs/index.d.ts

@@ -1,5 +1,6 @@
 export * from './config.js';
 export * from './configPath.js';
+export * from './envVars.js';
 export * from './generatedDataDir.js';
 export * from './paths.js';
 export * from './findUp.js';

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/cjs/index.js

@@ -54,10 +54,12 @@ __export(index_exports, {
   importStatementPath: () => importStatementPath,
   isTypeScriptProject: () => isTypeScriptProject,
   loadPrismaConfig: () => loadPrismaConfig,
+  parsePort: () => parsePort,
   processPagesDir: () => processPagesDir,
   projectIsEsm: () => projectIsEsm,
   projectRootIsEsm: () => projectRootIsEsm,
   projectSideIsEsm: () => projectSideIsEsm,
+  readEnvVar: () => readEnvVar,
   resolveFile: () => resolveFile,
   resolveGeneratedPrismaClient: () => resolveGeneratedPrismaClient
 });
@@ -213,6 +215,26 @@ function getRawConfig(configPath = getConfigPath()) {
   }
 }
 
+// src/envVars.ts
+function readEnvVar(name, { deprecatedAlias }) {
+  return process.env[name] || process.env[deprecatedAlias] || void 0;
+}
+function parsePort(value, envVarName) {
+  const trimmed = value.trim();
+  if (!/^\d+$/.test(trimmed)) {
+    throw new Error(
+      `Invalid ${envVarName} env var value: "${value}". Must be an integer.`
+    );
+  }
+  const port = Number(trimmed);
+  if (port > 65535) {
+    throw new Error(
+      `Invalid ${envVarName} env var value: "${value}". Must be between 0 and 65535.`
+    );
+  }
+  return port;
+}
+
 // src/generatedDataDir.ts
 var import_node_fs3 = __toESM(require("node:fs"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
@@ -656,10 +678,12 @@ function getEnvVarDefinitions() {
   importStatementPath,
   isTypeScriptProject,
   loadPrismaConfig,
+  parsePort,
   processPagesDir,
   projectIsEsm,
   projectRootIsEsm,
   projectSideIsEsm,
+  readEnvVar,
   resolveFile,
   resolveGeneratedPrismaClient
 });

package/dist/envVars.d.ts

@@ -0,0 +1,32 @@
+interface ReadEnvVarOptions {
+    /**
+     * The pre-fork `REDWOOD_`-prefixed name for this env var. Still read, so
+     * projects don't break on upgrade, but the `CEDAR_`-prefixed name wins.
+     */
+    deprecatedAlias: string;
+}
+/**
+ * Read an env var that was renamed when Cedar forked from Redwood.
+ *
+ * The `CEDAR_`-prefixed name wins. The `REDWOOD_`-prefixed one keeps working
+ * so existing projects don't break on upgrade.
+ *
+ * Empty strings are treated as unset, matching how a `.env` file with a blank
+ * value behaves.
+ */
+export declare function readEnvVar(name: string, { deprecatedAlias }: ReadEnvVarOptions): string | undefined;
+/**
+ * Parse a port from an env var, rejecting anything that isn't a usable port.
+ *
+ * `parseInt` alone is not enough here: it stops at the first non-digit, so
+ * `"8080abc"` would become `8080` and `"1.5"` would become `1`. Silently
+ * binding a port the user didn't ask for is how a deployment ends up
+ * unreachable, so the whole value has to look like an integer.
+ *
+ * Out-of-range values are rejected here too, so a bad env var is reported as
+ * a bad env var rather than surfacing later as a `ERR_SOCKET_BAD_PORT` from
+ * `listen()`. Port 0 is allowed — it means "pick a free port".
+ */
+export declare function parsePort(value: string, envVarName: string): number;
+export {};
+//# sourceMappingURL=envVars.d.ts.map

package/dist/envVars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":"AAAA,UAAU,iBAAiB;IACzB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,EAAE,eAAe,EAAE,EAAE,iBAAiB,GACrC,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBnE"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './config.js';
 export * from './configPath.js';
+export * from './envVars.js';
 export * from './generatedDataDir.js';
 export * from './paths.js';
 export * from './findUp.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -148,6 +148,26 @@ function getRawConfig(configPath = getConfigPath()) {
   }
 }
 
+// src/envVars.ts
+function readEnvVar(name, { deprecatedAlias }) {
+  return process.env[name] || process.env[deprecatedAlias] || void 0;
+}
+function parsePort(value, envVarName) {
+  const trimmed = value.trim();
+  if (!/^\d+$/.test(trimmed)) {
+    throw new Error(
+      `Invalid ${envVarName} env var value: "${value}". Must be an integer.`
+    );
+  }
+  const port = Number(trimmed);
+  if (port > 65535) {
+    throw new Error(
+      `Invalid ${envVarName} env var value: "${value}". Must be between 0 and 65535.`
+    );
+  }
+  return port;
+}
+
 // src/generatedDataDir.ts
 import fs3 from "node:fs";
 import path2 from "node:path";
@@ -590,10 +610,12 @@ export {
   importStatementPath,
   isTypeScriptProject,
   loadPrismaConfig,
+  parsePort,
   processPagesDir,
   projectIsEsm,
   projectRootIsEsm,
   projectSideIsEsm,
+  readEnvVar,
   resolveFile,
   resolveGeneratedPrismaClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/project-config",
-  "version": "6.0.0-canary.2818",
+  "version": "6.0.0-canary.2819",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cedarjs/cedar.git",
@@ -64,7 +64,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
-    "@cedarjs/framework-tools": "6.0.0-canary.2818",
+    "@cedarjs/framework-tools": "6.0.0-canary.2819",
     "concurrently": "9.2.4",
     "prisma": "7.8.0",
     "publint": "0.3.22",