@stratum-hq/create 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @stratum-hq/create
 
+## 0.5.1
+
+### Patch Changes
+
+- b737034: Improve the npm metadata so that npm search finds the packages. Each `description` now starts with the problem the package solves. Each package carries the same multi-tenancy keywords, including `multitenancy`. The `homepage` field now points at the package's page on https://docs.stratum-hq.org instead of a GitHub folder. The first lines of each README link the documentation. No code changes.
+- a1bd9aa: Replace em dashes in user-visible text with ordinary punctuation. This touches READMEs, package descriptions, CLI output, control plane startup log messages, the text that `@stratum-hq/create` writes into generated projects, and the assertion messages in `@stratum-hq/test-utils`. The CLI `health` and `migrate` tables now print `no` instead of a dash for an unset flag. No behavior changes.
+
 ## 0.5.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,8 @@
 # @stratum-hq/create
 
-Scaffold a complete [Stratum](https://github.com/stratum-hq/Stratum) multi-tenancy project with one command — package.json, Docker Compose, environment files, and framework-specific starter code.
+Scaffold a complete [Stratum](https://github.com/stratum-hq/Stratum) multi-tenancy project with one command: package.json, Docker Compose, environment files, and framework-specific starter code.
+
+Read the documentation at [docs.stratum-hq.org/packages/create](https://docs.stratum-hq.org/packages/create/).
 
 ## Usage
 
@@ -28,9 +30,9 @@ npx @stratum-hq/create my-app [options]
 
 ## Templates
 
-- **express** (default) — Express server with Stratum middleware, tenant-aware routes, and TypeScript config.
-- **fastify** — Fastify server with the Stratum plugin registered.
-- **nextjs** — Next.js project with edge middleware that resolves the tenant from a verified JWT.
+- **express** (default): Express server with Stratum middleware, tenant-aware routes, and TypeScript config.
+- **fastify**: Fastify server with the Stratum plugin registered.
+- **nextjs**: Next.js project with edge middleware that resolves the tenant from a verified JWT.
 
 ## After Scaffolding
 

package/dist/index.js

@@ -1012,14 +1012,17 @@ function generateTsconfig(framework, extraSources = []) {
 // ../hono/package.json
 var package_default = {
   name: "@stratum-hq/hono",
-  version: "1.2.0",
-  description: "Stratum Hono integration \u2014 tenant extraction middleware with ALS context",
+  version: "1.3.1",
+  description: "Hono multi-tenancy middleware: tenant resolution with AsyncLocalStorage context",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
+    "tenant-isolation",
     "hono",
+    "asynclocalstorage",
     "middleware",
     "typescript",
     "stratum"
@@ -1063,7 +1066,7 @@ var package_default = {
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/hono#readme",
+  homepage: "https://docs.stratum-hq.org/packages/hono/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1078,18 +1081,27 @@ var package_default = {
 // ../db-adapters/package.json
 var package_default2 = {
   name: "@stratum-hq/db-adapters",
-  version: "1.2.0",
-  description: "Stratum PostgreSQL adapters for tenant-scoped query isolation",
+  version: "1.4.0",
+  description: "Multi-tenant PostgreSQL row-level security for pg, Prisma, Drizzle, and Sequelize, plus schema-per-tenant and database-per-tenant isolation",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
     "tenant-isolation",
-    "postgresql",
-    "postgres",
     "row-level-security",
     "rls",
+    "postgresql",
+    "prisma",
+    "drizzle",
+    "drizzle-orm",
+    "sequelize",
+    "pg",
+    "node-postgres",
+    "schema-per-tenant",
+    "database-per-tenant",
+    "postgres",
     "schema-isolation",
     "database",
     "stratum"
@@ -1100,6 +1112,10 @@ var package_default2 = {
     ".": {
       types: "./dist/index.d.ts",
       default: "./dist/index.js"
+    },
+    "./pglite": {
+      types: "./dist/pglite/index.d.ts",
+      default: "./dist/pglite/index.js"
     }
   },
   files: [
@@ -1119,18 +1135,23 @@ var package_default2 = {
     registry: "https://registry.npmjs.org/"
   },
   dependencies: {
-    "@stratum-hq/core": "^1.4.0",
+    "@stratum-hq/core": "^1.5.1",
     pg: "^8.11.0"
   },
   peerDependencies: {
+    "@electric-sql/pglite": "^0.4.2",
     "drizzle-orm": ">=0.29.0"
   },
   peerDependenciesMeta: {
+    "@electric-sql/pglite": {
+      optional: true
+    },
     "drizzle-orm": {
       optional: true
     }
   },
   devDependencies: {
+    "@electric-sql/pglite": "^0.4.6",
     "@prisma/client": "^5.10.0",
     "@types/pg": "^8.11.0",
     "drizzle-orm": "^0.45.3",
@@ -1139,7 +1160,7 @@ var package_default2 = {
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/db-adapters#readme",
+  homepage: "https://docs.stratum-hq.org/packages/db-adapters/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1154,21 +1175,28 @@ var package_default2 = {
 // ../lib/package.json
 var package_default3 = {
   name: "@stratum-hq/lib",
-  version: "1.5.0",
-  description: "Stratum tenant management library - framework-agnostic business logic",
+  version: "1.7.0",
+  description: "Multi-tenancy for Node.js and PostgreSQL: tenant hierarchy, config inheritance, row-level security, ABAC, audit log, and GDPR tooling",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
-    "b2b",
     "tenant",
-    "tenant-management",
     "tenant-isolation",
-    "node",
-    "typescript",
-    "postgresql",
     "row-level-security",
     "rls",
+    "postgresql",
+    "tenant-hierarchy",
+    "ltree",
+    "abac",
+    "audit-log",
+    "encryption",
+    "webhooks",
+    "b2b",
+    "tenant-management",
+    "node",
+    "typescript",
     "schema-isolation",
     "config-inheritance",
     "gdpr",
@@ -1199,10 +1227,10 @@ var package_default3 = {
     registry: "https://registry.npmjs.org/"
   },
   dependencies: {
-    "@opentelemetry/api": "^1.9.0",
-    "@stratum-hq/core": "^1.5.0",
-    "@stratum-hq/db-adapters": "^1.2.0",
-    "@stratum-hq/sdk": "^1.3.0",
+    "@opentelemetry/api": "^1.0.0",
+    "@stratum-hq/core": "^1.5.1",
+    "@stratum-hq/db-adapters": "^1.4.0",
+    "@stratum-hq/sdk": "^1.3.1",
     pg: "^8.11.0"
   },
   peerDependencies: {
@@ -1214,13 +1242,14 @@ var package_default3 = {
     }
   },
   devDependencies: {
+    "@electric-sql/pglite": "^0.4.6",
     "@types/pg": "^8.11.0",
     typescript: "^5.4.0",
     vitest: "^4.1.11"
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/lib#readme",
+  homepage: "https://docs.stratum-hq.org/packages/lib/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1235,10 +1264,11 @@ var package_default3 = {
 // ../mongodb/package.json
 var package_default4 = {
   name: "@stratum-hq/mongodb",
-  version: "0.5.0",
-  description: "MongoDB tenant isolation for Stratum \u2014 shared collection, collection-per-tenant, and database-per-tenant strategies",
+  version: "0.6.1",
+  description: "MongoDB tenant isolation for Stratum: shared collection, collection-per-tenant, and database-per-tenant strategies",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
@@ -1271,8 +1301,8 @@ var package_default4 = {
     clean: "rm -rf dist"
   },
   dependencies: {
-    "@stratum-hq/core": "^1.5.0",
-    "@stratum-hq/sdk": "^1.3.0"
+    "@stratum-hq/core": "^1.5.1",
+    "@stratum-hq/sdk": "^1.3.1"
   },
   peerDependencies: {
     mongodb: "^6.0.0 || ^7.0.0"
@@ -1294,7 +1324,7 @@ var package_default4 = {
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/mongodb#readme",
+  homepage: "https://docs.stratum-hq.org/packages/mongodb/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1309,10 +1339,11 @@ var package_default4 = {
 // ../mysql/package.json
 var package_default5 = {
   name: "@stratum-hq/mysql",
-  version: "0.5.0",
-  description: "MySQL tenant isolation for Stratum \u2014 shared table, table-per-tenant, and database-per-tenant strategies",
+  version: "0.6.1",
+  description: "MySQL tenant isolation for Stratum: shared table, table-per-tenant, and database-per-tenant strategies",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
@@ -1347,8 +1378,8 @@ var package_default5 = {
     clean: "rm -rf dist"
   },
   dependencies: {
-    "@stratum-hq/core": "^1.5.0",
-    "@stratum-hq/sdk": "^1.3.0"
+    "@stratum-hq/core": "^1.5.1",
+    "@stratum-hq/sdk": "^1.3.1"
   },
   peerDependencies: {
     mysql2: "^3.0.0",
@@ -1370,6 +1401,7 @@ var package_default5 = {
   devDependencies: {
     knex: "^3.3.0",
     mysql2: "^3.24.4",
+    sequelize: "^6.37.8",
     typeorm: "^1.1.1",
     typescript: "^5.9.0",
     vitest: "^4.1.11"
@@ -1379,7 +1411,7 @@ var package_default5 = {
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/mysql#readme",
+  homepage: "https://docs.stratum-hq.org/packages/mysql/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1394,13 +1426,15 @@ var package_default5 = {
 // ../nestjs/package.json
 var package_default6 = {
   name: "@stratum-hq/nestjs",
-  version: "1.3.0",
-  description: "Stratum NestJS integration \u2014 StratumGuard, @Tenant() decorator, and StratumModule",
+  version: "1.3.1",
+  description: "NestJS multi-tenancy: tenant guard, @Tenant() decorator, and module for Stratum",
   keywords: [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
+    "tenant-isolation",
     "nestjs",
     "nest",
     "guard",
@@ -1453,7 +1487,7 @@ var package_default6 = {
   },
   license: "MIT",
   author: "Christian Crank",
-  homepage: "https://github.com/stratum-hq/Stratum/tree/main/packages/nestjs#readme",
+  homepage: "https://docs.stratum-hq.org/packages/nestjs/",
   bugs: "https://github.com/stratum-hq/Stratum/issues",
   engines: {
     node: ">=20.0.0"
@@ -1724,23 +1758,23 @@ npx drizzle-kit push
 function getStrategyDescription(strategy) {
   switch (strategy) {
     case "rls":
-      return `- **Row-Level Security** -- PostgreSQL RLS policies filter rows by tenant automatically
+      return `- **Row-Level Security**: PostgreSQL RLS policies filter rows by tenant automatically
 - Each query sets \`app.current_tenant_id\` and RLS enforces isolation
 - All tenants share one database and schema`;
     case "schema":
-      return `- **Schema-per-tenant** -- each tenant gets a dedicated PostgreSQL schema
+      return `- **Schema-per-tenant**: each tenant gets a dedicated PostgreSQL schema
 - Queries are routed to the correct schema via search_path
 - Shared database, isolated schemas`;
     case "database":
-      return `- **Database-per-tenant** -- each tenant gets a fully isolated database
+      return `- **Database-per-tenant**: each tenant gets a fully isolated database
 - Connection routing directs queries to the correct database
 - Maximum isolation at the cost of more resource usage`;
     case "collection":
-      return `- **Collection-per-tenant** -- each tenant gets dedicated MongoDB collections
+      return `- **Collection-per-tenant**: each tenant gets dedicated MongoDB collections
 - Collection names are prefixed or namespaced by tenant ID
 - Shared database, isolated collections`;
     case "table-prefix":
-      return `- **Table-prefix** -- tenant-specific tables with a naming prefix
+      return `- **Table-prefix**: tenant-specific tables with a naming prefix
 - Tables are prefixed with the tenant identifier
 - Shared database, prefixed table names`;
     default:
@@ -2093,7 +2127,7 @@ fastify.listen({ port, host: "0.0.0.0" }, (err) => {
 `;
 }
 function generateNextjsPage(projectName) {
-  return `// app/page.tsx \u2014 ${projectName} root page
+  return `// app/page.tsx: ${projectName} root page
 export default function Home() {
   return (
     <main style={{ padding: "2rem", fontFamily: "sans-serif" }}>
@@ -2126,7 +2160,7 @@ docker compose up -d
 
 \`\`\`bash
 cp .env.example .env
-# Edit .env \u2014 update DATABASE_URL, JWT_SECRET, and STRATUM_API_KEY
+# Edit .env: update DATABASE_URL, JWT_SECRET, and STRATUM_API_KEY
 \`\`\`
 
 ### 3. Install dependencies
@@ -2156,9 +2190,9 @@ ${template === "nextjs" ? "" : "\u251C\u2500\u2500 tsconfig.json\n"}\u2514\u2500
 
 This project uses Stratum for hierarchical multi-tenancy:
 
-- **Tenant resolution** \u2014 from the \`tenant_id\` claim of a bearer token verified with \`JWT_SECRET\` (see \`middleware.ts\`); the subdomain is only a display slug
-- **Config inheritance** \u2014 settings flow down the tenant tree with override support
-- **Permission ABAC** \u2014 role-based permissions with tenant-scoped enforcement
+- **Tenant resolution**: from the \`tenant_id\` claim of a bearer token verified with \`JWT_SECRET\` (see \`middleware.ts\`); the subdomain is only a display slug
+- **Config inheritance**: settings flow down the tenant tree with override support
+- **Permission ABAC**: role-based permissions with tenant-scoped enforcement
 
 See the [Stratum docs](https://github.com/stratum-hq/Stratum) for full reference.
 `;

package/package.json

@@ -1,12 +1,26 @@
 {
   "name": "@stratum-hq/create",
-  "version": "0.5.0",
-  "description": "Create a new Stratum multi-tenancy project",
+  "version": "0.5.1",
+  "description": "Scaffold a multi-tenant SaaS starter for Node.js: PostgreSQL, MySQL, or MongoDB with Express, Fastify, Next.js, Hono, or NestJS",
   "keywords": [
     "multi-tenancy",
+    "multitenancy",
     "multi-tenant",
     "saas",
     "tenant",
+    "tenant-isolation",
+    "row-level-security",
+    "rls",
+    "postgresql",
+    "mysql",
+    "mongodb",
+    "express",
+    "fastify",
+    "nextjs",
+    "hono",
+    "nestjs",
+    "prisma",
+    "drizzle",
     "create",
     "scaffolding",
     "starter",
@@ -40,7 +54,7 @@
   },
   "license": "MIT",
   "author": "Christian Crank",
-  "homepage": "https://github.com/stratum-hq/Stratum/tree/main/packages/create#readme",
+  "homepage": "https://docs.stratum-hq.org/packages/create/",
   "bugs": "https://github.com/stratum-hq/Stratum/issues",
   "engines": {
     "node": ">=20.0.0"

package/src/generators/readme.ts

@@ -86,23 +86,23 @@ npx drizzle-kit push
 function getStrategyDescription(strategy: string): string {
   switch (strategy) {
     case "rls":
-      return `- **Row-Level Security** -- PostgreSQL RLS policies filter rows by tenant automatically
+      return `- **Row-Level Security**: PostgreSQL RLS policies filter rows by tenant automatically
 - Each query sets \`app.current_tenant_id\` and RLS enforces isolation
 - All tenants share one database and schema`;
     case "schema":
-      return `- **Schema-per-tenant** -- each tenant gets a dedicated PostgreSQL schema
+      return `- **Schema-per-tenant**: each tenant gets a dedicated PostgreSQL schema
 - Queries are routed to the correct schema via search_path
 - Shared database, isolated schemas`;
     case "database":
-      return `- **Database-per-tenant** -- each tenant gets a fully isolated database
+      return `- **Database-per-tenant**: each tenant gets a fully isolated database
 - Connection routing directs queries to the correct database
 - Maximum isolation at the cost of more resource usage`;
     case "collection":
-      return `- **Collection-per-tenant** -- each tenant gets dedicated MongoDB collections
+      return `- **Collection-per-tenant**: each tenant gets dedicated MongoDB collections
 - Collection names are prefixed or namespaced by tenant ID
 - Shared database, isolated collections`;
     case "table-prefix":
-      return `- **Table-prefix** -- tenant-specific tables with a naming prefix
+      return `- **Table-prefix**: tenant-specific tables with a naming prefix
 - Tables are prefixed with the tenant identifier
 - Shared database, prefixed table names`;
     default:

package/src/index.ts

@@ -296,7 +296,7 @@ fastify.listen({ port, host: "0.0.0.0" }, (err) => {
 }
 
 function generateNextjsPage(projectName: string): string {
-  return `// app/page.tsx — ${projectName} root page
+  return `// app/page.tsx: ${projectName} root page
 export default function Home() {
   return (
     <main style={{ padding: "2rem", fontFamily: "sans-serif" }}>
@@ -330,7 +330,7 @@ docker compose up -d
 
 \`\`\`bash
 cp .env.example .env
-# Edit .env — update DATABASE_URL, JWT_SECRET, and STRATUM_API_KEY
+# Edit .env: update DATABASE_URL, JWT_SECRET, and STRATUM_API_KEY
 \`\`\`
 
 ### 3. Install dependencies
@@ -360,9 +360,9 @@ ${template === "nextjs" ? "" : "├── tsconfig.json\n"}└── package.jso
 
 This project uses Stratum for hierarchical multi-tenancy:
 
-- **Tenant resolution** — from the \`tenant_id\` claim of a bearer token verified with \`JWT_SECRET\` (see \`middleware.ts\`); the subdomain is only a display slug
-- **Config inheritance** — settings flow down the tenant tree with override support
-- **Permission ABAC** — role-based permissions with tenant-scoped enforcement
+- **Tenant resolution**: from the \`tenant_id\` claim of a bearer token verified with \`JWT_SECRET\` (see \`middleware.ts\`); the subdomain is only a display slug
+- **Config inheritance**: settings flow down the tenant tree with override support
+- **Permission ABAC**: role-based permissions with tenant-scoped enforcement
 
 See the [Stratum docs](https://github.com/stratum-hq/Stratum) for full reference.
 `;

package/src/matrix.ts

@@ -75,7 +75,7 @@ export function parsePresetString(s: string): StackPreset | null {
 
   const parts = s.toLowerCase().split("-");
 
-  // Handle "table-prefix" which contains a hyphen -- it will split into
+  // Handle "table-prefix" which contains a hyphen; it will split into
   // 5 parts: [db, strategy1, "table", "prefix", orm, framework] or similar.
   // We need to reconstruct multi-word tokens.
   // Format: {database}-{strategy}-{orm}-{framework}