@contractspec/example.saas-boilerplate 1.44.1 → 1.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.saas-boilerplate",
-  "version": "1.44.1",
+  "version": "1.45.0",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,18 +51,18 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "1.44.1",
-    "@contractspec/lib.contracts": "1.44.1",
-    "@contractspec/lib.bus": "1.44.1",
-    "@contractspec/lib.identity-rbac": "1.44.1",
-    "@contractspec/lib.jobs": "1.44.1",
-    "@contractspec/module.audit-trail": "1.44.1",
-    "@contractspec/module.notifications": "1.44.1",
+    "@contractspec/lib.schema": "1.45.0",
+    "@contractspec/lib.contracts": "1.45.0",
+    "@contractspec/lib.bus": "1.45.0",
+    "@contractspec/lib.identity-rbac": "1.45.0",
+    "@contractspec/lib.jobs": "1.45.0",
+    "@contractspec/module.audit-trail": "1.45.0",
+    "@contractspec/module.notifications": "1.45.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.44.1",
-    "@contractspec/tool.typescript": "1.44.1",
+    "@contractspec/tool.tsdown": "1.45.0",
+    "@contractspec/tool.typescript": "1.45.0",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },

package/src/billing/billing.event.ts

@@ -68,7 +68,7 @@ const SubscriptionChangedPayload = defineSchemaModel({
 export const UsageRecordedEvent = defineEvent({
   meta: {
     key: 'billing.usage.recorded',
-    version: 1,
+    version: '1.0.0',
     description: 'Feature usage has been recorded.',
     stability: 'stable',
     owners: ['@saas-team'],
@@ -83,7 +83,7 @@ export const UsageRecordedEvent = defineEvent({
 export const UsageLimitReachedEvent = defineEvent({
   meta: {
     key: 'billing.limit.reached',
-    version: 1,
+    version: '1.0.0',
     description: 'Usage limit has been reached for a feature.',
     stability: 'stable',
     owners: ['@saas-team'],
@@ -98,7 +98,7 @@ export const UsageLimitReachedEvent = defineEvent({
 export const SubscriptionChangedEvent = defineEvent({
   meta: {
     key: 'billing.subscription.changed',
-    version: 1,
+    version: '1.0.0',
     description: 'Subscription status has changed.',
     stability: 'stable',
     owners: ['@saas-team'],

package/src/billing/billing.operations.ts

@@ -18,7 +18,7 @@ const OWNERS = ['@example.saas-boilerplate'] as const;
 export const GetSubscriptionContract = defineQuery({
   meta: {
     key: 'saas.billing.subscription.get',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'billing', 'subscription'],
@@ -62,7 +62,7 @@ export const GetSubscriptionContract = defineQuery({
 export const RecordUsageContract = defineCommand({
   meta: {
     key: 'saas.billing.usage.record',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'billing', 'usage'],
@@ -81,7 +81,7 @@ export const RecordUsageContract = defineCommand({
     emits: [
       {
         key: 'billing.usage.recorded',
-        version: 1,
+        version: '1.0.0',
         when: 'Usage is recorded',
         payload: UsageRecordedPayloadModel,
       },
@@ -112,7 +112,7 @@ export const RecordUsageContract = defineCommand({
 export const GetUsageSummaryContract = defineQuery({
   meta: {
     key: 'saas.billing.usage.summary',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'billing', 'usage'],
@@ -152,7 +152,7 @@ export const GetUsageSummaryContract = defineQuery({
 export const CheckFeatureAccessContract = defineQuery({
   meta: {
     key: 'saas.billing.feature.check',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'billing', 'feature'],

package/src/billing/billing.presentation.ts

@@ -7,7 +7,7 @@ import { StabilityEnum } from '@contractspec/lib.contracts';
 export const SubscriptionPresentation: PresentationSpec = {
   meta: {
     key: 'saas.billing.subscription',
-    version: 1,
+    version: '1.0.0',
     title: 'Subscription Status',
     description:
       'Subscription status with plan info, limits, and current usage',
@@ -35,7 +35,7 @@ export const SubscriptionPresentation: PresentationSpec = {
 export const UsageDashboardPresentation: PresentationSpec = {
   meta: {
     key: 'saas.billing.usage',
-    version: 1,
+    version: '1.0.0',
     title: 'Usage Dashboard',
     description: 'Usage metrics and breakdown by resource type',
     domain: 'saas-boilerplate',

package/src/dashboard/dashboard.presentation.ts

@@ -7,7 +7,7 @@ import { StabilityEnum } from '@contractspec/lib.contracts';
 export const SaasDashboardPresentation: PresentationSpec = {
   meta: {
     key: 'saas.dashboard',
-    version: 1,
+    version: '1.0.0',
     title: 'SaaS Dashboard',
     description:
       'Main SaaS dashboard with project overview, usage stats, and quick actions',
@@ -35,7 +35,7 @@ export const SaasDashboardPresentation: PresentationSpec = {
 export const SettingsPanelPresentation: PresentationSpec = {
   meta: {
     key: 'saas.settings',
-    version: 1,
+    version: '1.0.0',
     title: 'Settings Panel',
     description: 'Organization and user settings panel',
     domain: 'saas-boilerplate',

package/src/example.ts

@@ -1,11 +1,18 @@
-const example = {
-  id: 'saas-boilerplate',
-  title: 'SaaS Boilerplate',
-  summary:
-    'Multi-tenant SaaS foundation with orgs, projects, settings, billing usage, and RBAC.',
-  tags: ['saas', 'multi-tenant', 'billing', 'rbac'],
-  kind: 'template',
-  visibility: 'public',
+import type { ExampleSpec } from '@contractspec/lib.contracts';
+
+const example: ExampleSpec = {
+  meta: {
+    key: 'saas-boilerplate',
+    version: '1.0.0',
+    title: 'SaaS Boilerplate',
+    description:
+      'Multi-tenant SaaS foundation with orgs, projects, settings, billing usage, and RBAC.',
+    kind: 'template',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['saas', 'multi-tenant', 'billing', 'rbac'],
+  },
   docs: {
     rootDocId: 'docs.examples.saas-boilerplate',
   },
@@ -26,6 +33,6 @@ const example = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-} as const;
+};
 
 export default example;

package/src/project/project.event.ts

@@ -73,7 +73,7 @@ const ProjectArchivedPayload = defineSchemaModel({
 export const ProjectCreatedEvent = defineEvent({
   meta: {
     key: 'project.created',
-    version: 1,
+    version: '1.0.0',
     description: 'A new project has been created.',
     stability: 'stable',
     owners: ['@saas-team'],
@@ -88,7 +88,7 @@ export const ProjectCreatedEvent = defineEvent({
 export const ProjectUpdatedEvent = defineEvent({
   meta: {
     key: 'project.updated',
-    version: 1,
+    version: '1.0.0',
     description: 'A project has been updated.',
     stability: 'stable',
     owners: ['@saas-team'],
@@ -103,7 +103,7 @@ export const ProjectUpdatedEvent = defineEvent({
 export const ProjectDeletedEvent = defineEvent({
   meta: {
     key: 'project.deleted',
-    version: 1,
+    version: '1.0.0',
     description: 'A project has been deleted.',
     stability: 'stable',
     owners: ['@saas-team'],
@@ -118,7 +118,7 @@ export const ProjectDeletedEvent = defineEvent({
 export const ProjectArchivedEvent = defineEvent({
   meta: {
     key: 'project.archived',
-    version: 1,
+    version: '1.0.0',
     description: 'A project has been archived.',
     stability: 'stable',
     owners: ['@saas-team'],

package/src/project/project.operations.ts

@@ -22,7 +22,7 @@ const OWNERS = ['example.saas-boilerplate'] as const;
 export const CreateProjectContract = defineCommand({
   meta: {
     key: 'saas.project.create',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'project', 'create'],
@@ -55,7 +55,7 @@ export const CreateProjectContract = defineCommand({
     emits: [
       {
         key: 'project.created',
-        version: 1,
+        version: '1.0.0',
         when: 'Project is created',
         payload: ProjectModel,
       },
@@ -87,7 +87,7 @@ export const CreateProjectContract = defineCommand({
 export const GetProjectContract = defineQuery({
   meta: {
     key: 'saas.project.get',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'project', 'get'],
@@ -135,7 +135,7 @@ export const GetProjectContract = defineQuery({
 export const UpdateProjectContract = defineCommand({
   meta: {
     key: 'saas.project.update',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'project', 'update'],
@@ -154,7 +154,7 @@ export const UpdateProjectContract = defineCommand({
     emits: [
       {
         key: 'project.updated',
-        version: 1,
+        version: '1.0.0',
         when: 'Project is updated',
         payload: ProjectModel,
       },
@@ -186,7 +186,7 @@ export const UpdateProjectContract = defineCommand({
 export const DeleteProjectContract = defineCommand({
   meta: {
     key: 'saas.project.delete',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'project', 'delete'],
@@ -205,7 +205,7 @@ export const DeleteProjectContract = defineCommand({
     emits: [
       {
         key: 'project.deleted',
-        version: 1,
+        version: '1.0.0',
         when: 'Project is deleted',
         payload: ProjectDeletedPayloadModel,
       },
@@ -237,7 +237,7 @@ export const DeleteProjectContract = defineCommand({
 export const ListProjectsContract = defineQuery({
   meta: {
     key: 'saas.project.list',
-    version: 1,
+    version: '1.0.0',
     stability: 'stable',
     owners: [...OWNERS],
     tags: ['saas', 'project', 'list'],

package/src/project/project.presentation.ts

@@ -8,7 +8,7 @@ import { ProjectModel } from './project.schema';
 export const ProjectListPresentation: PresentationSpec = {
   meta: {
     key: 'saas.project.list',
-    version: 1,
+    version: '1.0.0',
     title: 'Project List',
     description:
       'List view of projects with status, tags, and last updated info',
@@ -37,7 +37,7 @@ export const ProjectListPresentation: PresentationSpec = {
 export const ProjectDetailPresentation: PresentationSpec = {
   meta: {
     key: 'saas.project.detail',
-    version: 1,
+    version: '1.0.0',
     title: 'Project Details',
     description: 'Detailed view of a project with settings and activity',
     domain: 'saas-boilerplate',

package/src/saas-boilerplate.feature.ts

@@ -19,91 +19,95 @@ export const SaasBoilerplateFeature: FeatureModuleSpec = {
     owners: ['@saas-team'],
     tags: ['saas', 'projects', 'billing'],
     stability: 'experimental',
-    version: 1,
+    version: '1.0.0',
   },
 
   // All contract operations included in this feature
   operations: [
     // Project operations
-    { key: 'saas.project.create', version: 1 },
-    { key: 'saas.project.get', version: 1 },
-    { key: 'saas.project.update', version: 1 },
-    { key: 'saas.project.delete', version: 1 },
-    { key: 'saas.project.list', version: 1 },
+    { key: 'saas.project.create', version: '1.0.0' },
+    { key: 'saas.project.get', version: '1.0.0' },
+    { key: 'saas.project.update', version: '1.0.0' },
+    { key: 'saas.project.delete', version: '1.0.0' },
+    { key: 'saas.project.list', version: '1.0.0' },
 
     // Billing operations
-    { key: 'saas.billing.subscription.get', version: 1 },
-    { key: 'saas.billing.usage.record', version: 1 },
-    { key: 'saas.billing.usage.summary', version: 1 },
-    { key: 'saas.billing.feature.check', version: 1 },
+    { key: 'saas.billing.subscription.get', version: '1.0.0' },
+    { key: 'saas.billing.usage.record', version: '1.0.0' },
+    { key: 'saas.billing.usage.summary', version: '1.0.0' },
+    { key: 'saas.billing.feature.check', version: '1.0.0' },
   ],
 
   // Events emitted by this feature
   events: [
     // Project events
-    { key: 'project.created', version: 1 },
-    { key: 'project.updated', version: 1 },
-    { key: 'project.deleted', version: 1 },
-    { key: 'project.archived', version: 1 },
+    { key: 'project.created', version: '1.0.0' },
+    { key: 'project.updated', version: '1.0.0' },
+    { key: 'project.deleted', version: '1.0.0' },
+    { key: 'project.archived', version: '1.0.0' },
 
     // Billing events
-    { key: 'billing.usage.recorded', version: 1 },
-    { key: 'billing.subscription.changed', version: 1 },
-    { key: 'billing.limit.reached', version: 1 },
+    { key: 'billing.usage.recorded', version: '1.0.0' },
+    { key: 'billing.subscription.changed', version: '1.0.0' },
+    { key: 'billing.limit.reached', version: '1.0.0' },
   ],
 
   // Presentations associated with this feature
   presentations: [
-    { key: 'saas.dashboard', version: 1 },
-    { key: 'saas.project.list', version: 1 },
-    { key: 'saas.project.detail', version: 1 },
-    { key: 'saas.billing.subscription', version: 1 },
-    { key: 'saas.billing.usage', version: 1 },
-    { key: 'saas.settings', version: 1 },
+    { key: 'saas.dashboard', version: '1.0.0' },
+    { key: 'saas.project.list', version: '1.0.0' },
+    { key: 'saas.project.detail', version: '1.0.0' },
+    { key: 'saas.billing.subscription', version: '1.0.0' },
+    { key: 'saas.billing.usage', version: '1.0.0' },
+    { key: 'saas.settings', version: '1.0.0' },
   ],
 
   // Link operations to their primary presentations
   opToPresentation: [
     {
-      op: { key: 'saas.project.list', version: 1 },
-      pres: { key: 'saas.project.list', version: 1 },
+      op: { key: 'saas.project.list', version: '1.0.0' },
+      pres: { key: 'saas.project.list', version: '1.0.0' },
     },
     {
-      op: { key: 'saas.project.get', version: 1 },
-      pres: { key: 'saas.project.detail', version: 1 },
+      op: { key: 'saas.project.get', version: '1.0.0' },
+      pres: { key: 'saas.project.detail', version: '1.0.0' },
     },
     {
-      op: { key: 'saas.billing.subscription.get', version: 1 },
-      pres: { key: 'saas.billing.subscription', version: 1 },
+      op: { key: 'saas.billing.subscription.get', version: '1.0.0' },
+      pres: { key: 'saas.billing.subscription', version: '1.0.0' },
     },
     {
-      op: { key: 'saas.billing.usage.summary', version: 1 },
-      pres: { key: 'saas.billing.usage', version: 1 },
+      op: { key: 'saas.billing.usage.summary', version: '1.0.0' },
+      pres: { key: 'saas.billing.usage', version: '1.0.0' },
     },
   ],
 
   // Target requirements for multi-surface rendering
   presentationsTargets: [
-    { key: 'saas.dashboard', version: 1, targets: ['react', 'markdown'] },
+    { key: 'saas.dashboard', version: '1.0.0', targets: ['react', 'markdown'] },
     {
       key: 'saas.project.list',
-      version: 1,
+      version: '1.0.0',
       targets: ['react', 'markdown', 'application/json'],
     },
     {
       key: 'saas.billing.subscription',
-      version: 1,
+      version: '1.0.0',
+      targets: ['react', 'markdown'],
+    },
+    {
+      key: 'saas.billing.usage',
+      version: '1.0.0',
       targets: ['react', 'markdown'],
     },
-    { key: 'saas.billing.usage', version: 1, targets: ['react', 'markdown'] },
   ],
 
   // Capability requirements
   capabilities: {
     requires: [
-      { key: 'identity', version: 1 },
-      { key: 'audit-trail', version: 1 },
-      { key: 'notifications', version: 1 },
+      { key: 'identity', version: '1.0.0' },
+      { key: 'audit-trail', version: '1.0.0' },
+      { key: 'notifications', version: '1.0.0' },
     ],
   },
 };