@contractspec/example.saas-boilerplate 3.7.5 → 3.7.7

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 (115) hide show
  1. package/.turbo/turbo-build.log +8 -8
  2. package/AGENTS.md +50 -27
  3. package/CHANGELOG.md +16 -0
  4. package/README.md +64 -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 +931 -932
  11. package/dist/browser/project/index.js +209 -209
  12. package/dist/browser/project/project.event.js +1 -1
  13. package/dist/browser/ui/SaasDashboard.js +45 -45
  14. package/dist/browser/ui/SaasProjectList.js +7 -7
  15. package/dist/browser/ui/SaasSettingsPanel.js +12 -12
  16. package/dist/browser/ui/hooks/index.js +2 -2
  17. package/dist/browser/ui/hooks/useProjectList.js +1 -1
  18. package/dist/browser/ui/hooks/useProjectMutations.js +1 -1
  19. package/dist/browser/ui/index.js +483 -484
  20. package/dist/browser/ui/modals/CreateProjectModal.js +10 -10
  21. package/dist/browser/ui/modals/ProjectActionsModal.js +13 -13
  22. package/dist/browser/ui/modals/index.js +23 -23
  23. package/dist/browser/ui/renderers/index.js +112 -112
  24. package/dist/browser/ui/renderers/project-list.renderer.js +7 -7
  25. package/dist/handlers/index.d.ts +2 -2
  26. package/dist/index.d.ts +4 -4
  27. package/dist/index.js +931 -932
  28. package/dist/node/billing/billing.event.js +1 -1
  29. package/dist/node/billing/index.js +1 -1
  30. package/dist/node/index.js +931 -932
  31. package/dist/node/project/index.js +209 -209
  32. package/dist/node/project/project.event.js +1 -1
  33. package/dist/node/ui/SaasDashboard.js +45 -45
  34. package/dist/node/ui/SaasProjectList.js +7 -7
  35. package/dist/node/ui/SaasSettingsPanel.js +12 -12
  36. package/dist/node/ui/hooks/index.js +2 -2
  37. package/dist/node/ui/hooks/useProjectList.js +1 -1
  38. package/dist/node/ui/hooks/useProjectMutations.js +1 -1
  39. package/dist/node/ui/index.js +483 -484
  40. package/dist/node/ui/modals/CreateProjectModal.js +10 -10
  41. package/dist/node/ui/modals/ProjectActionsModal.js +13 -13
  42. package/dist/node/ui/modals/index.js +23 -23
  43. package/dist/node/ui/renderers/index.js +112 -112
  44. package/dist/node/ui/renderers/project-list.renderer.js +7 -7
  45. package/dist/presentations/index.d.ts +1 -1
  46. package/dist/project/index.d.ts +7 -7
  47. package/dist/project/index.js +209 -209
  48. package/dist/project/project.event.js +1 -1
  49. package/dist/settings/index.d.ts +1 -1
  50. package/dist/ui/SaasDashboard.js +45 -45
  51. package/dist/ui/SaasProjectList.js +7 -7
  52. package/dist/ui/SaasSettingsPanel.js +12 -12
  53. package/dist/ui/hooks/index.d.ts +2 -2
  54. package/dist/ui/hooks/index.js +2 -2
  55. package/dist/ui/hooks/useProjectList.d.ts +5 -0
  56. package/dist/ui/hooks/useProjectList.js +1 -1
  57. package/dist/ui/hooks/useProjectMutations.d.ts +8 -0
  58. package/dist/ui/hooks/useProjectMutations.js +1 -1
  59. package/dist/ui/index.d.ts +4 -4
  60. package/dist/ui/index.js +483 -484
  61. package/dist/ui/modals/CreateProjectModal.js +10 -10
  62. package/dist/ui/modals/ProjectActionsModal.js +13 -13
  63. package/dist/ui/modals/index.js +23 -23
  64. package/dist/ui/renderers/index.d.ts +1 -1
  65. package/dist/ui/renderers/index.js +112 -112
  66. package/dist/ui/renderers/project-list.renderer.d.ts +1 -1
  67. package/dist/ui/renderers/project-list.renderer.js +7 -7
  68. package/package.json +14 -14
  69. package/src/billing/billing.entity.ts +132 -132
  70. package/src/billing/billing.enum.ts +9 -9
  71. package/src/billing/billing.event.ts +71 -71
  72. package/src/billing/billing.handler.ts +87 -87
  73. package/src/billing/billing.operations.ts +158 -158
  74. package/src/billing/billing.presentation.ts +45 -45
  75. package/src/billing/billing.schema.ts +76 -76
  76. package/src/billing/index.ts +43 -48
  77. package/src/dashboard/dashboard.presentation.ts +45 -45
  78. package/src/dashboard/index.ts +2 -2
  79. package/src/docs/saas-boilerplate.docblock.ts +43 -43
  80. package/src/example.ts +32 -32
  81. package/src/handlers/index.ts +9 -9
  82. package/src/handlers/saas.handlers.ts +250 -249
  83. package/src/index.ts +40 -41
  84. package/src/presentations/index.ts +18 -20
  85. package/src/project/index.ts +45 -50
  86. package/src/project/project.entity.ts +68 -68
  87. package/src/project/project.enum.ts +8 -8
  88. package/src/project/project.event.ts +79 -79
  89. package/src/project/project.handler.ts +103 -103
  90. package/src/project/project.operations.ts +236 -236
  91. package/src/project/project.presentation.ts +46 -46
  92. package/src/project/project.schema.ts +90 -90
  93. package/src/saas-boilerplate.feature.ts +100 -100
  94. package/src/seeders/index.ts +20 -20
  95. package/src/settings/index.ts +2 -3
  96. package/src/settings/settings.entity.ts +65 -65
  97. package/src/settings/settings.enum.ts +4 -4
  98. package/src/shared/mock-data.ts +92 -92
  99. package/src/shared/overlay-types.ts +23 -23
  100. package/src/tests/operations.test-spec.ts +96 -96
  101. package/src/ui/SaasDashboard.tsx +270 -270
  102. package/src/ui/SaasProjectList.tsx +90 -90
  103. package/src/ui/SaasSettingsPanel.tsx +84 -84
  104. package/src/ui/hooks/index.ts +3 -3
  105. package/src/ui/hooks/useProjectList.ts +69 -68
  106. package/src/ui/hooks/useProjectMutations.ts +144 -143
  107. package/src/ui/index.ts +8 -12
  108. package/src/ui/modals/CreateProjectModal.tsx +154 -154
  109. package/src/ui/modals/ProjectActionsModal.tsx +321 -321
  110. package/src/ui/overlays/demo-overlays.ts +49 -49
  111. package/src/ui/renderers/index.ts +5 -4
  112. package/src/ui/renderers/project-list.markdown.ts +204 -204
  113. package/src/ui/renderers/project-list.renderer.tsx +14 -13
  114. package/tsconfig.json +7 -8
  115. 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
  }