@saasicat/cli 1.0.0-rc.3 → 1.0.0-rc.4

package/README.md

@@ -1,5 +1,7 @@
 # @saasicat/cli
 
+## What this is
+
 Cross-cutting helpers for consumer CLIs. Provides:
 
 - `CliContextService` — identity / MFA / production-confirm / audit-tag
@@ -12,6 +14,16 @@ Cross-cutting helpers for consumer CLIs. Provides:
 
 Spec: [`cli-conventions.md`][conventions] in `@saasicat/spec`.
 
+## What this is not
+
+Not a CLI. There is no binary here: these are `nest-commander` flows and
+services you register in **your** application's CLI, so they run with your
+DI container, your database connection and your configuration.
+
+Not the schema tooling either — `saasicat schema apply|check|migrate` and
+`saasicat init` ship in the `saasicat` binary of this package's `bin`, and
+are documented in the quickstart rather than here.
+
 ## Plugin Architecture
 
 Consumer CLIs are NestJS-Standalone applications based on
@@ -30,7 +42,17 @@ import { PrismaUserPortAdapter } from './adapters/prisma-user-port';
 @Module({
     imports: [
         PrismaModule,
-        PlanCatalogModule.forRoot({ path: './config/plans.yaml' }),
+        PlanCatalogModule.forRoot({
+            projectKey: 'myapp',
+            currency: 'EUR',
+            vatRate: 19,
+            // The catalogue is read from the database, not from a file — the
+            // CLI's `plan-catalog import` puts it there.
+            sink: {
+                useFactory: (p) => new PrismaPlanCatalogReadSink(p),
+                inject: [PrismaService],
+            },
+        }),
         AdminModule.forRoot({
             mfaPort: { useFactory: (p) => new PrismaMfaAdapter(p), inject: [PrismaService] },
             auditPort: { useFactory: (p) => new PrismaAuditAdapter(p), inject: [PrismaService] },
@@ -141,3 +163,8 @@ Per [`cli-conventions.md`][conventions] §6:
 | 99   | internal                                |
 
 [conventions]: https://github.com/uelker70/saasicat/blob/main/packages/spec/cli-conventions.md
+
+## Next
+
+- [Extend your CLI](../../docs/guides/extend-your-cli.md) — registering these flows in your app
+- [Quickstart](../../docs/quickstart.md) — `saasicat init`, `schema apply`, `schema check`

package/dist/.build-stamp

@@ -1 +1 @@
-50ce8728dd7552e453dc2c893c0d307dfd0f579444dbe981751740c140d74380
+6377a594af475a22f1a83fd0c3d2c8c4a01621960510601c5fbc36fe134a49b0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/cli",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "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.3",
-    "@saasicat/spec": "^1.0.0-rc.3",
-    "@saasicat/core": "^1.0.0-rc.3"
+    "@saasicat/nest": "^1.0.0-rc.4",
+    "@saasicat/spec": "^1.0.0-rc.4",
+    "@saasicat/core": "^1.0.0-rc.4"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",

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.
 });