@contractspec/example.saas-boilerplate 3.7.6 → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/.turbo/turbo-build.log +39 -27
  2. package/AGENTS.md +50 -27
  3. package/CHANGELOG.md +36 -0
  4. package/README.md +65 -144
  5. package/dist/billing/billing.event.js +1 -1
  6. package/dist/billing/index.d.ts +6 -6
  7. package/dist/billing/index.js +1 -1
  8. package/dist/browser/billing/billing.event.js +1 -1
  9. package/dist/browser/billing/index.js +1 -1
  10. package/dist/browser/index.js +1147 -869
  11. package/dist/browser/project/index.js +209 -209
  12. package/dist/browser/project/project.event.js +1 -1
  13. package/dist/browser/saas-boilerplate.feature.js +208 -0
  14. package/dist/browser/ui/SaasDashboard.js +356 -105
  15. package/dist/browser/ui/SaasDashboard.visualizations.js +249 -0
  16. package/dist/browser/ui/SaasProjectList.js +7 -7
  17. package/dist/browser/ui/SaasSettingsPanel.js +12 -12
  18. package/dist/browser/ui/hooks/index.js +2 -2
  19. package/dist/browser/ui/hooks/useProjectList.js +1 -1
  20. package/dist/browser/ui/hooks/useProjectMutations.js +1 -1
  21. package/dist/browser/ui/index.js +790 -521
  22. package/dist/browser/ui/modals/CreateProjectModal.js +10 -10
  23. package/dist/browser/ui/modals/ProjectActionsModal.js +13 -13
  24. package/dist/browser/ui/modals/index.js +23 -23
  25. package/dist/browser/ui/renderers/index.js +341 -115
  26. package/dist/browser/ui/renderers/project-list.markdown.js +229 -3
  27. package/dist/browser/ui/renderers/project-list.renderer.js +7 -7
  28. package/dist/browser/visualizations/catalog.js +155 -0
  29. package/dist/browser/visualizations/index.js +217 -0
  30. package/dist/browser/visualizations/selectors.js +210 -0
  31. package/dist/handlers/index.d.ts +2 -2
  32. package/dist/index.d.ts +5 -4
  33. package/dist/index.js +1147 -869
  34. package/dist/node/billing/billing.event.js +1 -1
  35. package/dist/node/billing/index.js +1 -1
  36. package/dist/node/index.js +1147 -869
  37. package/dist/node/project/index.js +209 -209
  38. package/dist/node/project/project.event.js +1 -1
  39. package/dist/node/saas-boilerplate.feature.js +208 -0
  40. package/dist/node/ui/SaasDashboard.js +356 -105
  41. package/dist/node/ui/SaasDashboard.visualizations.js +249 -0
  42. package/dist/node/ui/SaasProjectList.js +7 -7
  43. package/dist/node/ui/SaasSettingsPanel.js +12 -12
  44. package/dist/node/ui/hooks/index.js +2 -2
  45. package/dist/node/ui/hooks/useProjectList.js +1 -1
  46. package/dist/node/ui/hooks/useProjectMutations.js +1 -1
  47. package/dist/node/ui/index.js +790 -521
  48. package/dist/node/ui/modals/CreateProjectModal.js +10 -10
  49. package/dist/node/ui/modals/ProjectActionsModal.js +13 -13
  50. package/dist/node/ui/modals/index.js +23 -23
  51. package/dist/node/ui/renderers/index.js +341 -115
  52. package/dist/node/ui/renderers/project-list.markdown.js +229 -3
  53. package/dist/node/ui/renderers/project-list.renderer.js +7 -7
  54. package/dist/node/visualizations/catalog.js +155 -0
  55. package/dist/node/visualizations/index.js +217 -0
  56. package/dist/node/visualizations/selectors.js +210 -0
  57. package/dist/presentations/index.d.ts +1 -1
  58. package/dist/project/index.d.ts +7 -7
  59. package/dist/project/index.js +209 -209
  60. package/dist/project/project.event.js +1 -1
  61. package/dist/saas-boilerplate.feature.js +208 -0
  62. package/dist/settings/index.d.ts +1 -1
  63. package/dist/ui/SaasDashboard.js +356 -105
  64. package/dist/ui/SaasDashboard.visualizations.d.ts +5 -0
  65. package/dist/ui/SaasDashboard.visualizations.js +250 -0
  66. package/dist/ui/SaasProjectList.js +7 -7
  67. package/dist/ui/SaasSettingsPanel.js +12 -12
  68. package/dist/ui/hooks/index.d.ts +2 -2
  69. package/dist/ui/hooks/index.js +2 -2
  70. package/dist/ui/hooks/useProjectList.d.ts +5 -0
  71. package/dist/ui/hooks/useProjectList.js +1 -1
  72. package/dist/ui/hooks/useProjectMutations.d.ts +8 -0
  73. package/dist/ui/hooks/useProjectMutations.js +1 -1
  74. package/dist/ui/index.d.ts +4 -4
  75. package/dist/ui/index.js +790 -521
  76. package/dist/ui/modals/CreateProjectModal.js +10 -10
  77. package/dist/ui/modals/ProjectActionsModal.js +13 -13
  78. package/dist/ui/modals/index.js +23 -23
  79. package/dist/ui/renderers/index.d.ts +1 -1
  80. package/dist/ui/renderers/index.js +341 -115
  81. package/dist/ui/renderers/project-list.markdown.js +229 -3
  82. package/dist/ui/renderers/project-list.renderer.d.ts +1 -1
  83. package/dist/ui/renderers/project-list.renderer.js +7 -7
  84. package/dist/visualizations/catalog.d.ts +11 -0
  85. package/dist/visualizations/catalog.js +156 -0
  86. package/dist/visualizations/index.d.ts +2 -0
  87. package/dist/visualizations/index.js +218 -0
  88. package/dist/visualizations/selectors.d.ts +8 -0
  89. package/dist/visualizations/selectors.js +211 -0
  90. package/dist/visualizations/selectors.test.d.ts +1 -0
  91. package/package.json +70 -14
  92. package/src/billing/billing.entity.ts +132 -132
  93. package/src/billing/billing.enum.ts +9 -9
  94. package/src/billing/billing.event.ts +71 -71
  95. package/src/billing/billing.handler.ts +87 -87
  96. package/src/billing/billing.operations.ts +158 -158
  97. package/src/billing/billing.presentation.ts +45 -45
  98. package/src/billing/billing.schema.ts +76 -76
  99. package/src/billing/index.ts +43 -48
  100. package/src/dashboard/dashboard.presentation.ts +45 -45
  101. package/src/dashboard/index.ts +2 -2
  102. package/src/docs/saas-boilerplate.docblock.ts +43 -43
  103. package/src/example.ts +32 -32
  104. package/src/handlers/index.ts +9 -9
  105. package/src/handlers/saas.handlers.ts +250 -249
  106. package/src/index.ts +41 -41
  107. package/src/presentations/index.ts +18 -20
  108. package/src/project/index.ts +45 -50
  109. package/src/project/project.entity.ts +68 -68
  110. package/src/project/project.enum.ts +8 -8
  111. package/src/project/project.event.ts +79 -79
  112. package/src/project/project.handler.ts +103 -103
  113. package/src/project/project.operations.ts +236 -236
  114. package/src/project/project.presentation.ts +46 -46
  115. package/src/project/project.schema.ts +90 -90
  116. package/src/saas-boilerplate.feature.ts +103 -100
  117. package/src/seeders/index.ts +20 -20
  118. package/src/settings/index.ts +2 -3
  119. package/src/settings/settings.entity.ts +65 -65
  120. package/src/settings/settings.enum.ts +4 -4
  121. package/src/shared/mock-data.ts +92 -92
  122. package/src/shared/overlay-types.ts +23 -23
  123. package/src/tests/operations.test-spec.ts +96 -96
  124. package/src/ui/SaasDashboard.tsx +278 -270
  125. package/src/ui/SaasDashboard.visualizations.tsx +41 -0
  126. package/src/ui/SaasProjectList.tsx +90 -90
  127. package/src/ui/SaasSettingsPanel.tsx +84 -84
  128. package/src/ui/hooks/index.ts +3 -3
  129. package/src/ui/hooks/useProjectList.ts +69 -68
  130. package/src/ui/hooks/useProjectMutations.ts +144 -143
  131. package/src/ui/index.ts +8 -12
  132. package/src/ui/modals/CreateProjectModal.tsx +154 -154
  133. package/src/ui/modals/ProjectActionsModal.tsx +321 -321
  134. package/src/ui/overlays/demo-overlays.ts +49 -49
  135. package/src/ui/renderers/index.ts +5 -4
  136. package/src/ui/renderers/project-list.markdown.ts +229 -205
  137. package/src/ui/renderers/project-list.renderer.tsx +14 -13
  138. package/src/visualizations/catalog.ts +153 -0
  139. package/src/visualizations/index.ts +2 -0
  140. package/src/visualizations/selectors.test.ts +25 -0
  141. package/src/visualizations/selectors.ts +85 -0
  142. package/tsconfig.json +7 -8
  143. package/tsdown.config.js +7 -3
@@ -5,164 +5,164 @@ import { MOCK_PROJECTS } from '../shared/mock-data';
5
5
 
6
6
  // Types inferred from contract schemas
7
7
  export interface Project {
8
- id: string;
9
- name: string;
10
- description?: string;
11
- slug?: string;
12
- organizationId: string;
13
- createdBy: string;
14
- status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'DELETED';
15
- isPublic: boolean;
16
- tags: string[];
17
- createdAt: Date;
18
- updatedAt: Date;
8
+ id: string;
9
+ name: string;
10
+ description?: string;
11
+ slug?: string;
12
+ organizationId: string;
13
+ createdBy: string;
14
+ status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'DELETED';
15
+ isPublic: boolean;
16
+ tags: string[];
17
+ createdAt: Date;
18
+ updatedAt: Date;
19
19
  }
20
20
 
21
21
  export interface CreateProjectInput {
22
- name: string;
23
- description?: string;
24
- slug?: string;
25
- isPublic?: boolean;
26
- tags?: string[];
22
+ name: string;
23
+ description?: string;
24
+ slug?: string;
25
+ isPublic?: boolean;
26
+ tags?: string[];
27
27
  }
28
28
 
29
29
  export interface UpdateProjectInput {
30
- projectId: string;
31
- name?: string;
32
- description?: string;
33
- slug?: string;
34
- isPublic?: boolean;
35
- tags?: string[];
36
- status?: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'DELETED';
30
+ projectId: string;
31
+ name?: string;
32
+ description?: string;
33
+ slug?: string;
34
+ isPublic?: boolean;
35
+ tags?: string[];
36
+ status?: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'DELETED';
37
37
  }
38
38
 
39
39
  export interface ListProjectsInput {
40
- status?: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'all';
41
- search?: string;
42
- limit?: number;
43
- offset?: number;
40
+ status?: 'DRAFT' | 'ACTIVE' | 'ARCHIVED' | 'all';
41
+ search?: string;
42
+ limit?: number;
43
+ offset?: number;
44
44
  }
45
45
 
46
46
  export interface ListProjectsOutput {
47
- projects: Project[];
48
- total: number;
47
+ projects: Project[];
48
+ total: number;
49
49
  }
50
50
 
51
51
  /**
52
52
  * Mock handler for ListProjectsContract.
53
53
  */
54
54
  export async function mockListProjectsHandler(
55
- input: ListProjectsInput
55
+ input: ListProjectsInput
56
56
  ): Promise<ListProjectsOutput> {
57
- const { status, search, limit = 20, offset = 0 } = input;
57
+ const { status, search, limit = 20, offset = 0 } = input;
58
58
 
59
- let filtered = [...MOCK_PROJECTS];
59
+ let filtered = [...MOCK_PROJECTS];
60
60
 
61
- if (status && status !== 'all') {
62
- filtered = filtered.filter((p) => p.status === status);
63
- }
61
+ if (status && status !== 'all') {
62
+ filtered = filtered.filter((p) => p.status === status);
63
+ }
64
64
 
65
- if (search) {
66
- const q = search.toLowerCase();
67
- filtered = filtered.filter(
68
- (p) =>
69
- p.name.toLowerCase().includes(q) ||
70
- p.description?.toLowerCase().includes(q) ||
71
- p.tags.some((t) => t.toLowerCase().includes(q))
72
- );
73
- }
65
+ if (search) {
66
+ const q = search.toLowerCase();
67
+ filtered = filtered.filter(
68
+ (p) =>
69
+ p.name.toLowerCase().includes(q) ||
70
+ p.description?.toLowerCase().includes(q) ||
71
+ p.tags.some((t) => t.toLowerCase().includes(q))
72
+ );
73
+ }
74
74
 
75
- filtered.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
75
+ filtered.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
76
76
 
77
- const total = filtered.length;
78
- const projects = filtered.slice(offset, offset + limit);
77
+ const total = filtered.length;
78
+ const projects = filtered.slice(offset, offset + limit);
79
79
 
80
- return {
81
- projects,
82
- total,
83
- };
80
+ return {
81
+ projects,
82
+ total,
83
+ };
84
84
  }
85
85
 
86
86
  /**
87
87
  * Mock handler for GetProjectContract.
88
88
  */
89
89
  export async function mockGetProjectHandler(input: {
90
- projectId: string;
90
+ projectId: string;
91
91
  }): Promise<Project> {
92
- const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
92
+ const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
93
93
 
94
- if (!project) {
95
- throw new Error('NOT_FOUND');
96
- }
94
+ if (!project) {
95
+ throw new Error('NOT_FOUND');
96
+ }
97
97
 
98
- return project;
98
+ return project;
99
99
  }
100
100
 
101
101
  /**
102
102
  * Mock handler for CreateProjectContract.
103
103
  */
104
104
  export async function mockCreateProjectHandler(
105
- input: CreateProjectInput,
106
- context: { organizationId: string; userId: string }
105
+ input: CreateProjectInput,
106
+ context: { organizationId: string; userId: string }
107
107
  ): Promise<Project> {
108
- if (input.slug) {
109
- const exists = MOCK_PROJECTS.some((p) => p.slug === input.slug);
110
- if (exists) {
111
- throw new Error('SLUG_EXISTS');
112
- }
113
- }
114
-
115
- const now = new Date();
116
- return {
117
- id: `proj-${Date.now()}`,
118
- name: input.name,
119
- description: input.description,
120
- slug: input.slug ?? input.name.toLowerCase().replace(/\s+/g, '-'),
121
- organizationId: context.organizationId,
122
- createdBy: context.userId,
123
- status: 'DRAFT',
124
- isPublic: input.isPublic ?? false,
125
- tags: input.tags ?? [],
126
- createdAt: now,
127
- updatedAt: now,
128
- };
108
+ if (input.slug) {
109
+ const exists = MOCK_PROJECTS.some((p) => p.slug === input.slug);
110
+ if (exists) {
111
+ throw new Error('SLUG_EXISTS');
112
+ }
113
+ }
114
+
115
+ const now = new Date();
116
+ return {
117
+ id: `proj-${Date.now()}`,
118
+ name: input.name,
119
+ description: input.description,
120
+ slug: input.slug ?? input.name.toLowerCase().replace(/\s+/g, '-'),
121
+ organizationId: context.organizationId,
122
+ createdBy: context.userId,
123
+ status: 'DRAFT',
124
+ isPublic: input.isPublic ?? false,
125
+ tags: input.tags ?? [],
126
+ createdAt: now,
127
+ updatedAt: now,
128
+ };
129
129
  }
130
130
 
131
131
  /**
132
132
  * Mock handler for UpdateProjectContract.
133
133
  */
134
134
  export async function mockUpdateProjectHandler(
135
- input: UpdateProjectInput
135
+ input: UpdateProjectInput
136
136
  ): Promise<Project> {
137
- const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
138
-
139
- if (!project) {
140
- throw new Error('NOT_FOUND');
141
- }
142
-
143
- return {
144
- ...project,
145
- name: input.name ?? project.name,
146
- description: input.description ?? project.description,
147
- slug: input.slug ?? project.slug,
148
- isPublic: input.isPublic ?? project.isPublic,
149
- tags: input.tags ?? project.tags,
150
- status: input.status ?? project.status,
151
- updatedAt: new Date(),
152
- };
137
+ const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
138
+
139
+ if (!project) {
140
+ throw new Error('NOT_FOUND');
141
+ }
142
+
143
+ return {
144
+ ...project,
145
+ name: input.name ?? project.name,
146
+ description: input.description ?? project.description,
147
+ slug: input.slug ?? project.slug,
148
+ isPublic: input.isPublic ?? project.isPublic,
149
+ tags: input.tags ?? project.tags,
150
+ status: input.status ?? project.status,
151
+ updatedAt: new Date(),
152
+ };
153
153
  }
154
154
 
155
155
  /**
156
156
  * Mock handler for DeleteProjectContract.
157
157
  */
158
158
  export async function mockDeleteProjectHandler(input: {
159
- projectId: string;
159
+ projectId: string;
160
160
  }): Promise<{ success: boolean }> {
161
- const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
161
+ const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
162
162
 
163
- if (!project) {
164
- throw new Error('NOT_FOUND');
165
- }
163
+ if (!project) {
164
+ throw new Error('NOT_FOUND');
165
+ }
166
166
 
167
- return { success: true };
167
+ return { success: true };
168
168
  }