@saasicat/cli 1.0.0-rc.2 → 1.0.0-rc.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/cli",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.20",
   "description": "CLI helpers for SaaS platform consumers. Provides CliContextService (identity, MFA, production confirm, audit tag).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -30,9 +30,9 @@
   },
   "dependencies": {
     "qrcode-terminal": "^0.12.0",
-    "@saasicat/nest": "^1.0.0-rc.2",
-    "@saasicat/spec": "^1.0.0-rc.2",
-    "@saasicat/core": "^1.0.0-rc.2"
+    "@saasicat/nest": "^1.0.0-rc.20",
+    "@saasicat/spec": "^1.0.0-rc.20",
+    "@saasicat/core": "^1.0.0-rc.20"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",

package/templates/init/config/saas.yaml.tpl

@@ -1,5 +1,4 @@
 schemaVersion: 1
-projectKey: __PROJECT_KEY__
 
 app:
     name: __APP_LABEL__
@@ -8,12 +7,51 @@ app:
 currency: EUR
 vatRate: 19.0
 
+# What the tenant self-service routes may do, and on what terms. These live
+# here and nowhere else — an operator reading this file has to be reading the
+# values that are running, with no "unless somebody passed it in code"
+# attached. The file is read at boot, so an edit lands on the next restart.
+tenantBilling:
+    # How many days before the term ends a cancellation is still in time.
+    # Zero means there is no door to be shut out of: a cancellation on the last
+    # day still lands at the term end. Raise it and the cut is hard — a
+    # declaration made after the window lands one full period later, which on a
+    # yearly cycle is a year.
+    #
+    # Two rhythms, two numbers, and both are required. A month and a year
+    # cannot share a notice period, and a rhythm left out would read as zero:
+    # a commercial decision nobody made.
+    #
+    # Any value here may name an environment variable, `monthly: ${NOTICE_DAYS}`
+    # or with a default `${NOTICE_DAYS:-0}`, so one file serves every
+    # environment. It is resolved before the schema checks it, so the rules
+    # above still hold; a variable nobody set stops the boot and names itself.
+    cancellationNoticeDays:
+        monthly: 0
+        yearly: 0
+    # Plans a tenant may not reach or leave on its own — typically a plan that
+    # only a special contract activates. Empty is a statement, not an omission:
+    # it says self-service reaches every plan.
+    selfServiceBlockedPlans:
+        asTarget: []
+        asSource: []
+
 marketing:
     availableLocales: [en]
 
+# Who is mailed when a start finds the settings above changed since the previous
+# start. The change is recorded in the administration either way; mail needs an
+# email port bound as `adapters.email`, and without one the boot log says once
+# that the addresses reach nobody. Nobody is named here on purpose: this example
+# binds no mail, and an installation of one operator needs nothing else.
+#
+#   notifications:
+#       settingsChanged: [ops@example.com]
+
 # The quickstart path: plans live here, and `loadPlanCatalogFromFile` reads
 # them at boot. Apps that let operators manage plans in the SuperAdmin UI drop
-# this block and pass `dbCatalog` instead — see docs/quickstart.md.
+# this block and pass `dbCatalog: { path: 'config/saas.yaml' }` instead — the
+# settings above stay here either way. See docs/quickstart.md.
 plans:
     - id: STARTER
       name: Starter

package/templates/init/src/saas/admin-manifest.contribution.ts.tpl

@@ -19,7 +19,7 @@ export const __MANIFEST_CONST__: ManifestContribution = {
     dashboard: {
         kpiCards: [
             {
-                id: '__PROJECT_KEY__.tenants',
+                id: '__APP_KEY__.tenants',
                 label: 'Tenants',
                 // Served by your own controller — the platform does not know
                 // what your KPIs count.

package/templates/init/src/saas/persistence-without-hasher.ts.tpl

@@ -18,7 +18,7 @@ export const persistence = prismaPersistence({
     // If your models are called something else, map them here:
     // `adminResources: { delegates: { tenant: 'organization' },
     //                    fields: { tenant: { users: 'members' } } }`
-    // — see docs/migrating-an-existing-app.md. Left out on purpose otherwise:
+    // — see docs/guides/integrate-into-an-existing-app.md. Left out on purpose otherwise:
     // the tenant row counter defaults to whatever the mapping says the users
     // relation is called, and naming it here would hardcode `users` past that.
 });

package/templates/init/src/saas/persistence.ts.tpl

@@ -16,7 +16,7 @@ export const persistence = prismaPersistence({
     // If your models are called something else, map them here:
     // `adminResources: { delegates: { tenant: 'organization' },
     //                    fields: { tenant: { users: 'members' } } }`
-    // — see docs/migrating-an-existing-app.md. Left out on purpose otherwise:
+    // — see docs/guides/integrate-into-an-existing-app.md. Left out on purpose otherwise:
     // the tenant row counter defaults to whatever the mapping says the users
     // relation is called, and naming it here would hardcode `users` past that.
 });