layerbase 1.0.0 → 1.2.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.
Files changed (49) hide show
  1. package/README.md +110 -4
  2. package/dist/cli.js +166 -3
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/agent-init.js +112 -0
  5. package/dist/commands/agent-init.js.map +1 -0
  6. package/dist/commands/cloud-branch.js +97 -0
  7. package/dist/commands/cloud-branch.js.map +1 -0
  8. package/dist/commands/cloud-write.js +133 -0
  9. package/dist/commands/cloud-write.js.map +1 -0
  10. package/dist/commands/connection-string.js +17 -16
  11. package/dist/commands/connection-string.js.map +1 -1
  12. package/dist/commands/import.js +96 -0
  13. package/dist/commands/import.js.map +1 -0
  14. package/dist/commands/interactive.js +2 -0
  15. package/dist/commands/interactive.js.map +1 -1
  16. package/dist/commands/key-login.js +48 -0
  17. package/dist/commands/key-login.js.map +1 -0
  18. package/dist/commands/login.js +9 -2
  19. package/dist/commands/login.js.map +1 -1
  20. package/dist/commands/ls.js +17 -5
  21. package/dist/commands/ls.js.map +1 -1
  22. package/dist/commands/migrate.js +331 -0
  23. package/dist/commands/migrate.js.map +1 -0
  24. package/dist/commands/whoami-run.js +87 -0
  25. package/dist/commands/whoami-run.js.map +1 -0
  26. package/dist/commands/whoami.js +1 -1
  27. package/dist/commands/whoami.js.map +1 -1
  28. package/dist/lib/cli-output.js +28 -0
  29. package/dist/lib/cli-output.js.map +1 -0
  30. package/dist/lib/cloud-api.js +333 -20
  31. package/dist/lib/cloud-api.js.map +1 -1
  32. package/dist/lib/commands.js +18 -1
  33. package/dist/lib/commands.js.map +1 -1
  34. package/dist/lib/config.js +23 -0
  35. package/dist/lib/config.js.map +1 -1
  36. package/dist/lib/confirm.js +17 -0
  37. package/dist/lib/confirm.js.map +1 -0
  38. package/dist/lib/duration.js +33 -0
  39. package/dist/lib/duration.js.map +1 -0
  40. package/dist/lib/migration-catalog.js +209 -0
  41. package/dist/lib/migration-catalog.js.map +1 -0
  42. package/dist/lib/redact.js +23 -0
  43. package/dist/lib/redact.js.map +1 -0
  44. package/dist/lib/select.js +48 -0
  45. package/dist/lib/select.js.map +1 -0
  46. package/dist/ui/app.js +1 -1
  47. package/dist/ui/app.js.map +1 -1
  48. package/package.json +4 -2
  49. 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
  }
@@ -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;AActC,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,GAAI,CAAA;QAC7C;YACE,OAAO,KAAC,OAAO,IAAC,OAAO,EAAE,OAAO,GAAI,CAAA;IACxC,CAAC;AACH,CAAC"}
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.0.0",
3
+ "version": "1.2.1",
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.