create-headless-lms 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-headless-lms",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "create-headless-lms": "dist/index.js"

package/templates/env.tmpl

@@ -11,5 +11,6 @@ CREDENTIAL_STORE_KEY={{CREDENTIAL_STORE_KEY}}
 
 DELIVERY_URL_EXPIRY=86400
 MEMBER_IMAGE_MAX_BYTES=10485760
+MEMBER_FILE_MAX_BYTES=104857600
 REQUEST_LOGGING=true
 {{STORAGE_ENV}}

package/templates/src/config.ts

@@ -18,6 +18,7 @@ export function loadStorageConfig(): MinioStorageConfig | undefined {
     secretKey: process.env.STORAGE_SECRET_KEY ?? "",
     region: process.env.STORAGE_REGION ?? "us-east-1",
     bucket: process.env.STORAGE_BUCKET ?? "headless-lms",
+    ...(process.env.STORAGE_PUBLIC_URL ? { publicUrl: process.env.STORAGE_PUBLIC_URL } : {}),
     uploadExpirySeconds: Number(process.env.STORAGE_UPLOAD_EXPIRY ?? 300),
     downloadExpirySeconds: Number(process.env.STORAGE_DOWNLOAD_EXPIRY ?? 86400),
   };
@@ -35,6 +36,18 @@ export function parseMemberImageMaxBytes(): number {
   return value;
 }
 
+export function parseMemberFileMaxBytes(): number {
+  const raw = process.env.MEMBER_FILE_MAX_BYTES;
+  if (raw === undefined || raw === "") {
+    return 100 * 1024 * 1024;
+  }
+  const value = Number(raw);
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new Error(`invalid MEMBER_FILE_MAX_BYTES "${raw}" (expected a positive integer)`);
+  }
+  return value;
+}
+
 /** Browser app origins from CLIENT_ORIGIN (comma-separated). */
 export function parseClientOrigins(): string[] {
   return (process.env.CLIENT_ORIGIN ?? "http://localhost:8001,http://localhost:8002")
@@ -43,6 +56,22 @@ export function parseClientOrigins(): string[] {
     .filter(Boolean);
 }
 
+function loadPlatformConfig(): ContainerConfig["platform"] {
+  const key = process.env.PLATFORM_KEY;
+  if (!key) {
+    return undefined;
+  }
+  const accountEmail = process.env.PLATFORM_ACCOUNT_EMAIL;
+  if (!accountEmail) {
+    throw new Error("PLATFORM_KEY is set: set PLATFORM_ACCOUNT_EMAIL too");
+  }
+  return {
+    key,
+    accountEmail,
+    ...(process.env.PLATFORM_ACCOUNT_NAME && { accountName: process.env.PLATFORM_ACCOUNT_NAME }),
+  };
+}
+
 function loadContainerConfig(): ContainerConfig {
   const clientOrigins = parseClientOrigins();
   const apiOrigin = process.env.BETTER_AUTH_URL ?? "http://localhost:8000";
@@ -57,6 +86,7 @@ function loadContainerConfig(): ContainerConfig {
     secureCookies: process.env.NODE_ENV === "production",
     studentPortalUrl: process.env.STUDENT_PORTAL_URL ?? "http://localhost:8002",
     adminAppUrl: process.env.ADMIN_APP_URL ?? "http://localhost:8001",
+    platform: loadPlatformConfig(),
   };
 }
 
@@ -73,6 +103,10 @@ export function loadServerConfig(): ServerConfig {
     // default must never silently extend entitled/paywalled link lifetimes.
     deliveryExpirySeconds: Number(process.env.DELIVERY_URL_EXPIRY ?? 86400),
     memberImageMaxBytes: parseMemberImageMaxBytes(),
+    memberFileMaxBytes: parseMemberFileMaxBytes(),
+    // LISTEN needs a session connection; behind a transaction-mode pooler
+    // point PUBSUB_DATABASE_URL at Postgres directly.
+    pubsubDatabaseUrl: process.env.PUBSUB_DATABASE_URL || container.databaseUrl,
     container,
   };
 }

package/templates/src/main.ts

@@ -1,6 +1,6 @@
 // Process entry point: env → config → container → server → listen.
 import { fileURLToPath } from "node:url";
-import { createContainer, buildServer } from "@headless-lms/server";
+import { createContainer, buildServer, closeOnSignals } from "@headless-lms/server";
 import { MinioStorageAdapter } from "@headless-lms/adapter-storage-minio";
 import { loadServerConfig, loadStorageConfig } from "./config.js";
 
@@ -22,7 +22,10 @@ try {
   app.log.error(err);
   process.exit(1);
 }
+closeOnSignals(app);
 
+await container.pubsub?.start();
+await container.chatHub?.start();
 container.outboxRelay.start();
 container.automationEngine.start().catch((err) => {
   container.logger.error("automation engine failed to start", {