@stratum-hq/create 0.2.3 → 0.3.1
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.
- package/CHANGELOG.md +42 -0
- package/LICENSE +21 -0
- package/README.md +52 -0
- package/dist/index.js +1245 -37
- package/dist/matrix.js +131 -0
- package/package.json +27 -2
- package/src/generators/db-setup.ts +320 -0
- package/src/generators/docker-compose.ts +98 -0
- package/src/generators/init-sql.ts +57 -0
- package/src/generators/middleware.ts +267 -0
- package/src/generators/package-json.ts +174 -0
- package/src/generators/readme.ts +119 -0
- package/src/index.ts +61 -11
- package/src/matrix.ts +186 -0
- package/src/preset-project.ts +148 -0
- package/src/__tests__/create.test.ts +0 -217
|
@@ -1,217 +0,0 @@
|
|
|
1
|
-
import { describe, it, expect, beforeEach, afterEach } from "vitest";
|
|
2
|
-
import * as fs from "fs";
|
|
3
|
-
import * as path from "path";
|
|
4
|
-
import * as os from "os";
|
|
5
|
-
import { parseArgs, createProject, validateProjectName } from "../index.js";
|
|
6
|
-
|
|
7
|
-
// ─── parseArgs tests ──────────────────────────────────────────────────────────
|
|
8
|
-
|
|
9
|
-
describe("parseArgs", () => {
|
|
10
|
-
it("extracts project name from positional arg", () => {
|
|
11
|
-
const result = parseArgs(["my-app"]);
|
|
12
|
-
expect(result.projectName).toBe("my-app");
|
|
13
|
-
});
|
|
14
|
-
|
|
15
|
-
it("defaults template to express", () => {
|
|
16
|
-
const result = parseArgs(["my-app"]);
|
|
17
|
-
expect(result.template).toBe("express");
|
|
18
|
-
});
|
|
19
|
-
|
|
20
|
-
it("parses --template flag", () => {
|
|
21
|
-
const result = parseArgs(["my-app", "--template", "fastify"]);
|
|
22
|
-
expect(result.template).toBe("fastify");
|
|
23
|
-
});
|
|
24
|
-
|
|
25
|
-
it("parses --template=value syntax", () => {
|
|
26
|
-
const result = parseArgs(["my-app", "--template=nextjs"]);
|
|
27
|
-
expect(result.template).toBe("nextjs");
|
|
28
|
-
});
|
|
29
|
-
|
|
30
|
-
it("parses --skip-install flag", () => {
|
|
31
|
-
const result = parseArgs(["my-app", "--skip-install"]);
|
|
32
|
-
expect(result.skipInstall).toBe(true);
|
|
33
|
-
});
|
|
34
|
-
|
|
35
|
-
it("parses --force flag", () => {
|
|
36
|
-
const result = parseArgs(["my-app", "--force"]);
|
|
37
|
-
expect(result.force).toBe(true);
|
|
38
|
-
});
|
|
39
|
-
|
|
40
|
-
it("returns null projectName when no positional arg given", () => {
|
|
41
|
-
const result = parseArgs(["--template", "express"]);
|
|
42
|
-
expect(result.projectName).toBeNull();
|
|
43
|
-
});
|
|
44
|
-
|
|
45
|
-
it("skipInstall defaults to false", () => {
|
|
46
|
-
const result = parseArgs(["my-app"]);
|
|
47
|
-
expect(result.skipInstall).toBe(false);
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
it("force defaults to false", () => {
|
|
51
|
-
const result = parseArgs(["my-app"]);
|
|
52
|
-
expect(result.force).toBe(false);
|
|
53
|
-
});
|
|
54
|
-
});
|
|
55
|
-
|
|
56
|
-
// ─── Error cases ──────────────────────────────────────────────────────────────
|
|
57
|
-
|
|
58
|
-
describe("main arg validation", () => {
|
|
59
|
-
it("errors when no project name given", () => {
|
|
60
|
-
// parseArgs returns null projectName, which main() would exit on
|
|
61
|
-
const result = parseArgs([]);
|
|
62
|
-
expect(result.projectName).toBeNull();
|
|
63
|
-
});
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
// ─── File generation tests ────────────────────────────────────────────────────
|
|
67
|
-
|
|
68
|
-
describe("createProject", () => {
|
|
69
|
-
let tmpDir: string;
|
|
70
|
-
let projectDir: string;
|
|
71
|
-
|
|
72
|
-
beforeEach(() => {
|
|
73
|
-
tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "stratum-create-test-"));
|
|
74
|
-
projectDir = path.join(tmpDir, "test-project");
|
|
75
|
-
fs.mkdirSync(projectDir, { recursive: true });
|
|
76
|
-
});
|
|
77
|
-
|
|
78
|
-
afterEach(() => {
|
|
79
|
-
fs.rmSync(tmpDir, { recursive: true, force: true });
|
|
80
|
-
});
|
|
81
|
-
|
|
82
|
-
it("generates correct files for express template", () => {
|
|
83
|
-
createProject("test-project", "express", projectDir, true);
|
|
84
|
-
|
|
85
|
-
expect(fs.existsSync(path.join(projectDir, "package.json"))).toBe(true);
|
|
86
|
-
expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
|
|
87
|
-
expect(fs.existsSync(path.join(projectDir, ".env.example"))).toBe(true);
|
|
88
|
-
expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
|
|
89
|
-
expect(fs.existsSync(path.join(projectDir, "README.md"))).toBe(true);
|
|
90
|
-
expect(fs.existsSync(path.join(projectDir, "init.sql"))).toBe(true);
|
|
91
|
-
});
|
|
92
|
-
|
|
93
|
-
it("generates correct files for fastify template", () => {
|
|
94
|
-
createProject("test-project", "fastify", projectDir, true);
|
|
95
|
-
|
|
96
|
-
expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
|
|
97
|
-
const serverContent = fs.readFileSync(
|
|
98
|
-
path.join(projectDir, "src", "index.ts"),
|
|
99
|
-
"utf8",
|
|
100
|
-
);
|
|
101
|
-
expect(serverContent).toContain("Fastify");
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
it("generates correct files for nextjs template", () => {
|
|
105
|
-
createProject("test-project", "nextjs", projectDir, true);
|
|
106
|
-
|
|
107
|
-
expect(fs.existsSync(path.join(projectDir, "src", "app", "page.tsx"))).toBe(true);
|
|
108
|
-
expect(fs.existsSync(path.join(projectDir, "middleware.ts"))).toBe(true);
|
|
109
|
-
});
|
|
110
|
-
|
|
111
|
-
it("package.json contains @stratum-hq/lib dependency", () => {
|
|
112
|
-
createProject("test-project", "express", projectDir, true);
|
|
113
|
-
|
|
114
|
-
const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
|
|
115
|
-
const pkg = JSON.parse(pkgContent);
|
|
116
|
-
expect(pkg.dependencies["@stratum-hq/lib"]).toBeDefined();
|
|
117
|
-
});
|
|
118
|
-
|
|
119
|
-
it("package.json contains pg dependency", () => {
|
|
120
|
-
createProject("test-project", "express", projectDir, true);
|
|
121
|
-
|
|
122
|
-
const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
|
|
123
|
-
const pkg = JSON.parse(pkgContent);
|
|
124
|
-
expect(pkg.dependencies["pg"]).toBeDefined();
|
|
125
|
-
});
|
|
126
|
-
|
|
127
|
-
it("package.json contains express dependency for express template", () => {
|
|
128
|
-
createProject("test-project", "express", projectDir, true);
|
|
129
|
-
|
|
130
|
-
const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
|
|
131
|
-
const pkg = JSON.parse(pkgContent);
|
|
132
|
-
expect(pkg.dependencies["express"]).toBeDefined();
|
|
133
|
-
});
|
|
134
|
-
|
|
135
|
-
it("docker-compose.yml contains PostgreSQL 16", () => {
|
|
136
|
-
createProject("test-project", "express", projectDir, true);
|
|
137
|
-
|
|
138
|
-
const dockerContent = fs.readFileSync(
|
|
139
|
-
path.join(projectDir, "docker-compose.yml"),
|
|
140
|
-
"utf8",
|
|
141
|
-
);
|
|
142
|
-
expect(dockerContent).toContain("postgres:16-alpine");
|
|
143
|
-
});
|
|
144
|
-
|
|
145
|
-
it("init.sql enables uuid-ossp and ltree extensions", () => {
|
|
146
|
-
createProject("test-project", "express", projectDir, true);
|
|
147
|
-
|
|
148
|
-
const sqlContent = fs.readFileSync(path.join(projectDir, "init.sql"), "utf8");
|
|
149
|
-
expect(sqlContent).toContain("uuid-ossp");
|
|
150
|
-
expect(sqlContent).toContain("ltree");
|
|
151
|
-
});
|
|
152
|
-
|
|
153
|
-
it(".env.example contains DATABASE_URL", () => {
|
|
154
|
-
createProject("test-project", "express", projectDir, true);
|
|
155
|
-
|
|
156
|
-
const envContent = fs.readFileSync(path.join(projectDir, ".env.example"), "utf8");
|
|
157
|
-
expect(envContent).toContain("DATABASE_URL");
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
it("default template is express", () => {
|
|
161
|
-
const result = parseArgs(["my-app"]);
|
|
162
|
-
expect(result.template).toBe("express");
|
|
163
|
-
});
|
|
164
|
-
});
|
|
165
|
-
|
|
166
|
-
// ─── Project name validation ──────────────────────────────────────────────────
|
|
167
|
-
|
|
168
|
-
describe("validateProjectName", () => {
|
|
169
|
-
it("accepts a valid name", () => {
|
|
170
|
-
expect(validateProjectName("valid-name")).toBeNull();
|
|
171
|
-
});
|
|
172
|
-
|
|
173
|
-
it("accepts names with dots and underscores", () => {
|
|
174
|
-
expect(validateProjectName("my.app_1")).toBeNull();
|
|
175
|
-
});
|
|
176
|
-
|
|
177
|
-
it("rejects empty string", () => {
|
|
178
|
-
expect(validateProjectName("")).not.toBeNull();
|
|
179
|
-
});
|
|
180
|
-
|
|
181
|
-
it("rejects name with spaces", () => {
|
|
182
|
-
expect(validateProjectName("name with spaces")).not.toBeNull();
|
|
183
|
-
});
|
|
184
|
-
|
|
185
|
-
it("rejects path traversal with ../", () => {
|
|
186
|
-
expect(validateProjectName("../escape")).not.toBeNull();
|
|
187
|
-
});
|
|
188
|
-
|
|
189
|
-
it("rejects absolute path", () => {
|
|
190
|
-
expect(validateProjectName("/absolute/path")).not.toBeNull();
|
|
191
|
-
});
|
|
192
|
-
|
|
193
|
-
it("rejects name starting with a dot", () => {
|
|
194
|
-
expect(validateProjectName(".hidden")).not.toBeNull();
|
|
195
|
-
});
|
|
196
|
-
|
|
197
|
-
it("rejects name with path separator embedded", () => {
|
|
198
|
-
expect(validateProjectName("foo/bar")).not.toBeNull();
|
|
199
|
-
});
|
|
200
|
-
});
|
|
201
|
-
|
|
202
|
-
// ─── Directory existence error ────────────────────────────────────────────────
|
|
203
|
-
|
|
204
|
-
describe("directory existence check", () => {
|
|
205
|
-
it("errors when directory exists without --force", () => {
|
|
206
|
-
// parseArgs doesn't control this — main() does the fs.existsSync check.
|
|
207
|
-
// We verify that parseArgs returns force=false by default, which triggers the error.
|
|
208
|
-
const result = parseArgs(["existing-dir"]);
|
|
209
|
-
expect(result.force).toBe(false);
|
|
210
|
-
// When force is false and dir exists, main() calls process.exit(1)
|
|
211
|
-
});
|
|
212
|
-
|
|
213
|
-
it("--force flag allows overwriting existing directory", () => {
|
|
214
|
-
const result = parseArgs(["existing-dir", "--force"]);
|
|
215
|
-
expect(result.force).toBe(true);
|
|
216
|
-
});
|
|
217
|
-
});
|