@quickback-dev/cli 0.58.2 → 0.58.3
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/README.md +3 -1
- package/dist/commands/compile.d.ts +5 -0
- package/dist/commands/compile.d.ts.map +1 -1
- package/dist/commands/compile.js +34 -0
- package/dist/commands/compile.js.map +1 -1
- package/dist/commands/schema.d.ts +16 -0
- package/dist/commands/schema.d.ts.map +1 -0
- package/dist/commands/schema.js +122 -0
- package/dist/commands/schema.js.map +1 -0
- package/dist/commands/schema.test.d.ts +2 -0
- package/dist/commands/schema.test.d.ts.map +1 -0
- package/dist/commands/schema.test.js +57 -0
- package/dist/commands/schema.test.js.map +1 -0
- package/dist/docs/content.d.ts.map +1 -1
- package/dist/docs/content.js +7 -2
- package/dist/docs/content.js.map +1 -1
- package/dist/index.js +10 -2
- package/dist/index.js.map +1 -1
- package/dist/lib/action-harvest.d.ts +9 -6
- package/dist/lib/action-harvest.d.ts.map +1 -1
- package/dist/lib/action-harvest.js +28 -15
- package/dist/lib/action-harvest.js.map +1 -1
- package/dist/lib/action-harvest.test.js +21 -0
- package/dist/lib/action-harvest.test.js.map +1 -1
- package/dist/lib/api-client.d.ts +53 -0
- package/dist/lib/api-client.d.ts.map +1 -1
- package/dist/lib/api-client.js +2 -0
- package/dist/lib/api-client.js.map +1 -1
- package/dist/lib/api-client.test.js +18 -0
- package/dist/lib/api-client.test.js.map +1 -1
- package/dist/lib/migrations/command-runner.d.ts +10 -0
- package/dist/lib/migrations/command-runner.d.ts.map +1 -0
- package/dist/lib/migrations/command-runner.js +66 -0
- package/dist/lib/migrations/command-runner.js.map +1 -0
- package/dist/lib/migrations/drizzle.d.ts +12 -0
- package/dist/lib/migrations/drizzle.d.ts.map +1 -0
- package/dist/lib/migrations/drizzle.js +60 -0
- package/dist/lib/migrations/drizzle.js.map +1 -0
- package/dist/lib/migrations/drizzle.test.d.ts +2 -0
- package/dist/lib/migrations/drizzle.test.d.ts.map +1 -0
- package/dist/lib/migrations/drizzle.test.js +61 -0
- package/dist/lib/migrations/drizzle.test.js.map +1 -0
- package/dist/lib/migrations/errors.d.ts +6 -0
- package/dist/lib/migrations/errors.d.ts.map +1 -0
- package/dist/lib/migrations/errors.js +9 -0
- package/dist/lib/migrations/errors.js.map +1 -0
- package/dist/lib/migrations/executor.d.ts +52 -0
- package/dist/lib/migrations/executor.d.ts.map +1 -0
- package/dist/lib/migrations/executor.js +190 -0
- package/dist/lib/migrations/executor.js.map +1 -0
- package/dist/lib/migrations/executor.test.d.ts +2 -0
- package/dist/lib/migrations/executor.test.d.ts.map +1 -0
- package/dist/lib/migrations/executor.test.js +241 -0
- package/dist/lib/migrations/executor.test.js.map +1 -0
- package/dist/lib/migrations/index.d.ts +11 -0
- package/dist/lib/migrations/index.d.ts.map +1 -0
- package/dist/lib/migrations/index.js +11 -0
- package/dist/lib/migrations/index.js.map +1 -0
- package/dist/lib/migrations/inventory.d.ts +19 -0
- package/dist/lib/migrations/inventory.d.ts.map +1 -0
- package/dist/lib/migrations/inventory.js +135 -0
- package/dist/lib/migrations/inventory.js.map +1 -0
- package/dist/lib/migrations/inventory.test.d.ts +2 -0
- package/dist/lib/migrations/inventory.test.d.ts.map +1 -0
- package/dist/lib/migrations/inventory.test.js +81 -0
- package/dist/lib/migrations/inventory.test.js.map +1 -0
- package/dist/lib/migrations/lock.d.ts +6 -0
- package/dist/lib/migrations/lock.d.ts.map +1 -0
- package/dist/lib/migrations/lock.js +101 -0
- package/dist/lib/migrations/lock.js.map +1 -0
- package/dist/lib/migrations/lock.test.d.ts +2 -0
- package/dist/lib/migrations/lock.test.d.ts.map +1 -0
- package/dist/lib/migrations/lock.test.js +35 -0
- package/dist/lib/migrations/lock.test.js.map +1 -0
- package/dist/lib/migrations/paths.d.ts +12 -0
- package/dist/lib/migrations/paths.d.ts.map +1 -0
- package/dist/lib/migrations/paths.js +82 -0
- package/dist/lib/migrations/paths.js.map +1 -0
- package/dist/lib/migrations/paths.test.d.ts +2 -0
- package/dist/lib/migrations/paths.test.d.ts.map +1 -0
- package/dist/lib/migrations/paths.test.js +32 -0
- package/dist/lib/migrations/paths.test.js.map +1 -0
- package/dist/lib/migrations/plan.d.ts +7 -0
- package/dist/lib/migrations/plan.d.ts.map +1 -0
- package/dist/lib/migrations/plan.js +189 -0
- package/dist/lib/migrations/plan.js.map +1 -0
- package/dist/lib/migrations/plan.test.d.ts +2 -0
- package/dist/lib/migrations/plan.test.d.ts.map +1 -0
- package/dist/lib/migrations/plan.test.js +104 -0
- package/dist/lib/migrations/plan.test.js.map +1 -0
- package/dist/lib/migrations/staging.d.ts +18 -0
- package/dist/lib/migrations/staging.d.ts.map +1 -0
- package/dist/lib/migrations/staging.js +150 -0
- package/dist/lib/migrations/staging.js.map +1 -0
- package/dist/lib/migrations/staging.test.d.ts +2 -0
- package/dist/lib/migrations/staging.test.d.ts.map +1 -0
- package/dist/lib/migrations/staging.test.js +73 -0
- package/dist/lib/migrations/staging.test.js.map +1 -0
- package/dist/lib/migrations/types.d.ts +49 -0
- package/dist/lib/migrations/types.d.ts.map +1 -0
- package/dist/lib/migrations/types.js +18 -0
- package/dist/lib/migrations/types.js.map +1 -0
- package/dist/lib/schema-engine-loader.d.ts +8 -0
- package/dist/lib/schema-engine-loader.d.ts.map +1 -0
- package/dist/lib/schema-engine-loader.js +26 -0
- package/dist/lib/schema-engine-loader.js.map +1 -0
- package/dist/lib/schema-sync/index.d.ts +41 -0
- package/dist/lib/schema-sync/index.d.ts.map +1 -0
- package/dist/lib/schema-sync/index.js +246 -0
- package/dist/lib/schema-sync/index.js.map +1 -0
- package/dist/lib/schema-sync/index.test.d.ts +2 -0
- package/dist/lib/schema-sync/index.test.d.ts.map +1 -0
- package/dist/lib/schema-sync/index.test.js +128 -0
- package/dist/lib/schema-sync/index.test.js.map +1 -0
- package/dist/schema-engine/index.d.ts +3 -0
- package/dist/schema-engine/index.d.ts.map +1 -0
- package/dist/schema-engine/index.js +854 -0
- package/dist/schema-engine/index.js.map +7 -0
- package/dist/schema-engine/managed-columns.d.ts +82 -0
- package/dist/schema-engine/managed-columns.d.ts.map +1 -0
- package/dist/schema-engine/source-sync.d.ts +64 -0
- package/dist/schema-engine/source-sync.d.ts.map +1 -0
- package/dist/skill/docs/compiler/definitions/actions.md +14 -6
- package/dist/skill/docs/compiler/targets/hono-api/using-the-api/openapi.md +7 -4
- package/dist/skill/docs/compiler/targets/hono-api/using-the-api/typescript.md +141 -0
- package/package.json +4 -2
- package/src/skill/docs/compiler/definitions/actions.md +14 -6
- package/src/skill/docs/compiler/targets/hono-api/using-the-api/openapi.md +7 -4
- package/src/skill/docs/compiler/targets/hono-api/using-the-api/typescript.md +141 -0
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { lstat, mkdir, open, readFile, unlink } from 'node:fs/promises';
|
|
3
|
+
import { join, resolve } from 'node:path';
|
|
4
|
+
import { MigrationExecutorError } from './errors.js';
|
|
5
|
+
const DEFAULT_STALE_AFTER_MS = 30 * 60 * 1000;
|
|
6
|
+
export async function withMigrationLock(projectRoot, operation, options = {}) {
|
|
7
|
+
const absoluteProjectRoot = resolve(projectRoot);
|
|
8
|
+
const tempRoot = join(absoluteProjectRoot, '.quickback-tmp');
|
|
9
|
+
await mkdir(tempRoot, { recursive: true, mode: 0o700 });
|
|
10
|
+
const tempEntry = await lstat(tempRoot);
|
|
11
|
+
if (tempEntry.isSymbolicLink() || !tempEntry.isDirectory()) {
|
|
12
|
+
throw new MigrationExecutorError('MIGRATION_SYMLINK_UNSAFE', `Quickback temporary path must be a real directory: ${tempRoot}`);
|
|
13
|
+
}
|
|
14
|
+
const lockPath = join(tempRoot, 'migrations.lock');
|
|
15
|
+
const now = options.now ?? (() => new Date());
|
|
16
|
+
const record = {
|
|
17
|
+
token: randomUUID(),
|
|
18
|
+
pid: process.pid,
|
|
19
|
+
startedAt: now().toISOString(),
|
|
20
|
+
projectRoot: absoluteProjectRoot,
|
|
21
|
+
};
|
|
22
|
+
let lockHandle;
|
|
23
|
+
try {
|
|
24
|
+
lockHandle = await open(lockPath, 'wx', 0o600);
|
|
25
|
+
}
|
|
26
|
+
catch (error) {
|
|
27
|
+
if (!isNodeError(error) || error.code !== 'EEXIST')
|
|
28
|
+
throw error;
|
|
29
|
+
throw await describeExistingLock(lockPath, now(), options.staleAfterMs);
|
|
30
|
+
}
|
|
31
|
+
try {
|
|
32
|
+
await lockHandle.writeFile(`${JSON.stringify(record)}\n`, 'utf8');
|
|
33
|
+
await lockHandle.sync();
|
|
34
|
+
}
|
|
35
|
+
finally {
|
|
36
|
+
await lockHandle.close();
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
return await operation();
|
|
40
|
+
}
|
|
41
|
+
finally {
|
|
42
|
+
await releaseOwnedLock(lockPath, record.token);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
async function describeExistingLock(lockPath, now, staleAfterMs = DEFAULT_STALE_AFTER_MS) {
|
|
46
|
+
try {
|
|
47
|
+
const entry = await lstat(lockPath);
|
|
48
|
+
if (entry.isSymbolicLink() || !entry.isFile()) {
|
|
49
|
+
return new MigrationExecutorError('MIGRATION_LOCKED', `Migration lock is not a regular file: ${lockPath}`);
|
|
50
|
+
}
|
|
51
|
+
const raw = await readFile(lockPath, 'utf8');
|
|
52
|
+
const record = JSON.parse(raw);
|
|
53
|
+
const startedAt = typeof record.startedAt === 'string'
|
|
54
|
+
? Date.parse(record.startedAt)
|
|
55
|
+
: Number.NaN;
|
|
56
|
+
const ageMs = Number.isFinite(startedAt) ? now.getTime() - startedAt : null;
|
|
57
|
+
const pid = typeof record.pid === 'number' ? record.pid : null;
|
|
58
|
+
const processState = pid === null ? 'unknown' : processLiveness(pid);
|
|
59
|
+
const stale = processState === 'dead' && ageMs !== null && ageMs >= staleAfterMs;
|
|
60
|
+
return new MigrationExecutorError('MIGRATION_LOCKED', stale
|
|
61
|
+
? `A stale Quickback migration lock exists at ${lockPath} ` +
|
|
62
|
+
`(pid ${pid}, started ${record.startedAt}). Confirm no compile is running, then remove that lock file.`
|
|
63
|
+
: `Another Quickback migration is active at ${lockPath}` +
|
|
64
|
+
(pid === null ? '' : ` (pid ${pid}, process ${processState})`) +
|
|
65
|
+
(record.startedAt ? `, started ${record.startedAt}` : ''));
|
|
66
|
+
}
|
|
67
|
+
catch (error) {
|
|
68
|
+
if (error instanceof MigrationExecutorError)
|
|
69
|
+
return error;
|
|
70
|
+
return new MigrationExecutorError('MIGRATION_LOCKED', `A migration lock exists but could not be inspected safely: ${lockPath}`, { cause: error });
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
async function releaseOwnedLock(lockPath, token) {
|
|
74
|
+
try {
|
|
75
|
+
const entry = await lstat(lockPath);
|
|
76
|
+
if (entry.isSymbolicLink() || !entry.isFile())
|
|
77
|
+
return;
|
|
78
|
+
const record = JSON.parse(await readFile(lockPath, 'utf8'));
|
|
79
|
+
if (record.token === token)
|
|
80
|
+
await unlink(lockPath);
|
|
81
|
+
}
|
|
82
|
+
catch (error) {
|
|
83
|
+
if (!isNodeError(error) || error.code !== 'ENOENT')
|
|
84
|
+
throw error;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
function processLiveness(pid) {
|
|
88
|
+
try {
|
|
89
|
+
process.kill(pid, 0);
|
|
90
|
+
return 'alive';
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
if (isNodeError(error) && error.code === 'ESRCH')
|
|
94
|
+
return 'dead';
|
|
95
|
+
return 'unknown';
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
function isNodeError(error) {
|
|
99
|
+
return error instanceof Error && 'code' in error;
|
|
100
|
+
}
|
|
101
|
+
//# sourceMappingURL=lock.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/lib/migrations/lock.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock.test.d.ts","sourceRoot":"","sources":["../../../src/lib/migrations/lock.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { describe, expect, test } from 'bun:test';
|
|
2
|
+
import { mkdtemp, readFile, readdir, rm } from 'node:fs/promises';
|
|
3
|
+
import { tmpdir } from 'node:os';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { withMigrationLock } from './lock.js';
|
|
6
|
+
describe('migration lock', () => {
|
|
7
|
+
test('prevents overlapping migration transactions and releases ownership', async () => {
|
|
8
|
+
const root = await mkdtemp(join(tmpdir(), 'qb-migration-lock-'));
|
|
9
|
+
try {
|
|
10
|
+
await withMigrationLock(root, async () => {
|
|
11
|
+
const lock = JSON.parse(await readFile(join(root, '.quickback-tmp', 'migrations.lock'), 'utf8'));
|
|
12
|
+
expect(lock.pid).toBe(process.pid);
|
|
13
|
+
await expect(withMigrationLock(root, async () => { }))
|
|
14
|
+
.rejects.toThrow('Another Quickback migration is active');
|
|
15
|
+
});
|
|
16
|
+
expect(await readdir(join(root, '.quickback-tmp'))).toEqual([]);
|
|
17
|
+
}
|
|
18
|
+
finally {
|
|
19
|
+
await rm(root, { recursive: true, force: true });
|
|
20
|
+
}
|
|
21
|
+
});
|
|
22
|
+
test('releases the lock when the operation fails', async () => {
|
|
23
|
+
const root = await mkdtemp(join(tmpdir(), 'qb-migration-lock-error-'));
|
|
24
|
+
try {
|
|
25
|
+
await expect(withMigrationLock(root, async () => {
|
|
26
|
+
throw new Error('planned failure');
|
|
27
|
+
})).rejects.toThrow('planned failure');
|
|
28
|
+
expect(await readdir(join(root, '.quickback-tmp'))).toEqual([]);
|
|
29
|
+
}
|
|
30
|
+
finally {
|
|
31
|
+
await rm(root, { recursive: true, force: true });
|
|
32
|
+
}
|
|
33
|
+
});
|
|
34
|
+
});
|
|
35
|
+
//# sourceMappingURL=lock.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock.test.js","sourceRoot":"","sources":["../../../src/lib/migrations/lock.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;gBACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CACpC,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAC/C,MAAM,CACP,CAAoB,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnC,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;qBAClD,OAAO,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;gBAC9C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export declare function normalizeSafeRelativePath(value: string, label?: string): string;
|
|
2
|
+
export declare function resolvePathWithinRoot(root: string, relativePath: string, label?: string): string;
|
|
3
|
+
export declare function isPathInside(parent: string, child: string): boolean;
|
|
4
|
+
/**
|
|
5
|
+
* Reject every symlink component. This is intentionally stricter than merely
|
|
6
|
+
* checking the final realpath: migration state must be a real, reviewable tree
|
|
7
|
+
* inside the project, not an alias to another location.
|
|
8
|
+
*/
|
|
9
|
+
export declare function assertNoSymlinkComponents(root: string, relativePath: string, options?: {
|
|
10
|
+
allowMissingLeaf?: boolean;
|
|
11
|
+
}): Promise<void>;
|
|
12
|
+
//# sourceMappingURL=paths.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/lib/migrations/paths.ts"],"names":[],"mappings":"AAQA,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,MAAM,CAmC/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,MAAM,CAmBhG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAInE;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,OAAO,CAAC,IAAI,CAAC,CAyCf"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { lstat, realpath } from 'node:fs/promises';
|
|
2
|
+
import { isAbsolute, posix, relative, resolve, sep, win32 } from 'node:path';
|
|
3
|
+
import { MigrationExecutorError } from './errors.js';
|
|
4
|
+
const MAX_PROTOCOL_PATH_LENGTH = 1024;
|
|
5
|
+
const CONTROL_CHARACTER_RE = /[\u0000-\u001f\u007f]/;
|
|
6
|
+
export function normalizeSafeRelativePath(value, label = 'path') {
|
|
7
|
+
if (typeof value !== 'string' ||
|
|
8
|
+
value.length === 0 ||
|
|
9
|
+
value.length > MAX_PROTOCOL_PATH_LENGTH ||
|
|
10
|
+
CONTROL_CHARACTER_RE.test(value)) {
|
|
11
|
+
throw new MigrationExecutorError('MIGRATION_PATH_UNSAFE', `${label} must be a non-empty relative path without control characters`);
|
|
12
|
+
}
|
|
13
|
+
if (value.includes('\\') || isAbsolute(value) || win32.isAbsolute(value)) {
|
|
14
|
+
throw new MigrationExecutorError('MIGRATION_PATH_UNSAFE', `${label} must use normalized relative POSIX path syntax: ${JSON.stringify(value)}`);
|
|
15
|
+
}
|
|
16
|
+
const normalized = posix.normalize(value);
|
|
17
|
+
if (normalized !== value ||
|
|
18
|
+
normalized === '.' ||
|
|
19
|
+
normalized === '..' ||
|
|
20
|
+
normalized.startsWith('../') ||
|
|
21
|
+
normalized.split('/').some((part) => part === '' || part === '.' || part === '..')) {
|
|
22
|
+
throw new MigrationExecutorError('MIGRATION_PATH_UNSAFE', `${label} must be normalized and may not contain "." or "..": ${JSON.stringify(value)}`);
|
|
23
|
+
}
|
|
24
|
+
return normalized;
|
|
25
|
+
}
|
|
26
|
+
export function resolvePathWithinRoot(root, relativePath, label = 'path') {
|
|
27
|
+
const safePath = normalizeSafeRelativePath(relativePath, label);
|
|
28
|
+
const absoluteRoot = resolve(root);
|
|
29
|
+
const candidate = resolve(absoluteRoot, safePath);
|
|
30
|
+
const fromRoot = relative(absoluteRoot, candidate);
|
|
31
|
+
if (fromRoot === '' ||
|
|
32
|
+
fromRoot === '..' ||
|
|
33
|
+
fromRoot.startsWith(`..${sep}`) ||
|
|
34
|
+
isAbsolute(fromRoot)) {
|
|
35
|
+
throw new MigrationExecutorError('MIGRATION_PATH_UNSAFE', `${label} escapes the migration staging root: ${JSON.stringify(relativePath)}`);
|
|
36
|
+
}
|
|
37
|
+
return candidate;
|
|
38
|
+
}
|
|
39
|
+
export function isPathInside(parent, child) {
|
|
40
|
+
const fromParent = relative(resolve(parent), resolve(child));
|
|
41
|
+
return fromParent !== '' && fromParent !== '..' &&
|
|
42
|
+
!fromParent.startsWith(`..${sep}`) && !isAbsolute(fromParent);
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Reject every symlink component. This is intentionally stricter than merely
|
|
46
|
+
* checking the final realpath: migration state must be a real, reviewable tree
|
|
47
|
+
* inside the project, not an alias to another location.
|
|
48
|
+
*/
|
|
49
|
+
export async function assertNoSymlinkComponents(root, relativePath, options = {}) {
|
|
50
|
+
const safePath = normalizeSafeRelativePath(relativePath);
|
|
51
|
+
const absoluteRoot = resolve(root);
|
|
52
|
+
const rootReal = await realpath(absoluteRoot);
|
|
53
|
+
const parts = safePath.split('/');
|
|
54
|
+
let current = absoluteRoot;
|
|
55
|
+
for (let index = 0; index < parts.length; index += 1) {
|
|
56
|
+
current = resolve(current, parts[index]);
|
|
57
|
+
try {
|
|
58
|
+
const entry = await lstat(current);
|
|
59
|
+
if (entry.isSymbolicLink()) {
|
|
60
|
+
throw new MigrationExecutorError('MIGRATION_SYMLINK_UNSAFE', `Migration path contains a symbolic link: ${safePath}`);
|
|
61
|
+
}
|
|
62
|
+
const currentReal = await realpath(current);
|
|
63
|
+
if (currentReal !== rootReal && !isPathInside(rootReal, currentReal)) {
|
|
64
|
+
throw new MigrationExecutorError('MIGRATION_SYMLINK_UNSAFE', `Migration path resolves outside its root: ${safePath}`);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
catch (error) {
|
|
68
|
+
if (error instanceof MigrationExecutorError ||
|
|
69
|
+
!isNodeError(error) ||
|
|
70
|
+
error.code !== 'ENOENT') {
|
|
71
|
+
throw error;
|
|
72
|
+
}
|
|
73
|
+
if (!options.allowMissingLeaf || index < parts.length - 1) {
|
|
74
|
+
throw new MigrationExecutorError('MIGRATION_PATH_UNSAFE', `Migration path does not exist: ${safePath}`, { cause: error });
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
function isNodeError(error) {
|
|
80
|
+
return error instanceof Error && 'code' in error;
|
|
81
|
+
}
|
|
82
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/lib/migrations/paths.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.test.d.ts","sourceRoot":"","sources":["../../../src/lib/migrations/paths.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { describe, expect, test } from 'bun:test';
|
|
2
|
+
import { mkdtemp, mkdir, rm, symlink } from 'node:fs/promises';
|
|
3
|
+
import { tmpdir } from 'node:os';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { assertNoSymlinkComponents, normalizeSafeRelativePath, resolvePathWithinRoot, } from './paths.js';
|
|
6
|
+
describe('migration paths', () => {
|
|
7
|
+
test.each([
|
|
8
|
+
'../escape',
|
|
9
|
+
'..\\escape',
|
|
10
|
+
'nested\\..\\escape',
|
|
11
|
+
'C:\\temp\\drizzle.config.ts',
|
|
12
|
+
'\\\\server\\share\\drizzle.config.ts',
|
|
13
|
+
])('rejects cross-platform traversal and absolute spellings: %s', (path) => {
|
|
14
|
+
expect(() => normalizeSafeRelativePath(path)).toThrow();
|
|
15
|
+
});
|
|
16
|
+
test('resolves normalized paths inside the supplied root', () => {
|
|
17
|
+
expect(resolvePathWithinRoot('/tmp/project', 'quickback/drizzle'))
|
|
18
|
+
.toBe('/tmp/project/quickback/drizzle');
|
|
19
|
+
});
|
|
20
|
+
test('rejects symlink components even when the target is another child', async () => {
|
|
21
|
+
const root = await mkdtemp(join(tmpdir(), 'qb-migration-path-'));
|
|
22
|
+
try {
|
|
23
|
+
await mkdir(join(root, 'real'));
|
|
24
|
+
await symlink(join(root, 'real'), join(root, 'linked'), 'dir');
|
|
25
|
+
await expect(assertNoSymlinkComponents(root, 'linked')).rejects.toThrow('symbolic link');
|
|
26
|
+
}
|
|
27
|
+
finally {
|
|
28
|
+
await rm(root, { recursive: true, force: true });
|
|
29
|
+
}
|
|
30
|
+
});
|
|
31
|
+
});
|
|
32
|
+
//# sourceMappingURL=paths.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.test.js","sourceRoot":"","sources":["../../../src/lib/migrations/paths.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,IAAI,CAAC;QACR,WAAW;QACX,YAAY;QACZ,oBAAoB;QACpB,6BAA6B;QAC7B,sCAAsC;KACvC,CAAC,CAAC,6DAA6D,EAAE,CAAC,IAAI,EAAE,EAAE;QACzE,MAAM,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,qBAAqB,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;aAC/D,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAChC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACrE,eAAe,CAChB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type ClientMigrationPlan } from './types.js';
|
|
2
|
+
export interface ClientMigrationPlanValidationOptions {
|
|
3
|
+
allowedTargetIds?: ReadonlySet<string> | readonly string[];
|
|
4
|
+
migrationRootPath?: string;
|
|
5
|
+
}
|
|
6
|
+
export declare function validateClientMigrationPlan(value: unknown, options?: ClientMigrationPlanValidationOptions): ClientMigrationPlan;
|
|
7
|
+
//# sourceMappingURL=plan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/lib/migrations/plan.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,mBAAmB,EAIzB,MAAM,YAAY,CAAC;AAepB,MAAM,WAAW,oCAAoC;IACnD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oCAAyC,GACjD,mBAAmB,CAmErB"}
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import { posix } from 'node:path';
|
|
2
|
+
import { MigrationExecutorError } from './errors.js';
|
|
3
|
+
import { normalizeSafeRelativePath } from './paths.js';
|
|
4
|
+
import { CLIENT_MIGRATION_POSTPROCESSORS, CLIENT_MIGRATION_PROTOCOL_VERSION, CLIENT_MIGRATION_TARGET_IDS, SUPPORTED_DRIZZLE_VERSION, } from './types.js';
|
|
5
|
+
const PLAN_KEYS = new Set(['protocolVersion', 'drizzleVersion', 'targets']);
|
|
6
|
+
const TARGET_KEYS = new Set([
|
|
7
|
+
'id',
|
|
8
|
+
'dialect',
|
|
9
|
+
'configPath',
|
|
10
|
+
'outPath',
|
|
11
|
+
'renameHints',
|
|
12
|
+
'autoCreateRenames',
|
|
13
|
+
'postprocessors',
|
|
14
|
+
]);
|
|
15
|
+
const CONFIG_EXTENSION_RE = /\.config\.(?:[cm]?[jt]s)$/;
|
|
16
|
+
const SAFE_RENAME_IDENTIFIER_RE = /^[A-Za-z0-9_$."-]+$/;
|
|
17
|
+
export function validateClientMigrationPlan(value, options = {}) {
|
|
18
|
+
const plan = requirePlainObject(value, 'migration plan');
|
|
19
|
+
assertOnlyKeys(plan, PLAN_KEYS, 'migration plan');
|
|
20
|
+
if (plan.protocolVersion !== CLIENT_MIGRATION_PROTOCOL_VERSION) {
|
|
21
|
+
fail(`migration plan protocolVersion must be ${CLIENT_MIGRATION_PROTOCOL_VERSION}`);
|
|
22
|
+
}
|
|
23
|
+
if (plan.drizzleVersion !== SUPPORTED_DRIZZLE_VERSION) {
|
|
24
|
+
fail(`migration plan drizzleVersion must be exactly ${SUPPORTED_DRIZZLE_VERSION}; received ${JSON.stringify(plan.drizzleVersion)}`);
|
|
25
|
+
}
|
|
26
|
+
if (!Array.isArray(plan.targets) || plan.targets.length === 0) {
|
|
27
|
+
fail('migration plan targets must be a non-empty array');
|
|
28
|
+
}
|
|
29
|
+
const allowedTargetIds = new Set(options.allowedTargetIds ?? CLIENT_MIGRATION_TARGET_IDS);
|
|
30
|
+
const migrationRootPath = options.migrationRootPath
|
|
31
|
+
? normalizeSafeRelativePath(options.migrationRootPath, 'migration root path')
|
|
32
|
+
: undefined;
|
|
33
|
+
const seenIds = new Set();
|
|
34
|
+
const seenOutPaths = new Set();
|
|
35
|
+
const seenConfigPaths = new Set();
|
|
36
|
+
const targets = plan.targets.map((target, index) => {
|
|
37
|
+
const parsed = validateTarget(target, index, allowedTargetIds);
|
|
38
|
+
if (seenIds.has(parsed.id)) {
|
|
39
|
+
fail(`migration target id is duplicated: ${parsed.id}`);
|
|
40
|
+
}
|
|
41
|
+
if (seenOutPaths.has(parsed.outPath)) {
|
|
42
|
+
fail(`migration target outPath is duplicated: ${parsed.outPath}`);
|
|
43
|
+
}
|
|
44
|
+
if (seenConfigPaths.has(parsed.configPath)) {
|
|
45
|
+
fail(`migration target configPath is duplicated: ${parsed.configPath}`);
|
|
46
|
+
}
|
|
47
|
+
for (const seenOutPath of seenOutPaths) {
|
|
48
|
+
if (parsed.outPath.startsWith(`${seenOutPath}/`) ||
|
|
49
|
+
seenOutPath.startsWith(`${parsed.outPath}/`)) {
|
|
50
|
+
fail(`migration target outPaths may not overlap: ${seenOutPath} and ${parsed.outPath}`);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
if (migrationRootPath &&
|
|
54
|
+
parsed.outPath !== migrationRootPath &&
|
|
55
|
+
!parsed.outPath.startsWith(`${migrationRootPath}/`)) {
|
|
56
|
+
fail(`migration target ${parsed.id} outPath must be inside ${migrationRootPath}: ${parsed.outPath}`);
|
|
57
|
+
}
|
|
58
|
+
seenIds.add(parsed.id);
|
|
59
|
+
seenOutPaths.add(parsed.outPath);
|
|
60
|
+
seenConfigPaths.add(parsed.configPath);
|
|
61
|
+
return parsed;
|
|
62
|
+
});
|
|
63
|
+
return {
|
|
64
|
+
protocolVersion: CLIENT_MIGRATION_PROTOCOL_VERSION,
|
|
65
|
+
drizzleVersion: SUPPORTED_DRIZZLE_VERSION,
|
|
66
|
+
targets,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
function validateTarget(value, index, allowedTargetIds) {
|
|
70
|
+
const label = `migration target ${index}`;
|
|
71
|
+
const target = requirePlainObject(value, label);
|
|
72
|
+
assertOnlyKeys(target, TARGET_KEYS, label);
|
|
73
|
+
if (typeof target.id !== 'string' || !allowedTargetIds.has(target.id)) {
|
|
74
|
+
fail(`${label} id is not allowlisted: ${JSON.stringify(target.id)} (allowed: ${[...allowedTargetIds].join(', ')})`);
|
|
75
|
+
}
|
|
76
|
+
if (target.dialect !== 'sqlite' && target.dialect !== 'postgresql') {
|
|
77
|
+
fail(`${label} dialect must be "sqlite" or "postgresql"`);
|
|
78
|
+
}
|
|
79
|
+
const configPath = normalizeSafeRelativePath(requireString(target.configPath, `${label} configPath`), `${label} configPath`);
|
|
80
|
+
if (!CONFIG_EXTENSION_RE.test(posix.basename(configPath))) {
|
|
81
|
+
fail(`${label} configPath must name a Drizzle .config.ts/.js module`);
|
|
82
|
+
}
|
|
83
|
+
const outPath = normalizeSafeRelativePath(requireString(target.outPath, `${label} outPath`), `${label} outPath`);
|
|
84
|
+
if (!Array.isArray(target.postprocessors)) {
|
|
85
|
+
fail(`${label} postprocessors must be an array`);
|
|
86
|
+
}
|
|
87
|
+
const postprocessors = target.postprocessors.map((operation, operationIndex) => {
|
|
88
|
+
if (typeof operation !== 'string' ||
|
|
89
|
+
!CLIENT_MIGRATION_POSTPROCESSORS.includes(operation)) {
|
|
90
|
+
fail(`${label} postprocessor ${operationIndex} is not allowlisted: ${JSON.stringify(operation)}`);
|
|
91
|
+
}
|
|
92
|
+
return operation;
|
|
93
|
+
});
|
|
94
|
+
if (new Set(postprocessors).size !== postprocessors.length) {
|
|
95
|
+
fail(`${label} postprocessors may not contain duplicates`);
|
|
96
|
+
}
|
|
97
|
+
if (target.autoCreateRenames !== undefined &&
|
|
98
|
+
typeof target.autoCreateRenames !== 'boolean') {
|
|
99
|
+
fail(`${label} autoCreateRenames must be a boolean`);
|
|
100
|
+
}
|
|
101
|
+
if (target.dialect === 'sqlite' &&
|
|
102
|
+
postprocessors.includes('reorder-pg-constraints')) {
|
|
103
|
+
fail(`${label} cannot apply reorder-pg-constraints to sqlite`);
|
|
104
|
+
}
|
|
105
|
+
if (target.dialect === 'sqlite' && postprocessors.includes('append-rls')) {
|
|
106
|
+
fail(`${label} cannot apply append-rls to sqlite`);
|
|
107
|
+
}
|
|
108
|
+
if (target.dialect === 'postgresql' &&
|
|
109
|
+
postprocessors.includes('d1-safety')) {
|
|
110
|
+
fail(`${label} cannot apply d1-safety to postgresql`);
|
|
111
|
+
}
|
|
112
|
+
if (target.dialect === 'postgresql' && target.autoCreateRenames === true) {
|
|
113
|
+
fail(`${label} cannot enable autoCreateRenames for postgresql`);
|
|
114
|
+
}
|
|
115
|
+
return {
|
|
116
|
+
id: target.id,
|
|
117
|
+
dialect: target.dialect,
|
|
118
|
+
configPath,
|
|
119
|
+
outPath,
|
|
120
|
+
...(target.renameHints === undefined
|
|
121
|
+
? {}
|
|
122
|
+
: { renameHints: validateRenameHints(target.renameHints, label) }),
|
|
123
|
+
...(target.autoCreateRenames === undefined
|
|
124
|
+
? {}
|
|
125
|
+
: { autoCreateRenames: target.autoCreateRenames }),
|
|
126
|
+
postprocessors,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
function validateRenameHints(value, label) {
|
|
130
|
+
const hints = requirePlainObject(value, `${label} renameHints`);
|
|
131
|
+
assertOnlyKeys(hints, new Set(['tables', 'columns']), `${label} renameHints`);
|
|
132
|
+
const result = {};
|
|
133
|
+
if (hints.tables !== undefined) {
|
|
134
|
+
const tables = requirePlainObject(hints.tables, `${label} renameHints.tables`);
|
|
135
|
+
result.tables = validateIdentifierMap(tables, `${label} renameHints.tables`);
|
|
136
|
+
}
|
|
137
|
+
if (hints.columns !== undefined) {
|
|
138
|
+
const columns = requirePlainObject(hints.columns, `${label} renameHints.columns`);
|
|
139
|
+
result.columns = {};
|
|
140
|
+
for (const [tableName, mappings] of Object.entries(columns)) {
|
|
141
|
+
assertSafeRenameIdentifier(tableName, `${label} renameHints.columns table`);
|
|
142
|
+
result.columns[tableName] = validateIdentifierMap(requirePlainObject(mappings, `${label} renameHints.columns[${JSON.stringify(tableName)}]`), `${label} renameHints.columns[${JSON.stringify(tableName)}]`);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
return result;
|
|
146
|
+
}
|
|
147
|
+
function validateIdentifierMap(value, label) {
|
|
148
|
+
const result = {};
|
|
149
|
+
for (const [nextName, previousName] of Object.entries(value)) {
|
|
150
|
+
assertSafeRenameIdentifier(nextName, `${label} key`);
|
|
151
|
+
if (typeof previousName !== 'string') {
|
|
152
|
+
fail(`${label} values must be strings`);
|
|
153
|
+
}
|
|
154
|
+
assertSafeRenameIdentifier(previousName, `${label} value`);
|
|
155
|
+
result[nextName] = previousName;
|
|
156
|
+
}
|
|
157
|
+
return result;
|
|
158
|
+
}
|
|
159
|
+
function assertSafeRenameIdentifier(value, label) {
|
|
160
|
+
if (value.length === 0 ||
|
|
161
|
+
value.length > 255 ||
|
|
162
|
+
!SAFE_RENAME_IDENTIFIER_RE.test(value)) {
|
|
163
|
+
fail(`${label} must be a safe schema identifier`);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
function requireString(value, label) {
|
|
167
|
+
if (typeof value !== 'string')
|
|
168
|
+
fail(`${label} must be a string`);
|
|
169
|
+
return value;
|
|
170
|
+
}
|
|
171
|
+
function requirePlainObject(value, label) {
|
|
172
|
+
if (typeof value !== 'object' ||
|
|
173
|
+
value === null ||
|
|
174
|
+
Array.isArray(value) ||
|
|
175
|
+
Object.getPrototypeOf(value) !== Object.prototype) {
|
|
176
|
+
fail(`${label} must be a plain object`);
|
|
177
|
+
}
|
|
178
|
+
return value;
|
|
179
|
+
}
|
|
180
|
+
function assertOnlyKeys(value, allowedKeys, label) {
|
|
181
|
+
const unknownKeys = Object.keys(value).filter((key) => !allowedKeys.has(key));
|
|
182
|
+
if (unknownKeys.length > 0) {
|
|
183
|
+
fail(`${label} contains unsupported fields: ${unknownKeys.join(', ')}`);
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
function fail(message) {
|
|
187
|
+
throw new MigrationExecutorError('MIGRATION_PLAN_INVALID', message);
|
|
188
|
+
}
|
|
189
|
+
//# sourceMappingURL=plan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/lib/migrations/plan.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.test.d.ts","sourceRoot":"","sources":["../../../src/lib/migrations/plan.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { describe, expect, test } from 'bun:test';
|
|
2
|
+
import { validateClientMigrationPlan } from './plan.js';
|
|
3
|
+
function validPlan() {
|
|
4
|
+
return {
|
|
5
|
+
protocolVersion: 2,
|
|
6
|
+
drizzleVersion: '0.31.10',
|
|
7
|
+
targets: [{
|
|
8
|
+
id: 'features',
|
|
9
|
+
dialect: 'sqlite',
|
|
10
|
+
configPath: 'drizzle.config.ts',
|
|
11
|
+
outPath: 'quickback/drizzle/features',
|
|
12
|
+
renameHints: {
|
|
13
|
+
tables: { users_v2: 'users' },
|
|
14
|
+
columns: { users_v2: { display_name: 'name' } },
|
|
15
|
+
},
|
|
16
|
+
autoCreateRenames: true,
|
|
17
|
+
postprocessors: ['update-journal', 'd1-safety'],
|
|
18
|
+
}],
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
describe('client migration plan validation', () => {
|
|
22
|
+
test('accepts the typed allowlisted protocol', () => {
|
|
23
|
+
expect(validateClientMigrationPlan(validPlan(), {
|
|
24
|
+
migrationRootPath: 'quickback/drizzle',
|
|
25
|
+
})).toEqual(validPlan());
|
|
26
|
+
});
|
|
27
|
+
test.each([
|
|
28
|
+
['protocol version', { ...validPlan(), protocolVersion: 1 }],
|
|
29
|
+
['drizzle version', { ...validPlan(), drizzleVersion: '^0.31.10' }],
|
|
30
|
+
['remote command', { ...validPlan(), command: 'rm -rf /' }],
|
|
31
|
+
['unknown target', {
|
|
32
|
+
...validPlan(),
|
|
33
|
+
targets: [{ ...validPlan().targets[0], id: 'custom' }],
|
|
34
|
+
}],
|
|
35
|
+
['unknown operation', {
|
|
36
|
+
...validPlan(),
|
|
37
|
+
targets: [{ ...validPlan().targets[0], postprocessors: ['run-shell'] }],
|
|
38
|
+
}],
|
|
39
|
+
['target command', {
|
|
40
|
+
...validPlan(),
|
|
41
|
+
targets: [{ ...validPlan().targets[0], command: 'drizzle-kit generate' }],
|
|
42
|
+
}],
|
|
43
|
+
])('rejects %s', (_label, plan) => {
|
|
44
|
+
expect(() => validateClientMigrationPlan(plan)).toThrow();
|
|
45
|
+
});
|
|
46
|
+
test.each([
|
|
47
|
+
'/tmp/drizzle.config.ts',
|
|
48
|
+
'../drizzle.config.ts',
|
|
49
|
+
'schema/../../drizzle.config.ts',
|
|
50
|
+
'./drizzle.config.ts',
|
|
51
|
+
'schema\\drizzle.config.ts',
|
|
52
|
+
])('rejects unsafe config path %s', (configPath) => {
|
|
53
|
+
const plan = validPlan();
|
|
54
|
+
plan.targets[0].configPath = configPath;
|
|
55
|
+
expect(() => validateClientMigrationPlan(plan)).toThrow();
|
|
56
|
+
});
|
|
57
|
+
test('supports an explicit provider target allowlist', () => {
|
|
58
|
+
const plan = validPlan();
|
|
59
|
+
plan.targets[0].id = 'tenant-east';
|
|
60
|
+
expect(validateClientMigrationPlan(plan, {
|
|
61
|
+
allowedTargetIds: ['tenant-east'],
|
|
62
|
+
}).targets[0]?.id).toBe('tenant-east');
|
|
63
|
+
});
|
|
64
|
+
test.each([
|
|
65
|
+
{ tables: { users_v2: 'users' }, unexpected: {} },
|
|
66
|
+
{ columns: { users: { display_name: 'name' } }, unexpected: {} },
|
|
67
|
+
])('rejects unknown rename-hint keys', (renameHints) => {
|
|
68
|
+
const plan = validPlan();
|
|
69
|
+
plan.targets[0].renameHints = renameHints;
|
|
70
|
+
expect(() => validateClientMigrationPlan(plan)).toThrow('unsupported fields');
|
|
71
|
+
});
|
|
72
|
+
test('rejects a flat rename-hint map', () => {
|
|
73
|
+
const plan = validPlan();
|
|
74
|
+
plan.targets[0].renameHints = {
|
|
75
|
+
users_v2: 'users',
|
|
76
|
+
};
|
|
77
|
+
expect(() => validateClientMigrationPlan(plan)).toThrow('unsupported fields');
|
|
78
|
+
});
|
|
79
|
+
test('rejects non-boolean autoCreateRenames', () => {
|
|
80
|
+
const plan = validPlan();
|
|
81
|
+
plan.targets[0].autoCreateRenames = 'yes';
|
|
82
|
+
expect(() => validateClientMigrationPlan(plan)).toThrow('autoCreateRenames must be a boolean');
|
|
83
|
+
});
|
|
84
|
+
test('rejects dialect-incompatible operations and rename behavior', () => {
|
|
85
|
+
const pgPlan = validPlan();
|
|
86
|
+
pgPlan.targets[0].dialect = 'postgresql';
|
|
87
|
+
expect(() => validateClientMigrationPlan(pgPlan)).toThrow('cannot apply d1-safety to postgresql');
|
|
88
|
+
const sqlitePlan = validPlan();
|
|
89
|
+
sqlitePlan.targets[0].postprocessors = ['append-rls'];
|
|
90
|
+
expect(() => validateClientMigrationPlan(sqlitePlan)).toThrow('cannot apply append-rls to sqlite');
|
|
91
|
+
});
|
|
92
|
+
test('rejects overlapping target output directories', () => {
|
|
93
|
+
const value = validPlan();
|
|
94
|
+
value.targets.push({
|
|
95
|
+
id: 'auth',
|
|
96
|
+
dialect: 'sqlite',
|
|
97
|
+
configPath: 'drizzle.auth.config.ts',
|
|
98
|
+
outPath: 'quickback/drizzle/features/auth',
|
|
99
|
+
postprocessors: [],
|
|
100
|
+
});
|
|
101
|
+
expect(() => validateClientMigrationPlan(value)).toThrow('outPaths may not overlap');
|
|
102
|
+
});
|
|
103
|
+
});
|
|
104
|
+
//# sourceMappingURL=plan.test.js.map
|