@astralarium/repo-env 0.1.0 → 0.2.0

package/README.md

@@ -2,3 +2,19 @@
 
 Validated Wrangler bindings shared by workers.
 Apps spread `coreEnvironment(config)` into their environment.
+
+```ts
+export const appSiteOrigin = createIsomorphicFn()
+  .server(() => {
+    let requestOrigin: string | undefined;
+    try {
+      requestOrigin = getRequestUrl().origin;
+    } catch {
+      /* Outside a request: prerender, startup. */
+    }
+    return siteOrigin(publicWebConfig(env), requestOrigin);
+  })
+  .client(() => window.location.origin);
+
+const sql = postgres(databaseConnectionString(env)); // DB_APP Hyperdrive
+```

package/dist/index.d.ts

@@ -47,5 +47,18 @@ export declare function publicWebConfig(env: PublicWebEnvironment): {
         hostnames: string[];
     };
 };
+/** Origin the site answers on: `requestOrigin` when it is one of the local
+ *  origins, else the configured site origin. */
+export declare function siteOrigin(config: ReturnType<typeof publicWebConfig>, requestOrigin?: string): string;
 /** Validated process environment every worker shares. */
 export declare function coreEnvironment(config: CoreConfig): CoreEnvironment;
+/** Bindings carrying the app database's Hyperdrive. */
+export interface DatabaseEnvironment {
+    /** App database Hyperdrive; unbound during static prerender. */
+    DB_APP?: {
+        connectionString: string;
+    };
+}
+/** The `DB_APP` Hyperdrive connection string. Throws while the binding is
+ *  absent (static prerender). */
+export declare function databaseConnectionString(env: DatabaseEnvironment): string;

package/dist/index.js

@@ -50,6 +50,13 @@ export function publicWebConfig(env) {
         localOrigins: parseLocalOrigins(env.LOCAL_ORIGINS),
     };
 }
+/** Origin the site answers on: `requestOrigin` when it is one of the local
+ *  origins, else the configured site origin. */
+export function siteOrigin(config, requestOrigin) {
+    return requestOrigin && config.localOrigins.origins.includes(requestOrigin)
+        ? requestOrigin
+        : config.siteOrigin;
+}
 /** Validated process environment every worker shares. */
 export function coreEnvironment(config) {
     if (config.authSecret.length < 32)
@@ -71,3 +78,10 @@ export function coreEnvironment(config) {
         LOCAL_ORIGINS: parseLocalOrigins(config.localOrigins?.join(",")).origins.join(","),
     };
 }
+/** The `DB_APP` Hyperdrive connection string. Throws while the binding is
+ *  absent (static prerender). */
+export function databaseConnectionString(env) {
+    if (!env.DB_APP)
+        throw new Error("DB_APP is unavailable: database access requires runtime bindings");
+    return env.DB_APP.connectionString;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astralarium/repo-env",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "homepage": "https://github.com/astralarium/repo/tree/main/packages/repo-env#readme",
   "repository": {
@@ -20,16 +20,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@astralarium/repo-telemetry": "^0.1.0"
+    "@astralarium/repo-telemetry": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^24.2.0",
     "eslint": "^10.2.1",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3",
-    "@astralarium/repo-config-typescript": "^0.1.0",
-    "@astralarium/repo-config-eslint": "^0.1.0",
-    "@astralarium/repo-package-files": "^0.1.0"
+    "@astralarium/repo-package-files": "^0.1.0",
+    "@astralarium/repo-config-eslint": "^0.3.0",
+    "@astralarium/repo-config-typescript": "^0.1.0"
   },
   "engines": {
     "node": ">=24.2"