@contractspec/example.saas-boilerplate 3.7.6 → 3.7.7

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=48 noBundle=false
-Bundled 48 modules in 95ms
+Bundled 48 modules in 67ms
 
   billing/billing.entity.js               3.54 KB    (entry point)
   tests/operations.test-spec.js           2.91 KB    (entry point)
@@ -30,7 +30,7 @@ Bundled 48 modules in 95ms
   settings/index.js                       2.30 KB    (entry point)
   settings/settings.entity.js             2.28 KB    (entry point)
   settings/settings.enum.js               310 bytes  (entry point)
-  project/index.js                        22.48 KB   (entry point)
+  project/index.js                        22.50 KB   (entry point)
   project/project.entity.js               2.27 KB    (entry point)
   project/project.event.js                3.31 KB    (entry point)
   project/project.operations.js           10.13 KB   (entry point)
@@ -55,7 +55,7 @@ Bundled 48 modules in 95ms
   billing/billing.enum.js                 443 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=48 noBundle=false
-Bundled 48 modules in 84ms
+Bundled 48 modules in 68ms
 
   billing/billing.entity.js               3.53 KB    (entry point)
   tests/operations.test-spec.js           2.90 KB    (entry point)
@@ -63,7 +63,7 @@ Bundled 48 modules in 84ms
   shared/overlay-types.js                 0 KB       (entry point)
   presentations/index.js                  8.93 KB    (entry point)
   ./index.js                              113.50 KB  (entry point)
-  ui/index.js                             65.60 KB   (entry point)
+  ui/index.js                             65.61 KB   (entry point)
   ui/modals/index.js                      19.40 KB   (entry point)
   ui/overlays/index.js                    1.30 KB    (entry point)
   ui/overlays/demo-overlays.js            1.30 KB    (entry point)
@@ -82,7 +82,7 @@ Bundled 48 modules in 84ms
   settings/index.js                       2.29 KB    (entry point)
   settings/settings.entity.js             2.27 KB    (entry point)
   settings/settings.enum.js               302 bytes  (entry point)
-  project/index.js                        22.47 KB   (entry point)
+  project/index.js                        22.49 KB   (entry point)
   project/project.entity.js               2.26 KB    (entry point)
   project/project.event.js                3.30 KB    (entry point)
   project/project.operations.js           10.12 KB   (entry point)
@@ -107,7 +107,7 @@ Bundled 48 modules in 84ms
   billing/billing.enum.js                 435 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=48 noBundle=false
-Bundled 48 modules in 106ms
+Bundled 48 modules in 82ms
 
   billing/billing.entity.js               3.53 KB    (entry point)
   tests/operations.test-spec.js           2.90 KB    (entry point)
@@ -115,7 +115,7 @@ Bundled 48 modules in 106ms
   shared/overlay-types.js                 0 KB       (entry point)
   presentations/index.js                  8.93 KB    (entry point)
   ./index.js                              113.50 KB  (entry point)
-  ui/index.js                             65.60 KB   (entry point)
+  ui/index.js                             65.61 KB   (entry point)
   ui/modals/index.js                      19.40 KB   (entry point)
   ui/overlays/index.js                    1.30 KB    (entry point)
   ui/overlays/demo-overlays.js            1.30 KB    (entry point)
@@ -134,7 +134,7 @@ Bundled 48 modules in 106ms
   settings/index.js                       2.29 KB    (entry point)
   settings/settings.entity.js             2.27 KB    (entry point)
   settings/settings.enum.js               302 bytes  (entry point)
-  project/index.js                        22.47 KB   (entry point)
+  project/index.js                        22.49 KB   (entry point)
   project/project.entity.js               2.26 KB    (entry point)
   project/project.event.js                3.30 KB    (entry point)
   project/project.operations.js           10.12 KB   (entry point)

package/AGENTS.md

@@ -1,36 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.saas-boilerplate`
+# AI Agent Guide — `@contractspec/example.saas-boilerplate`
 
 Scope: `packages/examples/saas-boilerplate/*`
 
-SaaS Boilerplate: Users, Orgs, Projects, Billing, and Settings with full CRUD, events, and UI.
+SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.identity-rbac`, `lib.jobs`, `module.audit-trail`, `module.notifications`, `lib.contracts-spec`, `lib.schema`, `lib.example-shared-ui`, `lib.design-system`, `lib.runtime-sandbox`
-
-## What This Demonstrates
-
-- Multi-domain SaaS architecture (billing, project, settings, dashboard)
-- Per-domain entity/enum/event/handler/operations/presentation/schema pattern
-- React UI with hooks, modals, overlays, renderers, and dashboard
-- Feature definition, seeders, and test-spec patterns
-- RBAC, audit trail, and notification module integration
-
-## Public Exports
-
-- `.` -- root barrel
-- `./billing`, `./project`, `./settings`, `./dashboard` -- domain modules
-- `./handlers` -- SaaS handlers
-- `./presentations` -- presentation layer
-- `./seeders` -- demo data
-- `./saas-boilerplate.feature` -- feature definition
-- `./ui` -- SaasDashboard, SaasProjectList, SaasSettingsPanel, hooks, modals, overlays, renderers
-- `./docs`, `./example`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.jobs`, `@contractspec/lib.runtime-sandbox`, ...
+
+## Architecture
+
+- `src/billing` is part of the package's public or composition surface.
+- `src/dashboard` is part of the package's public or composition surface.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/presentations` is part of the package's public or composition surface.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./billing` resolves through `./src/billing/index.ts`.
+- Export `./billing/billing.entity` resolves through `./src/billing/billing.entity.ts`.
+- Export `./billing/billing.enum` resolves through `./src/billing/billing.enum.ts`.
+- Export `./billing/billing.event` resolves through `./src/billing/billing.event.ts`.
+- Export `./billing/billing.handler` resolves through `./src/billing/billing.handler.ts`.
+- Export `./billing/billing.operations` resolves through `./src/billing/billing.operations.ts`.
+- Export `./billing/billing.presentation` resolves through `./src/billing/billing.presentation.ts`.
+- Export `./billing/billing.schema` resolves through `./src/billing/billing.schema.ts`.
+- Export `./dashboard` resolves through `./src/dashboard/index.ts`.
+- The package publishes 48 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.jobs`, `@contractspec/lib.runtime-sandbox`, ....
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.jobs`, `@contractspec/lib.runtime-sandbox`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test --pass-with-no-tests`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/README.md

@@ -1,155 +1,75 @@
-# SaaS Boilerplate
+# @contractspec/example.saas-boilerplate
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings.**
 
-A complete SaaS starter application demonstrating ContractSpec principles.
+## What This Demonstrates
 
-## What's Included
+- Multi-domain SaaS architecture (billing, project, settings, dashboard).
+- Per-domain entity/enum/event/handler/operations/presentation/schema pattern.
+- React UI with hooks, modals, overlays, renderers, and dashboard.
+- Feature definition, seeders, and test-spec patterns.
+- RBAC, audit trail, and notification module integration.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-This example showcases a full SaaS application with:
+## Running Locally
 
-- **User Management**: User profiles, authentication, preferences
-- **Organizations**: Multi-tenant workspaces with members and roles
-- **Projects**: Team-scoped projects with CRUD operations
-- **Billing**: Usage tracking and subscription management
-- **Settings**: Application and user settings
-
-## Architecture
-
-```
-saas-boilerplate/
-├── entities/           # Entity specs (generates Prisma schema)
-│   ├── project.ts
-│   ├── settings.ts
-│   └── billing.ts
-├── contracts/          # API contracts (generates GraphQL/REST)
-│   ├── project.ts
-│   └── billing.ts
-├── events/             # Domain events
-│   └── index.ts
-├── schema.config.ts    # Schema composition config
-└── README.md
-```
-
-## Cross-Cutting Modules Used
-
-| Module | Purpose |
-|--------|---------|
-| @contractspec/lib.identity-rbac | User, Org, Member, Role entities |
-| @contractspec/module.audit-trail | Activity logging |
-| @contractspec/module.notifications | User notifications |
-| @contractspec/lib.jobs | Background tasks |
-
-## Entities
-
-### Project
-
-Projects belong to organizations and track team work.
-
-```typescript
-const ProjectEntity = defineEntity({
-  name: 'Project',
-  fields: {
-    id: field.id(),
-    name: field.string(),
-    description: field.string({ isOptional: true }),
-    organizationId: field.foreignKey(),
-    createdBy: field.foreignKey(),
-    status: field.enum('ProjectStatus'),
-    // ...
-  },
-});
-```
-
-### Settings
-
-Application and organization settings.
-
-```typescript
-const SettingsEntity = defineEntity({
-  name: 'Settings',
-  fields: {
-    id: field.id(),
-    key: field.string(),
-    value: field.json(),
-    scope: field.enum('SettingsScope'), // 'app', 'org', 'user'
-    // ...
-  },
-});
-```
-
-### BillingUsage
-
-Track feature usage for billing.
-
-```typescript
-const BillingUsageEntity = defineEntity({
-  name: 'BillingUsage',
-  fields: {
-    id: field.id(),
-    organizationId: field.foreignKey(),
-    feature: field.string(),
-    quantity: field.int(),
-    billingPeriod: field.string(),
-    // ...
-  },
-});
-```
-
-## Contracts
-
-### Project CRUD
-
-- `project.create` - Create a new project
-- `project.get` - Get project by ID
-- `project.update` - Update project
-- `project.delete` - Delete project
-- `project.list` - List org projects
-
-### Billing
-
-- `billing.usage.record` - Record feature usage
-- `billing.usage.get` - Get usage summary
-- `billing.subscription.get` - Get subscription status
-
-## Events
-
-| Event | Description |
-|-------|-------------|
-| project.created | New project created |
-| project.updated | Project modified |
-| project.deleted | Project removed |
-| billing.usage.recorded | Usage tracked |
-| billing.limit.reached | Usage limit hit |
+From `packages/examples/saas-boilerplate`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-### Generate Schema
-
-```bash
-cd packages/examples/saas-boilerplate
-```
-
-### Load as Studio Template
-
-This example is registered in the ContractSpec Studio template registry as `saas-boilerplate`.
+Use `@contractspec/example.saas-boilerplate` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-From the Studio UI:
-1. Click "New Project"
-2. Select "SaaS Boilerplate" template
-3. Customize entities and contracts as needed
-
-### Clone via Git
-
-```bash
-npx degit lssm/contractspec/packages/examples/saas-boilerplate my-saas-app
-```
-
-## Customization Points
-
-1. **Add Custom Entities**: Extend with your domain models
-2. **Modify Billing**: Adapt to your pricing model
-3. **Extend Settings**: Add app-specific configuration
-4. **Add Workflows**: Integrate with @contractspec/lib.jobs for background tasks
+## Architecture
 
+- `src/billing` is part of the package's public or composition surface.
+- `src/dashboard` is part of the package's public or composition surface.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/presentations` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./billing` resolves through `./src/billing/index.ts`.
+- Export `./billing/billing.entity` resolves through `./src/billing/billing.entity.ts`.
+- Export `./billing/billing.enum` resolves through `./src/billing/billing.enum.ts`.
+- Export `./billing/billing.event` resolves through `./src/billing/billing.event.ts`.
+- Export `./billing/billing.handler` resolves through `./src/billing/billing.handler.ts`.
+- Export `./billing/billing.operations` resolves through `./src/billing/billing.operations.ts`.
+- Export `./billing/billing.presentation` resolves through `./src/billing/billing.presentation.ts`.
+- Export `./billing/billing.schema` resolves through `./src/billing/billing.schema.ts`.
+- Export `./dashboard` resolves through `./src/dashboard/index.ts`.
+- The package publishes 48 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.jobs`, ...

package/dist/billing/billing.event.js

@@ -1,7 +1,7 @@
 // @bun
 // src/billing/billing.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var UsageRecordedPayload = defineSchemaModel({
   name: "UsageRecordedPayload",
   description: "Payload when feature usage is recorded",

package/dist/billing/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Billing domain - subscription, usage tracking, and feature access.
  */
-export { SubscriptionStatusSchemaEnum, FeatureAccessReasonEnum, } from './billing.enum';
-export { SubscriptionModel, UsageSummaryModel, RecordUsageInputModel, RecordUsageOutputModel, UsageRecordedPayloadModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, } from './billing.schema';
-export { GetSubscriptionContract, RecordUsageContract, GetUsageSummaryContract, CheckFeatureAccessContract, } from './billing.operations';
-export { UsageRecordedEvent, UsageLimitReachedEvent, SubscriptionChangedEvent, } from './billing.event';
-export { SubscriptionStatusEnum, SubscriptionEntity, BillingUsageEntity, UsageLimitEntity, } from './billing.entity';
+export { BillingUsageEntity, SubscriptionEntity, SubscriptionStatusEnum, UsageLimitEntity, } from './billing.entity';
+export { FeatureAccessReasonEnum, SubscriptionStatusSchemaEnum, } from './billing.enum';
+export { SubscriptionChangedEvent, UsageLimitReachedEvent, UsageRecordedEvent, } from './billing.event';
+export { type CheckFeatureAccessInput, type CheckFeatureAccessOutput, mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler, type RecordUsageInput, type Subscription, type UsageSummary, } from './billing.handler';
+export { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract, } from './billing.operations';
 export { SubscriptionPresentation, UsageDashboardPresentation, } from './billing.presentation';
-export { mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler, mockCheckFeatureAccessHandler, type Subscription, type UsageSummary, type RecordUsageInput, type CheckFeatureAccessInput, type CheckFeatureAccessOutput, } from './billing.handler';
+export { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel, UsageSummaryModel, } from './billing.schema';

package/dist/billing/index.js

@@ -124,8 +124,8 @@ var FeatureAccessReasonEnum = defineEnum("FeatureAccessReason", [
 ]);
 
 // src/billing/billing.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var UsageRecordedPayload = defineSchemaModel({
   name: "UsageRecordedPayload",
   description: "Payload when feature usage is recorded",

package/dist/browser/billing/billing.event.js

@@ -1,6 +1,6 @@
 // src/billing/billing.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var UsageRecordedPayload = defineSchemaModel({
   name: "UsageRecordedPayload",
   description: "Payload when feature usage is recorded",

package/dist/browser/billing/index.js

@@ -123,8 +123,8 @@ var FeatureAccessReasonEnum = defineEnum("FeatureAccessReason", [
 ]);
 
 // src/billing/billing.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var UsageRecordedPayload = defineSchemaModel({
   name: "UsageRecordedPayload",
   description: "Payload when feature usage is recorded",