layerbase 1.0.0 → 1.2.0
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 +110 -4
- package/dist/cli.js +166 -3
- package/dist/cli.js.map +1 -1
- package/dist/commands/agent-init.js +112 -0
- package/dist/commands/agent-init.js.map +1 -0
- package/dist/commands/cloud-branch.js +97 -0
- package/dist/commands/cloud-branch.js.map +1 -0
- package/dist/commands/cloud-write.js +133 -0
- package/dist/commands/cloud-write.js.map +1 -0
- package/dist/commands/connection-string.js +17 -16
- package/dist/commands/connection-string.js.map +1 -1
- package/dist/commands/import.js +96 -0
- package/dist/commands/import.js.map +1 -0
- package/dist/commands/interactive.js +2 -0
- package/dist/commands/interactive.js.map +1 -1
- package/dist/commands/key-login.js +48 -0
- package/dist/commands/key-login.js.map +1 -0
- package/dist/commands/ls.js +17 -5
- package/dist/commands/ls.js.map +1 -1
- package/dist/commands/migrate.js +331 -0
- package/dist/commands/migrate.js.map +1 -0
- package/dist/commands/whoami-run.js +87 -0
- package/dist/commands/whoami-run.js.map +1 -0
- package/dist/commands/whoami.js +1 -1
- package/dist/commands/whoami.js.map +1 -1
- package/dist/lib/cli-output.js +28 -0
- package/dist/lib/cli-output.js.map +1 -0
- package/dist/lib/cloud-api.js +333 -20
- package/dist/lib/cloud-api.js.map +1 -1
- package/dist/lib/commands.js +18 -1
- package/dist/lib/commands.js.map +1 -1
- package/dist/lib/config.js +18 -0
- package/dist/lib/config.js.map +1 -1
- package/dist/lib/confirm.js +17 -0
- package/dist/lib/confirm.js.map +1 -0
- package/dist/lib/duration.js +33 -0
- package/dist/lib/duration.js.map +1 -0
- package/dist/lib/migration-catalog.js +209 -0
- package/dist/lib/migration-catalog.js.map +1 -0
- package/dist/lib/redact.js +23 -0
- package/dist/lib/redact.js.map +1 -0
- package/dist/lib/select.js +48 -0
- package/dist/lib/select.js.map +1 -0
- package/dist/ui/app.js +1 -1
- package/dist/ui/app.js.map +1 -1
- package/package.json +4 -2
- package/skills/layerbase/SKILL.md +222 -0
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
// Static catalog of the external platforms `layerbase migrate` can import FROM.
|
|
2
|
+
//
|
|
3
|
+
// MIRROR SOURCE: layerbase web `lib/cloud/migration-sources.ts`
|
|
4
|
+
// (MIGRATION_SOURCES) and the cloud adapter registry
|
|
5
|
+
// `layerbase-cloud/src/lib/migration-providers/registry.ts`. The cloud has no
|
|
6
|
+
// public "list migration sources" endpoint on /v1, so this is a hand-kept
|
|
7
|
+
// mirror. When a source is added/changed in the web MIGRATION_SOURCES, update
|
|
8
|
+
// this table to match (id, credential shape, target engines). The cloud infers
|
|
9
|
+
// connection-string providers from the URL, so paste sources send only a
|
|
10
|
+
// connection string; only api-key sources send a `provider` id, which MUST equal
|
|
11
|
+
// the cloud provider id (`apiKeyProviderId` in the web catalog).
|
|
12
|
+
export const MIGRATION_CATALOG = [
|
|
13
|
+
{
|
|
14
|
+
id: 'neon',
|
|
15
|
+
label: 'Neon',
|
|
16
|
+
kind: 'api-key',
|
|
17
|
+
provider: 'neon',
|
|
18
|
+
targetEngines: ['postgresql'],
|
|
19
|
+
credentials: {
|
|
20
|
+
sourceKey: { label: 'Neon API key', placeholder: 'napi_...' },
|
|
21
|
+
},
|
|
22
|
+
hint: 'Neon API key (Account settings, then API keys). We list your projects so you can pick one.',
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
id: 'supabase',
|
|
26
|
+
label: 'Supabase',
|
|
27
|
+
kind: 'api-key',
|
|
28
|
+
provider: 'supabase',
|
|
29
|
+
targetEngines: ['postgresql'],
|
|
30
|
+
credentials: {
|
|
31
|
+
sourceKey: { label: 'Supabase access token', placeholder: 'sbp_...' },
|
|
32
|
+
sourceSecret: { label: 'Database password' },
|
|
33
|
+
},
|
|
34
|
+
hint: 'Supabase access token (Account, then Access Tokens) plus the project database password (Supabase never exposes it through its API).',
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
id: 'render',
|
|
38
|
+
label: 'Render',
|
|
39
|
+
kind: 'api-key',
|
|
40
|
+
provider: 'render',
|
|
41
|
+
targetEngines: ['postgresql'],
|
|
42
|
+
credentials: {
|
|
43
|
+
sourceKey: { label: 'Render API key', placeholder: 'rnd_...' },
|
|
44
|
+
},
|
|
45
|
+
hint: 'Render API key (Account Settings, then API Keys). We list your Postgres instances.',
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
id: 'railway',
|
|
49
|
+
label: 'Railway',
|
|
50
|
+
kind: 'api-key',
|
|
51
|
+
provider: 'railway',
|
|
52
|
+
targetEngines: ['postgresql', 'mysql', 'redis'],
|
|
53
|
+
credentials: {
|
|
54
|
+
sourceKey: {
|
|
55
|
+
label: 'Railway account or team token',
|
|
56
|
+
placeholder: 'Railway token',
|
|
57
|
+
},
|
|
58
|
+
},
|
|
59
|
+
hint: 'Railway account or team token (Account Settings, then Tokens). The source service needs public networking enabled.',
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
id: 'postgres',
|
|
63
|
+
label: 'PostgreSQL (any)',
|
|
64
|
+
kind: 'connection-string',
|
|
65
|
+
targetEngines: ['postgresql'],
|
|
66
|
+
credentials: {
|
|
67
|
+
connectionString: {
|
|
68
|
+
label: 'PostgreSQL connection string',
|
|
69
|
+
placeholder: 'postgresql://user:password@host:5432/dbname',
|
|
70
|
+
},
|
|
71
|
+
},
|
|
72
|
+
hint: 'Paste a full PostgreSQL connection string for any provider.',
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
id: 'mysql',
|
|
76
|
+
label: 'MySQL',
|
|
77
|
+
kind: 'connection-string',
|
|
78
|
+
targetEngines: ['mysql', 'mariadb'],
|
|
79
|
+
credentials: {
|
|
80
|
+
connectionString: {
|
|
81
|
+
label: 'MySQL connection string',
|
|
82
|
+
placeholder: 'mysql://user:password@host:3306/dbname',
|
|
83
|
+
},
|
|
84
|
+
},
|
|
85
|
+
hint: 'Paste a MySQL connection string from any provider (Railway, RDS, self-hosted).',
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
id: 'mariadb',
|
|
89
|
+
label: 'MariaDB',
|
|
90
|
+
kind: 'connection-string',
|
|
91
|
+
targetEngines: ['mariadb'],
|
|
92
|
+
credentials: {
|
|
93
|
+
connectionString: {
|
|
94
|
+
label: 'MariaDB/MySQL connection string',
|
|
95
|
+
placeholder: 'mysql://user:password@host:3306/dbname',
|
|
96
|
+
},
|
|
97
|
+
},
|
|
98
|
+
hint: 'Paste a MySQL or MariaDB connection string (MariaDB is MySQL-compatible).',
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
id: 'planetscale',
|
|
102
|
+
label: 'PlanetScale',
|
|
103
|
+
kind: 'api-key',
|
|
104
|
+
provider: 'planetscale',
|
|
105
|
+
targetEngines: ['mysql', 'mariadb'],
|
|
106
|
+
credentials: {
|
|
107
|
+
sourceKey: {
|
|
108
|
+
label: 'PlanetScale service token',
|
|
109
|
+
placeholder: 'Service token',
|
|
110
|
+
},
|
|
111
|
+
sourceId: {
|
|
112
|
+
label: 'Service token ID',
|
|
113
|
+
placeholder: 'Service token ID',
|
|
114
|
+
},
|
|
115
|
+
},
|
|
116
|
+
hint: 'PlanetScale service token and its ID (Settings, then Service tokens). Needs org-level read-databases permission.',
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
id: 'upstash',
|
|
120
|
+
label: 'Upstash',
|
|
121
|
+
kind: 'api-key',
|
|
122
|
+
provider: 'upstash',
|
|
123
|
+
targetEngines: ['redis', 'valkey'],
|
|
124
|
+
credentials: {
|
|
125
|
+
sourceKey: {
|
|
126
|
+
label: 'Upstash management API key',
|
|
127
|
+
placeholder: 'Your Upstash API key',
|
|
128
|
+
},
|
|
129
|
+
sourceId: { label: 'Account email', placeholder: 'you@example.com' },
|
|
130
|
+
},
|
|
131
|
+
hint: 'Upstash account email and a management API key (Account, then Management API).',
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
id: 'vercel-kv',
|
|
135
|
+
label: 'Vercel KV',
|
|
136
|
+
kind: 'connection-string',
|
|
137
|
+
targetEngines: ['redis', 'valkey'],
|
|
138
|
+
credentials: {
|
|
139
|
+
connectionString: {
|
|
140
|
+
label: 'Vercel KV URL',
|
|
141
|
+
placeholder: 'rediss://...',
|
|
142
|
+
},
|
|
143
|
+
},
|
|
144
|
+
hint: 'Vercel KV is Upstash-backed Redis. Copy the KV_URL (a rediss:// string) from your Vercel project storage settings.',
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
id: 'redis',
|
|
148
|
+
label: 'Redis',
|
|
149
|
+
kind: 'connection-string',
|
|
150
|
+
targetEngines: ['redis', 'valkey'],
|
|
151
|
+
credentials: {
|
|
152
|
+
connectionString: {
|
|
153
|
+
label: 'Redis connection string',
|
|
154
|
+
placeholder: 'redis:// or rediss://',
|
|
155
|
+
},
|
|
156
|
+
},
|
|
157
|
+
hint: 'Paste a Redis connection string (redis:// or rediss://) from any provider.',
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
id: 'valkey',
|
|
161
|
+
label: 'Valkey',
|
|
162
|
+
kind: 'connection-string',
|
|
163
|
+
targetEngines: ['valkey'],
|
|
164
|
+
credentials: {
|
|
165
|
+
connectionString: {
|
|
166
|
+
label: 'Valkey/Redis connection string',
|
|
167
|
+
placeholder: 'redis:// or rediss://',
|
|
168
|
+
},
|
|
169
|
+
},
|
|
170
|
+
hint: 'Paste a Redis or Valkey connection string (Valkey is wire-compatible with Redis).',
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
id: 'algolia',
|
|
174
|
+
label: 'Algolia',
|
|
175
|
+
kind: 'api-key',
|
|
176
|
+
provider: 'algolia',
|
|
177
|
+
targetEngines: ['meilisearch'],
|
|
178
|
+
credentials: {
|
|
179
|
+
sourceKey: {
|
|
180
|
+
label: 'Algolia Admin API key',
|
|
181
|
+
placeholder: 'Admin API key',
|
|
182
|
+
},
|
|
183
|
+
sourceId: { label: 'Application ID', placeholder: 'Application ID' },
|
|
184
|
+
},
|
|
185
|
+
hint: 'Algolia Application ID and an Admin API key (Settings, then API Keys). A Search-only key will not work.',
|
|
186
|
+
},
|
|
187
|
+
{
|
|
188
|
+
id: 'turso',
|
|
189
|
+
label: 'Turso',
|
|
190
|
+
kind: 'api-key',
|
|
191
|
+
provider: 'turso',
|
|
192
|
+
targetEngines: ['libsql'],
|
|
193
|
+
credentials: {
|
|
194
|
+
sourceKey: { label: 'Auth token', placeholder: 'Auth token' },
|
|
195
|
+
sourceId: {
|
|
196
|
+
label: 'Database URL',
|
|
197
|
+
placeholder: 'libsql://...',
|
|
198
|
+
},
|
|
199
|
+
},
|
|
200
|
+
hint: 'Turso database URL (libsql://... from `turso db show <db> --url`) and an auth token (`turso db tokens create <db>`).',
|
|
201
|
+
},
|
|
202
|
+
];
|
|
203
|
+
export function getCatalogSource(id) {
|
|
204
|
+
return MIGRATION_CATALOG.find((s) => s.id === id);
|
|
205
|
+
}
|
|
206
|
+
export function catalogSourceIds() {
|
|
207
|
+
return MIGRATION_CATALOG.map((s) => s.id);
|
|
208
|
+
}
|
|
209
|
+
//# sourceMappingURL=migration-catalog.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"migration-catalog.js","sourceRoot":"","sources":["../../src/lib/migration-catalog.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
// Credential redaction for anything the CLI prints (error text, --json output).
|
|
2
|
+
// Migration flows carry source connection strings + provider API keys; none of
|
|
3
|
+
// them may ever land in stdout/stderr. The cloud already redacts its own error
|
|
4
|
+
// messages (see redactConnStrings in layerbase-cloud), so this is a CLI-side
|
|
5
|
+
// backstop: strip any known secret value AND any connection-string-shaped token
|
|
6
|
+
// before writing a message.
|
|
7
|
+
// Replace each provided secret value (a pasted key, token, password, or
|
|
8
|
+
// connection string) with a placeholder, then blanket-redact any remaining
|
|
9
|
+
// connection-string-shaped substrings. Empty/whitespace secrets are ignored so
|
|
10
|
+
// an empty flag never turns into a `[redacted]` that eats real text.
|
|
11
|
+
export function redactSecrets(text, secrets) {
|
|
12
|
+
let out = text;
|
|
13
|
+
for (const secret of secrets) {
|
|
14
|
+
const trimmed = secret.trim();
|
|
15
|
+
if (trimmed.length < 4)
|
|
16
|
+
continue;
|
|
17
|
+
out = out.split(trimmed).join('[redacted]');
|
|
18
|
+
}
|
|
19
|
+
return out
|
|
20
|
+
.replace(/\b(?:postgres(?:ql)?|mysql|rediss?|libsql):\/\/\S+/gi, '[redacted connection string]')
|
|
21
|
+
.replace(/Bearer\s+[A-Za-z0-9._-]+/gi, 'Bearer [redacted]');
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=redact.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/lib/redact.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,4BAA4B;AAE5B,wEAAwE;AACxE,2EAA2E;AAC3E,+EAA+E;AAC/E,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAiB;IAC3D,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,SAAQ;QAChC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,GAAG;SACP,OAAO,CACN,sDAAsD,EACtD,8BAA8B,CAC/B;SACA,OAAO,CAAC,4BAA4B,EAAE,mBAAmB,CAAC,CAAA;AAC/D,CAAC"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { createInterface } from 'node:readline';
|
|
2
|
+
// A minimal numbered-choice prompt for interactive CLI selection (source /
|
|
3
|
+
// target picking). TTY-only: callers MUST gate on process.stdin.isTTY and
|
|
4
|
+
// require an explicit flag in non-TTY contexts so a script never blocks on a
|
|
5
|
+
// prompt. Returns the chosen item, or undefined when the input is empty or out
|
|
6
|
+
// of range (the caller treats that as an abort). Kept readline-based to match
|
|
7
|
+
// confirm.ts rather than pulling the async cloud flows into Ink.
|
|
8
|
+
export async function selectFromList(options) {
|
|
9
|
+
const { title, items, render } = options;
|
|
10
|
+
if (items.length === 0)
|
|
11
|
+
return undefined;
|
|
12
|
+
if (items.length === 1)
|
|
13
|
+
return items[0];
|
|
14
|
+
process.stdout.write(`${title}\n`);
|
|
15
|
+
items.forEach((item, i) => {
|
|
16
|
+
process.stdout.write(` ${i + 1}) ${render(item)}\n`);
|
|
17
|
+
});
|
|
18
|
+
const rl = createInterface({ input: process.stdin, output: process.stdout });
|
|
19
|
+
try {
|
|
20
|
+
const answer = await new Promise((resolve) => {
|
|
21
|
+
rl.question(`Choose 1-${items.length}: `, resolve);
|
|
22
|
+
});
|
|
23
|
+
const index = Number(answer.trim());
|
|
24
|
+
if (!Number.isInteger(index) || index < 1 || index > items.length) {
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
return items[index - 1];
|
|
28
|
+
}
|
|
29
|
+
finally {
|
|
30
|
+
rl.close();
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
// A single free-text line prompt (used to collect a credential or connection
|
|
34
|
+
// string interactively). TTY-only, same contract as selectFromList. Returns the
|
|
35
|
+
// trimmed input, or '' when empty.
|
|
36
|
+
export async function promptLine(question) {
|
|
37
|
+
const rl = createInterface({ input: process.stdin, output: process.stdout });
|
|
38
|
+
try {
|
|
39
|
+
const answer = await new Promise((resolve) => {
|
|
40
|
+
rl.question(`${question}: `, resolve);
|
|
41
|
+
});
|
|
42
|
+
return answer.trim();
|
|
43
|
+
}
|
|
44
|
+
finally {
|
|
45
|
+
rl.close();
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=select.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/lib/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,OAIvC;IACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IAEvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;IAClC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACnD,EAAE,CAAC,QAAQ,CAAC,YAAY,KAAK,CAAC,MAAM,IAAI,EAAE,OAAO,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAClE,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IACzB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,gFAAgF;AAChF,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACnD,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC"}
|
package/dist/ui/app.js
CHANGED
|
@@ -19,7 +19,7 @@ export function App({ command, args, flags }) {
|
|
|
19
19
|
case 'alias':
|
|
20
20
|
return _jsx(Alias, {});
|
|
21
21
|
case 'connection-string':
|
|
22
|
-
return _jsx(ConnectionString, { dbRef: args[0] });
|
|
22
|
+
return _jsx(ConnectionString, { dbRef: args[0], json: flags.json ?? false });
|
|
23
23
|
default:
|
|
24
24
|
return _jsx(Unknown, { command: command });
|
|
25
25
|
}
|
package/dist/ui/app.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/ui/app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;
|
|
1
|
+
{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/ui/app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAqCtC,MAAM,UAAU,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAY;IACpD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,KAAC,KAAK,IAAC,KAAK,EAAE,KAAK,GAAI,CAAA;QAChC,KAAK,QAAQ;YACX,OAAO,KAAC,MAAM,KAAG,CAAA;QACnB,KAAK,IAAI;YACP,OAAO,KAAC,IAAI,IAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,GAAI,CAAA;QAC5C,KAAK,QAAQ;YACX,OAAO,KAAC,MAAM,IAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,GAAI,CAAA;QAC9C,KAAK,OAAO;YACV,OAAO,KAAC,KAAK,KAAG,CAAA;QAClB,KAAK,mBAAmB;YACtB,OAAO,KAAC,gBAAgB,IAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,GAAI,CAAA;QACxE;YACE,OAAO,KAAC,OAAO,IAAC,OAAO,EAAE,OAAO,GAAI,CAAA;IACxC,CAAC;AACH,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "layerbase",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Layerbase cloud CLI: connect to your managed databases without leaking the connection string into shell history.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
"lbase": "dist/cli.js"
|
|
9
9
|
},
|
|
10
10
|
"files": [
|
|
11
|
-
"dist"
|
|
11
|
+
"dist",
|
|
12
|
+
"skills"
|
|
12
13
|
],
|
|
13
14
|
"engines": {
|
|
14
15
|
"node": ">=20"
|
|
@@ -25,6 +26,7 @@
|
|
|
25
26
|
"lint": "eslint .",
|
|
26
27
|
"check:types": "tsc --noEmit",
|
|
27
28
|
"check:collisions": "tsx scripts/check-spindb-collisions.ts",
|
|
29
|
+
"test": "node --import tsx --test test/*.test.ts",
|
|
28
30
|
"check": "tsc --noEmit && eslint . && pnpm check:collisions",
|
|
29
31
|
"prepack": "pnpm build"
|
|
30
32
|
},
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
Canonical source: https://layerbase.com/skill.md (always current).
|
|
3
|
+
This bundled copy is the offline fallback used by `layerbase agent init`
|
|
4
|
+
when the canonical URL cannot be fetched. Prefer the URL; this may lag.
|
|
5
|
+
-->
|
|
6
|
+
---
|
|
7
|
+
name: layerbase
|
|
8
|
+
description: Advise on, manage, and migrate to Layerbase managed cloud databases; audit a codebase for database, cache, and search providers Layerbase can replace, then quote live pricing and propose migration paths.
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Layerbase
|
|
12
|
+
|
|
13
|
+
Layerbase runs managed cloud databases across many engines (SQL, key-value,
|
|
14
|
+
document, search, vector, time-series, graph, and ledger) with scale-to-zero:
|
|
15
|
+
databases sleep when idle and wake on connect. There is a REST API, an official
|
|
16
|
+
`layerbase` npm CLI, a desktop app, and a migration engine that imports from
|
|
17
|
+
common hosted providers. This skill helps you advise on Layerbase, set it up for
|
|
18
|
+
a project, audit an existing codebase for services Layerbase can consolidate, and
|
|
19
|
+
run migrations.
|
|
20
|
+
|
|
21
|
+
## 1. First rule: never quote facts from memory
|
|
22
|
+
|
|
23
|
+
Before you state ANY price, plan limit, engine name, migration source, or
|
|
24
|
+
capability, fetch the live capability document:
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
https://layerbase.com/agents.md
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
It is plain markdown, generated from Layerbase's own source of truth, so it never
|
|
31
|
+
drifts. It carries the current plan tiers and prices, per-plan database limits,
|
|
32
|
+
the full engine list with categories, which engines are branchable, the
|
|
33
|
+
migration sources and their target engines, the hostable apps, and the API/CLI
|
|
34
|
+
auth story. Treat it as the single source of truth. If you cannot reach it, say
|
|
35
|
+
so plainly and point the user at https://layerbase.com/pricing and
|
|
36
|
+
https://layerbase.com/docs rather than guessing a number.
|
|
37
|
+
|
|
38
|
+
Do not invent numbers, benchmarks, or comparisons. Do not disparage other
|
|
39
|
+
providers. When you make a claim, cite the Layerbase page it comes from.
|
|
40
|
+
|
|
41
|
+
## 2. Answering capability questions
|
|
42
|
+
|
|
43
|
+
For any "does Layerbase support X" question (engines, branching, backups, apps,
|
|
44
|
+
plans, always-on, mTLS, teams), read the answer from `agents.md` and link the
|
|
45
|
+
relevant docs page rather than reciting details:
|
|
46
|
+
|
|
47
|
+
- Engines, categories, versions: `agents.md` plus https://layerbase.com/docs/api
|
|
48
|
+
(`GET /v1/engines` is the machine-readable registry).
|
|
49
|
+
- Branching (copy-on-write branches per database): the branchable-engine list is
|
|
50
|
+
in `agents.md`; guide at https://layerbase.com/docs/cloud/branching.
|
|
51
|
+
- Backups and retention: https://layerbase.com/docs/cloud/backups.
|
|
52
|
+
- Lifecycle (sleep, wake, archive, restore): https://layerbase.com/docs/database-lifecycle.
|
|
53
|
+
- Plans and pricing: `agents.md` plus https://layerbase.com/pricing.
|
|
54
|
+
- Hostable apps (for example session replay, secret store): `agents.md` plus
|
|
55
|
+
https://layerbase.com/apps.
|
|
56
|
+
|
|
57
|
+
If a question is not covered, say you are not certain and link
|
|
58
|
+
https://layerbase.com/docs instead of speculating.
|
|
59
|
+
|
|
60
|
+
## 3. Audit a codebase for services Layerbase can replace
|
|
61
|
+
|
|
62
|
+
When the user asks you to review a project for what Layerbase could host, or when
|
|
63
|
+
you are already working in a repo that uses hosted data services, run this audit.
|
|
64
|
+
The goal is an honest map of current providers to Layerbase engines, not a hard
|
|
65
|
+
sell.
|
|
66
|
+
|
|
67
|
+
### 3a. Scan dependencies
|
|
68
|
+
|
|
69
|
+
Read the package manifests and lockfiles (`package.json`, `pnpm-lock.yaml`,
|
|
70
|
+
`package-lock.json`, `yarn.lock`, and non-JS equivalents like
|
|
71
|
+
`requirements.txt`, `pyproject.toml`, `go.mod`, `Gemfile`). Flag provider SDKs
|
|
72
|
+
and drivers:
|
|
73
|
+
|
|
74
|
+
- `@neondatabase/serverless`, `@neondatabase/*` -> Neon (Postgres)
|
|
75
|
+
- `@supabase/supabase-js`, `@supabase/*` -> Supabase (Postgres)
|
|
76
|
+
- `@planetscale/database` -> PlanetScale (MySQL)
|
|
77
|
+
- `@upstash/redis`, `@upstash/*` -> Upstash (Redis)
|
|
78
|
+
- `@vercel/kv` -> Vercel KV (Upstash-backed Redis)
|
|
79
|
+
- `@libsql/client`, `libsql` -> Turso / libSQL
|
|
80
|
+
- `algoliasearch` -> Algolia (search)
|
|
81
|
+
- `meilisearch` -> Meilisearch (search; Layerbase hosts this natively)
|
|
82
|
+
- Generic drivers that imply a hosted database: `pg`, `postgres`, `mysql2`,
|
|
83
|
+
`mariadb`, `ioredis`, `redis`, `mongodb`, `@clickhouse/client`
|
|
84
|
+
|
|
85
|
+
A generic driver alone does not prove a hosted provider; confirm with the
|
|
86
|
+
connection target in 3b before mapping it.
|
|
87
|
+
|
|
88
|
+
### 3b. Scan environment and CI config
|
|
89
|
+
|
|
90
|
+
Read `.env`, `.env.example`, `.env.local`, and CI/deploy config (GitHub Actions
|
|
91
|
+
workflows, `vercel.json`, Dockerfiles, `docker-compose.yml`, Terraform). Never
|
|
92
|
+
print secret values back to the user; reference variable NAMES only. Flag:
|
|
93
|
+
|
|
94
|
+
- Env prefixes: `NEON_`, `SUPABASE_`, `PLANETSCALE_`, `UPSTASH_`, `ALGOLIA_`,
|
|
95
|
+
`TURSO_`, `KV_` (Vercel KV), `REDIS_`, `MONGODB_`, `CLICKHOUSE_`
|
|
96
|
+
- `DATABASE_URL` / connection-string hostnames that name a provider, for
|
|
97
|
+
example `*.neon.tech`, `*.supabase.co` / `*.pooler.supabase.com`,
|
|
98
|
+
`*.psdb.cloud` (PlanetScale), `*.upstash.io`, `*.turso.io` /
|
|
99
|
+
`*.turso.tech`, `rediss://` hosts
|
|
100
|
+
|
|
101
|
+
### 3c. Map findings to Layerbase engines and migration sources
|
|
102
|
+
|
|
103
|
+
Match each discovered provider to the Layerbase engine that replaces it and the
|
|
104
|
+
migration source that moves the data. Confirm the exact engine names, target
|
|
105
|
+
engines, and which sources exist against `agents.md` (the migration source list
|
|
106
|
+
lives there); do not assume a source exists that `agents.md` does not list. The
|
|
107
|
+
common mappings are:
|
|
108
|
+
|
|
109
|
+
- Neon, Supabase, Render, Railway, or any Postgres URL -> Layerbase PostgreSQL
|
|
110
|
+
- PlanetScale or any MySQL/MariaDB URL -> Layerbase MySQL or MariaDB
|
|
111
|
+
- Upstash, Vercel KV, or any Redis URL -> Layerbase Redis or Valkey (queue
|
|
112
|
+
workloads land on Valkey)
|
|
113
|
+
- Algolia -> Layerbase Meilisearch (the migration translates indexes, settings,
|
|
114
|
+
ranking, faceting, and synonyms)
|
|
115
|
+
- Turso -> Layerbase libSQL
|
|
116
|
+
|
|
117
|
+
### 3d. Ask before you claim savings
|
|
118
|
+
|
|
119
|
+
Do NOT assert a dollar figure or "cheaper" claim. Instead, tell the user what you
|
|
120
|
+
found and ask what they pay:
|
|
121
|
+
|
|
122
|
+
> I see Neon (Postgres) and Upstash (Redis) in this project. Layerbase can host
|
|
123
|
+
> both on one plan. What are you paying each provider per month? I can pull
|
|
124
|
+
> current Layerbase pricing from https://layerbase.com/agents.md and compare
|
|
125
|
+
> honestly.
|
|
126
|
+
|
|
127
|
+
Only compare against numbers the user gives you and prices you fetched from
|
|
128
|
+
`agents.md`. If Layerbase is not clearly better for their case, say so.
|
|
129
|
+
|
|
130
|
+
### 3e. Recommend a plan honestly
|
|
131
|
+
|
|
132
|
+
Read the current tiers and limits from `agents.md`, then recommend candidly:
|
|
133
|
+
|
|
134
|
+
- The Free plan is a try-out tier: a small number of databases that sleep when
|
|
135
|
+
idle and wake on connect. It is good for prototypes, learning, and CI, but it
|
|
136
|
+
is NOT suited to always-on production traffic. Say this plainly.
|
|
137
|
+
- The Solo plan is the single-database tier for one always-on side project.
|
|
138
|
+
- The Pro plan adds more databases, always-on eligibility, and the reserved pool;
|
|
139
|
+
it is the tier for hosting a real stack (for example Postgres plus a cache plus
|
|
140
|
+
search together).
|
|
141
|
+
- The Custom tier is Pro on the user's own dedicated servers.
|
|
142
|
+
|
|
143
|
+
When Layerbase is not the right fit (a workload needing an engine Layerbase does
|
|
144
|
+
not host, a compliance constraint it does not meet, or an existing setup that is
|
|
145
|
+
serving them well), say so rather than pushing a migration.
|
|
146
|
+
|
|
147
|
+
### 3f. Offer concrete next steps
|
|
148
|
+
|
|
149
|
+
- Today, migrations run from the web flow at
|
|
150
|
+
https://layerbase.com/cloud/create/from-source (pick the source, paste
|
|
151
|
+
credentials, Layerbase reads the source once and never modifies it).
|
|
152
|
+
- A `layerbase migrate` CLI command is planned; if it is available in the
|
|
153
|
+
installed CLI version, prefer it for a terminal-only flow. Verify with
|
|
154
|
+
`layerbase --help` before recommending it.
|
|
155
|
+
- For a fresh database, `POST /v1/databases` or `layerbase cloud create` (see
|
|
156
|
+
section 4).
|
|
157
|
+
|
|
158
|
+
## 4. CI/CD setup
|
|
159
|
+
|
|
160
|
+
Layerbase fits CI pipelines that need a real, isolated database per run. Set it
|
|
161
|
+
up like this:
|
|
162
|
+
|
|
163
|
+
1. Create a personal API key: in the cloud dashboard, open
|
|
164
|
+
https://layerbase.com/cloud/settings, create a key under Personal API keys,
|
|
165
|
+
and copy the `sk_` secret (shown once).
|
|
166
|
+
2. Store it as a repository secret named `LAYERBASE_API_KEY` (GitHub: Settings
|
|
167
|
+
-> Secrets and variables -> Actions).
|
|
168
|
+
3. In the pipeline, authenticate with the key. The CLI reads `LAYERBASE_API_KEY`
|
|
169
|
+
from the environment (no browser login needed), and the REST API takes it as
|
|
170
|
+
`Authorization: Bearer sk_...`. The API base is
|
|
171
|
+
https://cloud.layerbase.dev unless overridden.
|
|
172
|
+
4. Create a transient database with a TTL so a crashed run cannot strand it:
|
|
173
|
+
`layerbase cloud create <name> --engine postgresql --ttl 2h --json` (or
|
|
174
|
+
`POST /v1/databases` with a `ttlHours` field). TTL is capped at 72 hours. A
|
|
175
|
+
transient database still counts against your plan's database limit while it
|
|
176
|
+
is alive, and self-destructs at expiry.
|
|
177
|
+
5. Seed via the printed connection string, run tests, then delete explicitly
|
|
178
|
+
(`layerbase cloud delete <name>`), letting the TTL be the safety net.
|
|
179
|
+
|
|
180
|
+
Prefer branch-per-PR where the engine supports branching: branch from a seeded
|
|
181
|
+
parent for an instant seeded copy, reset between runs, and delete on teardown.
|
|
182
|
+
Check `agents.md` for the branchable-engine list.
|
|
183
|
+
|
|
184
|
+
Programmatic (API-key) database creates are metered per calendar month, per
|
|
185
|
+
plan; dashboard creates are not metered. When you hit the limit the API returns
|
|
186
|
+
`429` with a `programmatic_create_limit_reached` code carrying `used`, `limit`,
|
|
187
|
+
`resetsAt`, and an upgrade hint. Handle it gracefully: reuse an existing database
|
|
188
|
+
or a branch instead of creating a new one, back off until `resetsAt`, and tell
|
|
189
|
+
the user the limit was reached rather than retrying in a tight loop. The exact
|
|
190
|
+
per-plan numbers are metered per plan; read them from `agents.md` or
|
|
191
|
+
https://layerbase.com/docs/api rather than hardcoding them.
|
|
192
|
+
|
|
193
|
+
Example GitHub Actions step:
|
|
194
|
+
|
|
195
|
+
```yaml
|
|
196
|
+
- name: Provision a transient test database
|
|
197
|
+
env:
|
|
198
|
+
LAYERBASE_API_KEY: ${{ secrets.LAYERBASE_API_KEY }}
|
|
199
|
+
run: |
|
|
200
|
+
npm i -g layerbase
|
|
201
|
+
layerbase cloud create ci-$GITHUB_RUN_ID --engine postgresql --ttl 2h --json
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## 5. Hostable apps
|
|
205
|
+
|
|
206
|
+
Beyond databases, Layerbase can host first-party app workloads backed by managed
|
|
207
|
+
storage. The current catalog (for example session replay and a secret store) and
|
|
208
|
+
each app's description are in `agents.md`; the marketing overview is at
|
|
209
|
+
https://layerbase.com/apps. App availability can be plan-gated, so confirm the
|
|
210
|
+
user's plan covers the app before promising it, and check `agents.md` for the
|
|
211
|
+
included tiers.
|
|
212
|
+
|
|
213
|
+
## 6. Conduct rules
|
|
214
|
+
|
|
215
|
+
- Fetch `agents.md` before stating any price, limit, or capability. Never quote a
|
|
216
|
+
number from memory.
|
|
217
|
+
- Do not invent numbers, benchmarks, or performance comparisons.
|
|
218
|
+
- Do not disparage competing providers. State facts and let the user decide.
|
|
219
|
+
- Cite the Layerbase page behind any claim (pricing, docs, or the capability
|
|
220
|
+
endpoint).
|
|
221
|
+
- Ask what the user currently pays before framing Layerbase as cheaper.
|
|
222
|
+
- Recommend against migrating when that is the honest answer.
|