@saasicat/spec 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/spec",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Language-neutral spec of the SaaS platform: JSON Schemas, OpenAPI contract, Prisma fragments, acceptance scenarios.",
   "type": "module",
   "main": "./index.cjs",

package/prisma-fragments/03-plan-versions.prisma

@@ -76,6 +76,12 @@ model PlanVersion {
     changeNote       String
     nonRegressive    Boolean @default(true)
 
+    // Booking window for new subscriptions. Nullable for backwards-compatible
+    // legacy rows; `endsAt` is an optional precise administrative termination.
+    validFrom  DateTime?
+    validUntil DateTime?
+    endsAt     DateTime?
+
     createdByUserId   String?
     publishedByUserId String?
 
@@ -90,5 +96,6 @@ model PlanVersion {
     @@unique([planId, version])
     @@index([planId, supersededAt])
     @@index([planId, publishedAt])
+    @@index([planId, validFrom])
     @@map("plan_versions")
 }

package/prisma-fragments/05-bundle.prisma

@@ -76,6 +76,12 @@ model BundleVersion {
     changeNote       String  @default("")
     nonRegressive    Boolean @default(true)
 
+    // Booking window for new subscriptions. Both columns are nullable so this
+    // schema change is additive and existing rows remain valid. Legacy adapters
+    // may ignore them; time-aware adapters opt in explicitly.
+    validFrom  DateTime?
+    validUntil DateTime?
+
     createdByUserId   String?
     publishedByUserId String?
 
@@ -92,5 +98,6 @@ model BundleVersion {
     @@unique([bundleId, version])
     @@index([bundleId, supersededAt])
     @@index([bundleId, publishedAt])
+    @@index([bundleId, validFrom])
     @@map("bundle_versions")
 }

package/prisma-fragments/README.md

@@ -28,18 +28,19 @@ regenerated after fragment changes (`tests/reference-sql-drift.test.js`).
 
 ## Files
 
-| File                                                                 | Models                                                                 |
-| -------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| [`01-subscription.prisma`](01-subscription.prisma)                   | `Subscription`, `SubscriptionPaymentMethod`, `CheckoutOffer` + Enums   |
-| [`02-promo-code.prisma`](02-promo-code.prisma)                       | `PromoCode`, `PromoCodeRedemption`, `PromoCodeValidationLog` + Enums   |
-| [`03-plan-versions.prisma`](03-plan-versions.prisma)                 | `Plan`, `PlanVersion`                                                  |
-| [`04-audit-log.prisma`](04-audit-log.prisma)                         | `AuditLog`                                                             |
-| [`05-bundle.prisma`](05-bundle.prisma)                               | `Bundle`, `BundleVersion`                                              |
-| [`06-catalog-entries.prisma`](06-catalog-entries.prisma)             | `CapabilityCatalogEntry`, `FeatureCatalogEntry`, `MarketingProjection` |
-| [`07-promotion.prisma`](07-promotion.prisma)                         | `Promotion`                                                            |
-| [`08-subscription-contract.prisma`](08-subscription-contract.prisma) | `SubscriptionContract`, `ContractLineItem`                             |
-| [`09-pending-registration.prisma`](09-pending-registration.prisma)   | `PendingRegistration`, `PaymentEventLog` + `RegistrationStatus`        |
-| [`10-super-admin.prisma`](10-super-admin.prisma)                     | `SuperAdminUser`, `SuperAdminMfa`                                      |
+| File                                                                 | Models                                                               |
+| -------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [`01-subscription.prisma`](01-subscription.prisma)                   | `Subscription`, `SubscriptionPaymentMethod`, `CheckoutOffer` + Enums |
+| [`02-promo-code.prisma`](02-promo-code.prisma)                       | `PromoCode`, `PromoCodeRedemption`, `PromoCodeValidationLog` + Enums |
+| [`03-plan-versions.prisma`](03-plan-versions.prisma)                 | `Plan`, `PlanVersion`                                                |
+| [`04-audit-log.prisma`](04-audit-log.prisma)                         | `AuditLog`                                                           |
+| [`05-bundle.prisma`](05-bundle.prisma)                               | `Bundle`, `BundleVersion`                                            |
+| [`06-catalog-entries.prisma`](06-catalog-entries.prisma)             | Capability, feature, quota and marketing catalog models              |
+| [`07-promotion.prisma`](07-promotion.prisma)                         | `Promotion`                                                          |
+| [`08-subscription-contract.prisma`](08-subscription-contract.prisma) | `SubscriptionContract`, `ContractLineItem`                           |
+| [`09-pending-registration.prisma`](09-pending-registration.prisma)   | `PendingRegistration`, `PaymentEventLog` + `RegistrationStatus`      |
+| [`10-super-admin.prisma`](10-super-admin.prisma)                     | `SuperAdminUser`, `SuperAdminMfa`                                    |
+| [`11-subscription-bundle.prisma`](11-subscription-bundle.prisma)     | `SubscriptionBundle`                                                 |
 
 ## How the consumer uses the fragments
 
@@ -83,10 +84,14 @@ comment. The consumer enables them using their own `Tenant`/`User` model names.
 
 ### 3. Table names (`@@map`) are canonical
 
-`subscriptions`, `plan_versions`, `promo_codes`, `promo_code_redemptions`,
+`subscriptions`, `subscription_payment_methods`, `checkout_offers`, `plans`,
+`plan_versions`, `promo_codes`, `promo_code_redemptions`,
 `promo_code_validation_logs`, `audit_logs`, `bundles`, `bundle_versions`,
 `capability_catalog_entries`, `feature_catalog_entries`,
-`marketing_projections`, `subscription_contracts`, `contract_line_items`.
+`quota_catalog_entries`, `marketing_projections`, `marketing_settings`,
+`promotions`, `subscription_contracts`, `contract_line_items`,
+`pending_registrations`, `payment_event_logs`, `super_admin_users`,
+`super_admin_mfa`, `subscription_bundles`.
 Please do **not change** them — otherwise platform migration scripts and the
 `@saasicat/cli` commands that rely on these names will break.
 

package/schemas/admin-manifest.schema.json

@@ -127,7 +127,6 @@
                         "subscriptions": { "$ref": "#/$defs/StandardPageDef" },
                         "promoCodes": { "$ref": "#/$defs/StandardPageDef" },
                         "plans": { "$ref": "#/$defs/StandardPageDef" },
-                        "planVersions": { "$ref": "#/$defs/StandardPageDef" },
                         "audit": { "$ref": "#/$defs/StandardPageDef" },
                         "users": { "$ref": "#/$defs/StandardPageDef" },
                         "pilots": { "$ref": "#/$defs/StandardPageDef" },

package/sql/reference-schema.postgres.sql

@@ -226,6 +226,9 @@ CREATE TABLE "plan_versions" (
     "publishedChanges" JSONB,
     "changeNote" TEXT NOT NULL,
     "nonRegressive" BOOLEAN NOT NULL DEFAULT true,
+    "validFrom" TIMESTAMP(3),
+    "validUntil" TIMESTAMP(3),
+    "endsAt" TIMESTAMP(3),
     "createdByUserId" TEXT,
     "publishedByUserId" TEXT,
     "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -286,6 +289,8 @@ CREATE TABLE "bundle_versions" (
     "publishedChanges" JSONB,
     "changeNote" TEXT NOT NULL DEFAULT '',
     "nonRegressive" BOOLEAN NOT NULL DEFAULT true,
+    "validFrom" TIMESTAMP(3),
+    "validUntil" TIMESTAMP(3),
     "createdByUserId" TEXT,
     "publishedByUserId" TEXT,
     "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -628,6 +633,9 @@ CREATE INDEX "plan_versions_planId_supersededAt_idx" ON "plan_versions"("planId"
 -- CreateIndex
 CREATE INDEX "plan_versions_planId_publishedAt_idx" ON "plan_versions"("planId", "publishedAt");
 
+-- CreateIndex
+CREATE INDEX "plan_versions_planId_validFrom_idx" ON "plan_versions"("planId", "validFrom");
+
 -- CreateIndex
 CREATE UNIQUE INDEX "plan_versions_planId_version_key" ON "plan_versions"("planId", "version");
 
@@ -655,6 +663,9 @@ CREATE INDEX "bundle_versions_bundleId_supersededAt_idx" ON "bundle_versions"("b
 -- CreateIndex
 CREATE INDEX "bundle_versions_bundleId_publishedAt_idx" ON "bundle_versions"("bundleId", "publishedAt");
 
+-- CreateIndex
+CREATE INDEX "bundle_versions_bundleId_validFrom_idx" ON "bundle_versions"("bundleId", "validFrom");
+
 -- CreateIndex
 CREATE UNIQUE INDEX "bundle_versions_bundleId_version_key" ON "bundle_versions"("bundleId", "version");