@contractspec/example.saas-boilerplate 3.7.6 → 3.8.2

package/src/project/project.schema.ts

@@ -1,147 +1,147 @@
 import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 import {
-  ProjectStatusSchemaEnum,
-  ProjectStatusFilterEnum,
+	ProjectStatusFilterEnum,
+	ProjectStatusSchemaEnum,
 } from './project.enum';
 
 /**
  * A project within an organization.
  */
 export const ProjectModel = defineSchemaModel({
-  name: 'Project',
-  description: 'A project within an organization',
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    status: { type: ProjectStatusSchemaEnum, isOptional: false },
-    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: false,
-    },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-  },
+	name: 'Project',
+	description: 'A project within an organization',
+	fields: {
+		id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		status: { type: ProjectStatusSchemaEnum, isOptional: false },
+		isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+		tags: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: false,
+		},
+		createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+		updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+	},
 });
 
 /**
  * Input for creating a project.
  */
 export const CreateProjectInputModel = defineSchemaModel({
-  name: 'CreateProjectInput',
-  description: 'Input for creating a project',
-  fields: {
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true,
-    },
-  },
+	name: 'CreateProjectInput',
+	description: 'Input for creating a project',
+	fields: {
+		name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+		description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+		tags: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true,
+		},
+	},
 });
 
 /**
  * Input for updating a project.
  */
 export const UpdateProjectInputModel = defineSchemaModel({
-  name: 'UpdateProjectInput',
-  description: 'Input for updating a project',
-  fields: {
-    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true,
-    },
-    status: { type: ProjectStatusSchemaEnum, isOptional: true },
-  },
+	name: 'UpdateProjectInput',
+	description: 'Input for updating a project',
+	fields: {
+		projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+		tags: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: true,
+		},
+		status: { type: ProjectStatusSchemaEnum, isOptional: true },
+	},
 });
 
 /**
  * Input for getting a project.
  */
 export const GetProjectInputModel = defineSchemaModel({
-  name: 'GetProjectInput',
-  fields: {
-    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'GetProjectInput',
+	fields: {
+		projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 /**
  * Input for deleting a project.
  */
 export const DeleteProjectInputModel = defineSchemaModel({
-  name: 'DeleteProjectInput',
-  fields: {
-    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'DeleteProjectInput',
+	fields: {
+		projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 /**
  * Output for delete operation.
  */
 export const DeleteProjectOutputModel = defineSchemaModel({
-  name: 'DeleteProjectOutput',
-  fields: {
-    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-  },
+	name: 'DeleteProjectOutput',
+	fields: {
+		success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+	},
 });
 
 /**
  * Payload for project deleted event.
  */
 export const ProjectDeletedPayloadModel = defineSchemaModel({
-  name: 'ProjectDeletedPayload',
-  fields: {
-    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'ProjectDeletedPayload',
+	fields: {
+		projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 /**
  * Input for listing projects.
  */
 export const ListProjectsInputModel = defineSchemaModel({
-  name: 'ListProjectsInput',
-  description: 'Input for listing projects',
-  fields: {
-    status: { type: ProjectStatusFilterEnum, isOptional: true },
-    search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    limit: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true,
-      defaultValue: 20,
-    },
-    offset: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true,
-      defaultValue: 0,
-    },
-  },
+	name: 'ListProjectsInput',
+	description: 'Input for listing projects',
+	fields: {
+		status: { type: ProjectStatusFilterEnum, isOptional: true },
+		search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		limit: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 20,
+		},
+		offset: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true,
+			defaultValue: 0,
+		},
+	},
 });
 
 /**
  * Output for listing projects.
  */
 export const ListProjectsOutputModel = defineSchemaModel({
-  name: 'ListProjectsOutput',
-  description: 'Output for listing projects',
-  fields: {
-    projects: { type: ProjectModel, isArray: true, isOptional: false },
-    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-  },
+	name: 'ListProjectsOutput',
+	description: 'Output for listing projects',
+	fields: {
+		projects: { type: ProjectModel, isArray: true, isOptional: false },
+		total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+	},
 });

package/src/saas-boilerplate.feature.ts

@@ -4,121 +4,124 @@
  * Defines the feature module for the SaaS application foundation.
  */
 import { defineFeature } from '@contractspec/lib.contracts-spec';
+import { SaasVisualizationRefs } from './visualizations';
 
 /**
  * SaaS Boilerplate feature module that bundles project management,
  * billing, and settings operations into an installable feature.
  */
 export const SaasBoilerplateFeature = defineFeature({
-  meta: {
-    key: 'saas-boilerplate',
-    title: 'SaaS Boilerplate',
-    description:
-      'SaaS application foundation with projects, billing, and settings',
-    domain: 'saas',
-    owners: ['@saas-team'],
-    tags: ['saas', 'projects', 'billing'],
-    stability: 'experimental',
-    version: '1.0.0',
-  },
+	meta: {
+		key: 'saas-boilerplate',
+		title: 'SaaS Boilerplate',
+		description:
+			'SaaS application foundation with projects, billing, and settings',
+		domain: 'saas',
+		owners: ['@saas-team'],
+		tags: ['saas', 'projects', 'billing'],
+		stability: 'experimental',
+		version: '1.0.0',
+	},
 
-  // All contract operations included in this feature
-  operations: [
-    // Project operations
-    { 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' },
+	// All contract operations included in this feature
+	operations: [
+		// Project operations
+		{ 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.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' },
-  ],
+		// Billing operations
+		{ 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.0.0' },
-    { key: 'project.updated', version: '1.0.0' },
-    { key: 'project.deleted', version: '1.0.0' },
-    { key: 'project.archived', version: '1.0.0' },
+	// Events emitted by this feature
+	events: [
+		// Project events
+		{ 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.0.0' },
-    { key: 'billing.subscription.changed', version: '1.0.0' },
-    { key: 'billing.limit.reached', version: '1.0.0' },
-  ],
+		// Billing events
+		{ 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.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' },
-  ],
+	// Presentations associated with this feature
+	presentations: [
+		{ 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.0.0' },
-      pres: { key: 'saas.project.list', version: '1.0.0' },
-    },
-    {
-      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.0.0' },
-      pres: { key: 'saas.billing.subscription', version: '1.0.0' },
-    },
-    {
-      op: { key: 'saas.billing.usage.summary', version: '1.0.0' },
-      pres: { key: 'saas.billing.usage', version: '1.0.0' },
-    },
-  ],
+	// Link operations to their primary presentations
+	opToPresentation: [
+		{
+			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.0.0' },
+			pres: { key: 'saas.project.detail', version: '1.0.0' },
+		},
+		{
+			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.0.0' },
+			pres: { key: 'saas.billing.usage', version: '1.0.0' },
+		},
+	],
 
-  // Target requirements for multi-surface rendering
-  presentationsTargets: [
-    { key: 'saas.dashboard', version: '1.0.0', targets: ['react', 'markdown'] },
-    {
-      key: 'saas.project.list',
-      version: '1.0.0',
-      targets: ['react', 'markdown', 'application/json'],
-    },
-    {
-      key: 'saas.billing.subscription',
-      version: '1.0.0',
-      targets: ['react', 'markdown'],
-    },
-    {
-      key: 'saas.billing.usage',
-      version: '1.0.0',
-      targets: ['react', 'markdown'],
-    },
-  ],
+	// Target requirements for multi-surface rendering
+	presentationsTargets: [
+		{ key: 'saas.dashboard', version: '1.0.0', targets: ['react', 'markdown'] },
+		{
+			key: 'saas.project.list',
+			version: '1.0.0',
+			targets: ['react', 'markdown', 'application/json'],
+		},
+		{
+			key: 'saas.billing.subscription',
+			version: '1.0.0',
+			targets: ['react', 'markdown'],
+		},
+		{
+			key: 'saas.billing.usage',
+			version: '1.0.0',
+			targets: ['react', 'markdown'],
+		},
+	],
 
-  // Capability requirements
-  capabilities: {
-    requires: [
-      { key: 'identity', version: '1.0.0' },
-      { key: 'audit-trail', version: '1.0.0' },
-      { key: 'notifications', version: '1.0.0' },
-    ],
-  },
+	visualizations: SaasVisualizationRefs,
 
-  telemetry: [{ key: 'saas-boilerplate.telemetry', version: '1.0.0' }],
+	// Capability requirements
+	capabilities: {
+		requires: [
+			{ key: 'identity', version: '1.0.0' },
+			{ key: 'audit-trail', version: '1.0.0' },
+			{ key: 'notifications', version: '1.0.0' },
+		],
+	},
 
-  jobs: [{ key: 'saas-boilerplate.job.usage-recording', version: '1.0.0' }],
+	telemetry: [{ key: 'saas-boilerplate.telemetry', version: '1.0.0' }],
 
-  docs: [
-    'docs.examples.saas-boilerplate.goal',
-    'docs.examples.saas-boilerplate.usage',
-    'docs.examples.saas-boilerplate.reference',
-    'docs.examples.saas-boilerplate.constraints',
-  ],
+	jobs: [{ key: 'saas-boilerplate.job.usage-recording', version: '1.0.0' }],
+
+	docs: [
+		'docs.examples.saas-boilerplate.goal',
+		'docs.examples.saas-boilerplate.usage',
+		'docs.examples.saas-boilerplate.reference',
+		'docs.examples.saas-boilerplate.constraints',
+	],
 });

package/src/seeders/index.ts

@@ -1,28 +1,28 @@
 import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';
 
 export async function seedSaasBoilerplate(params: {
-  projectId: string;
-  db: DatabasePort;
+	projectId: string;
+	db: DatabasePort;
 }) {
-  const { projectId, db } = params;
+	const { projectId, db } = params;
 
-  const existing = await db.query(
-    `SELECT COUNT(*) as count FROM saas_project WHERE "projectId" = $1`,
-    [projectId]
-  );
-  if ((existing.rows[0]?.count as number) > 0) return;
+	const existing = await db.query(
+		`SELECT COUNT(*) as count FROM saas_project WHERE "projectId" = $1`,
+		[projectId]
+	);
+	if ((existing.rows[0]?.count as number) > 0) return;
 
-  await db.execute(
-    `INSERT INTO saas_project (id, "projectId", "organizationId", name, description, status, tier)
+	await db.execute(
+		`INSERT INTO saas_project (id, "projectId", "organizationId", name, description, status, tier)
      VALUES ($1, $2, $3, $4, $5, $6, $7)`,
-    [
-      'saas_proj_1',
-      projectId,
-      'org_demo',
-      'Demo Project',
-      'A demo SaaS project',
-      'ACTIVE',
-      'PRO',
-    ]
-  );
+		[
+			'saas_proj_1',
+			projectId,
+			'org_demo',
+			'Demo Project',
+			'A demo SaaS project',
+			'ACTIVE',
+			'PRO',
+		]
+	);
 }

package/src/settings/index.ts

@@ -2,8 +2,7 @@
  * Settings domain - application, organization, and user settings.
  */
 
+// Entities
+export { FeatureFlagEntity, SettingsEntity } from './settings.entity';
 // Enums
 export { SettingsScopeEnum } from './settings.enum';
-
-// Entities
-export { SettingsEntity, FeatureFlagEntity } from './settings.entity';