@quickback-dev/cli 0.50.1 → 0.50.2

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 (37) hide show
  1. package/dist/commands/canary.d.ts +23 -0
  2. package/dist/commands/canary.d.ts.map +1 -0
  3. package/dist/commands/canary.js +138 -0
  4. package/dist/commands/canary.js.map +1 -0
  5. package/dist/docs/content.js +2 -2
  6. package/dist/docs/content.js.map +1 -1
  7. package/dist/index.js +7 -1
  8. package/dist/index.js.map +1 -1
  9. package/dist/lib/neon-canary.d.ts +65 -0
  10. package/dist/lib/neon-canary.d.ts.map +1 -0
  11. package/dist/lib/neon-canary.js +113 -0
  12. package/dist/lib/neon-canary.js.map +1 -0
  13. package/dist/lib/neon-canary.test.d.ts +2 -0
  14. package/dist/lib/neon-canary.test.d.ts.map +1 -0
  15. package/dist/lib/neon-canary.test.js +150 -0
  16. package/dist/lib/neon-canary.test.js.map +1 -0
  17. package/dist/lib/neon-target.d.ts +89 -0
  18. package/dist/lib/neon-target.d.ts.map +1 -0
  19. package/dist/lib/neon-target.js +68 -0
  20. package/dist/lib/neon-target.js.map +1 -0
  21. package/dist/lib/neon-target.test.d.ts +2 -0
  22. package/dist/lib/neon-target.test.d.ts.map +1 -0
  23. package/dist/lib/neon-target.test.js +100 -0
  24. package/dist/lib/neon-target.test.js.map +1 -0
  25. package/dist/lib/neon.d.ts +152 -0
  26. package/dist/lib/neon.d.ts.map +1 -0
  27. package/dist/lib/neon.js +171 -0
  28. package/dist/lib/neon.js.map +1 -0
  29. package/dist/lib/neon.test.d.ts +2 -0
  30. package/dist/lib/neon.test.d.ts.map +1 -0
  31. package/dist/lib/neon.test.js +154 -0
  32. package/dist/lib/neon.test.js.map +1 -0
  33. package/dist/skill/docs/changelog.md +26 -0
  34. package/dist/skill/docs/compiler/targets/hono-api/database/neon.md +85 -19
  35. package/package.json +1 -1
  36. package/src/skill/docs/changelog.md +26 -0
  37. package/src/skill/docs/compiler/targets/hono-api/database/neon.md +85 -19
@@ -0,0 +1,100 @@
1
+ /**
2
+ * resolveNeonTarget — the env → Neon branch/project seam.
3
+ *
4
+ * The key behavior-preserving guarantee: resolution returns `null` (never
5
+ * throws) whenever branching isn't fully configured, so the deploy path is
6
+ * unchanged for projects that haven't opted in.
7
+ */
8
+ import { describe, expect, test } from 'bun:test';
9
+ import { resolveNeonTarget, canaryBranchName } from './neon-target.js';
10
+ const config = {
11
+ name: 'app',
12
+ preset: 'cloudflare',
13
+ neon: { projectId: 'proj-from-config', role: 'quickback', database: 'appdb' },
14
+ providers: {
15
+ database: {
16
+ environments: {
17
+ production: { branch: 'production' },
18
+ staging: { branch: 'staging-main' },
19
+ local: {}, // present but no branch → not configured
20
+ },
21
+ },
22
+ },
23
+ };
24
+ describe('resolveNeonTarget', () => {
25
+ test('resolves a mapped env with NEON_API_KEY + NEON_PROJECT_ID from env', () => {
26
+ const target = resolveNeonTarget({
27
+ env: 'production',
28
+ config,
29
+ processEnv: { NEON_API_KEY: 'key', NEON_PROJECT_ID: 'proj-env' },
30
+ });
31
+ expect(target).not.toBeNull();
32
+ expect(target.projectId).toBe('proj-env'); // env wins over config
33
+ expect(target.apiKey).toBe('key');
34
+ expect(target.parentBranch).toBe('production');
35
+ expect(target.role).toBe('quickback');
36
+ expect(target.database).toBe('appdb');
37
+ });
38
+ test('falls back to config.neon.projectId when NEON_PROJECT_ID unset', () => {
39
+ const target = resolveNeonTarget({
40
+ env: 'staging',
41
+ config,
42
+ processEnv: { NEON_API_KEY: 'key' },
43
+ });
44
+ expect(target.projectId).toBe('proj-from-config');
45
+ expect(target.parentBranch).toBe('staging-main');
46
+ });
47
+ test('null when env is not mapped to a neonBranch', () => {
48
+ expect(resolveNeonTarget({ env: 'local', config, processEnv: { NEON_API_KEY: 'key', NEON_PROJECT_ID: 'p' } })).toBeNull();
49
+ expect(resolveNeonTarget({ env: 'unknown', config, processEnv: { NEON_API_KEY: 'key', NEON_PROJECT_ID: 'p' } })).toBeNull();
50
+ });
51
+ test('null when NEON_API_KEY is missing (never throws)', () => {
52
+ expect(resolveNeonTarget({ env: 'production', config, processEnv: { NEON_PROJECT_ID: 'p' } })).toBeNull();
53
+ });
54
+ test('null when no project id available anywhere', () => {
55
+ const noProject = { ...config, neon: {} };
56
+ expect(resolveNeonTarget({ env: 'production', config: noProject, processEnv: { NEON_API_KEY: 'key' } })).toBeNull();
57
+ });
58
+ test('null when environments block is absent entirely', () => {
59
+ expect(resolveNeonTarget({ env: 'production', config: { name: 'x', preset: 'cloudflare' }, processEnv: { NEON_API_KEY: 'k', NEON_PROJECT_ID: 'p' } })).toBeNull();
60
+ });
61
+ test('null for the split-services database form ({ auth, features }, no environments)', () => {
62
+ const splitConfig = {
63
+ name: 'app',
64
+ preset: 'cloudflare',
65
+ neon: { projectId: 'proj-from-config' },
66
+ providers: { database: { auth: { name: 'neon' }, features: { name: 'neon' } } },
67
+ };
68
+ expect(resolveNeonTarget({ env: 'production', config: splitConfig, processEnv: { NEON_API_KEY: 'k', NEON_PROJECT_ID: 'p' } })).toBeNull();
69
+ });
70
+ test('null when providers.database has no environments map', () => {
71
+ const noEnvs = {
72
+ name: 'app',
73
+ preset: 'cloudflare',
74
+ neon: { projectId: 'p' },
75
+ providers: { database: { name: 'neon' } },
76
+ };
77
+ expect(resolveNeonTarget({ env: 'production', config: noEnvs, processEnv: { NEON_API_KEY: 'k', NEON_PROJECT_ID: 'p' } })).toBeNull();
78
+ });
79
+ test('passes through NEON_API_BASE override', () => {
80
+ const target = resolveNeonTarget({
81
+ env: 'production',
82
+ config,
83
+ processEnv: { NEON_API_KEY: 'key', NEON_PROJECT_ID: 'p', NEON_API_BASE: 'https://api.neon.tech/api/v2' },
84
+ });
85
+ expect(target.baseUrl).toBe('https://api.neon.tech/api/v2');
86
+ });
87
+ });
88
+ describe('canaryBranchName', () => {
89
+ test('is env-scoped, prefixed, and timestamped', () => {
90
+ const name = canaryBranchName('production', new Date('2026-07-10T12:34:56.789Z'));
91
+ expect(name.startsWith('quickback-canary/production/')).toBe(true);
92
+ expect(name).not.toContain(':'); // filesystem/URL-safe
93
+ });
94
+ test('distinct envs produce distinct prefixes', () => {
95
+ const a = canaryBranchName('production', new Date('2026-07-10T00:00:00Z'));
96
+ const b = canaryBranchName('staging', new Date('2026-07-10T00:00:00Z'));
97
+ expect(a).not.toBe(b);
98
+ });
99
+ });
100
+ //# sourceMappingURL=neon-target.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neon-target.test.js","sourceRoot":"","sources":["../../src/lib/neon-target.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,152 @@
1
+ /**
2
+ * Neon API Client
3
+ *
4
+ * A thin, dependency-free wrapper over the Neon REST API (v2) covering the
5
+ * branch-canary orchestration surface: create a copy-on-write branch, resolve
6
+ * a branch's connection string, diff a branch's schema against its parent, and
7
+ * delete the branch.
8
+ *
9
+ * The underlying HTTP transport is INJECTABLE (`fetch`) so the canary
10
+ * orchestration can be unit-tested with a mocked Neon — no live token, no
11
+ * network. In production the global `fetch` is used.
12
+ *
13
+ * API reference: https://api-docs.neon.tech/reference/getting-started-with-neon-api
14
+ * Auth: `Authorization: Bearer <NEON_API_KEY>`.
15
+ */
16
+ /**
17
+ * The subset of the global `fetch` contract this client relies on. Typing it
18
+ * as `typeof fetch` lets production pass the real global unchanged while tests
19
+ * hand in a stub that returns ordinary `Response` objects.
20
+ */
21
+ export type FetchLike = typeof fetch;
22
+ /**
23
+ * Neon's default REST base. Override via `NEON_API_BASE` (or the constructor)
24
+ * for Neon-compatible proxies or a future host. Both `console.neon.tech` and
25
+ * `api.neon.tech` front the same v2 API; `console.neon.tech` is the one the
26
+ * public docs curl against, so it's the default.
27
+ */
28
+ export declare const DEFAULT_NEON_API_BASE = "https://console.neon.tech/api/v2";
29
+ export interface NeonClientOptions {
30
+ apiKey: string;
31
+ projectId: string;
32
+ /** Injectable HTTP transport. Defaults to the global `fetch`. */
33
+ fetch?: FetchLike;
34
+ /** REST base URL. Defaults to {@link DEFAULT_NEON_API_BASE}. */
35
+ baseUrl?: string;
36
+ }
37
+ /** A Neon branch as returned by the branches endpoints (fields we consume). */
38
+ export interface NeonBranch {
39
+ id: string;
40
+ project_id: string;
41
+ parent_id?: string;
42
+ name: string;
43
+ current_state?: string;
44
+ created_at?: string;
45
+ }
46
+ /** An endpoint (compute) attached to a branch. */
47
+ export interface NeonEndpoint {
48
+ id: string;
49
+ branch_id: string;
50
+ host: string;
51
+ type: string;
52
+ }
53
+ export interface CreateBranchResult {
54
+ branchId: string;
55
+ branch: NeonBranch;
56
+ endpoints: NeonEndpoint[];
57
+ /**
58
+ * Connection URIs Neon minted alongside the branch. Present only when the
59
+ * create request asked for an endpoint; each entry is a ready-to-use
60
+ * `postgresql://…` string for one (role, database) pair.
61
+ */
62
+ connectionUris: Array<{
63
+ connection_uri: string;
64
+ connection_parameters?: Record<string, unknown>;
65
+ }>;
66
+ }
67
+ export interface CreateBranchParams {
68
+ /** Human/CI-friendly branch name (e.g. `canary/production-1720…`). */
69
+ name: string;
70
+ /**
71
+ * Parent branch to fork from, by Neon branch id. When omitted Neon forks
72
+ * from the project's default branch. Resolve a name to an id first with
73
+ * {@link NeonClient.getBranchByName}.
74
+ */
75
+ parentBranchId?: string;
76
+ /**
77
+ * Point-in-time to fork from. Omit for "latest". A canary wants the current
78
+ * head of the parent, so this is normally left unset.
79
+ */
80
+ parentLsn?: string;
81
+ parentTimestamp?: string;
82
+ /**
83
+ * Attach a read-write compute so the branch is immediately connectable and
84
+ * migratable. Defaults to `true` — a canary is useless without a compute.
85
+ */
86
+ withEndpoint?: boolean;
87
+ }
88
+ export interface ConnectionStringParams {
89
+ branchId: string;
90
+ /** Postgres database name. Neon's default is `neondb`. */
91
+ database?: string;
92
+ /** Role to connect as. Neon's default owner role varies per project. */
93
+ role?: string;
94
+ /** Return the pooled (PgBouncer) URI. Defaults to `false` (direct). */
95
+ pooled?: boolean;
96
+ }
97
+ export interface SchemaDiffParams {
98
+ /** Branch whose schema is the "new" side of the diff. */
99
+ branchId: string;
100
+ /** Base branch to diff against. Defaults to the branch's own parent. */
101
+ baseBranchId?: string;
102
+ /** Database to compare. Defaults to `neondb`. */
103
+ database?: string;
104
+ }
105
+ /** Structured error carrying Neon's HTTP status + response body for triage. */
106
+ export declare class NeonApiError extends Error {
107
+ readonly status: number;
108
+ readonly method: string;
109
+ readonly path: string;
110
+ readonly body: string;
111
+ constructor(method: string, path: string, status: number, body: string, message?: string);
112
+ }
113
+ export declare class NeonClient {
114
+ private readonly apiKey;
115
+ private readonly projectId;
116
+ private readonly fetch;
117
+ private readonly baseUrl;
118
+ constructor(options: NeonClientOptions);
119
+ getProjectId(): string;
120
+ /**
121
+ * Issue a request against the Neon REST API. `path` is relative to the
122
+ * project (e.g. `/branches`); it's expanded to
123
+ * `${baseUrl}/projects/${projectId}${path}`. Non-2xx responses throw a
124
+ * {@link NeonApiError}.
125
+ */
126
+ private request;
127
+ /** List all branches in the project. */
128
+ listBranches(): Promise<NeonBranch[]>;
129
+ /** Find a branch by its (non-unique in theory, unique in practice) name. */
130
+ getBranchByName(name: string): Promise<NeonBranch | undefined>;
131
+ /**
132
+ * Create a copy-on-write branch. When `withEndpoint` (default true) a
133
+ * read-write compute is attached so the branch is immediately connectable;
134
+ * the response's `connectionUris` then carry ready-to-use URIs.
135
+ */
136
+ createBranch(params: CreateBranchParams): Promise<CreateBranchResult>;
137
+ /**
138
+ * Resolve a connection string for a branch. Returns a `postgresql://…` URI.
139
+ * Neon requires `database_name` and `role_name`; sensible Neon defaults are
140
+ * applied when the caller doesn't specify them.
141
+ */
142
+ getConnectionString(params: ConnectionStringParams): Promise<string>;
143
+ /**
144
+ * Diff a branch's schema against a base branch. Returns the DDL diff Neon
145
+ * computes (unified-diff text of the two schemas' `pg_dump --schema-only`).
146
+ * An empty string means the schemas are identical.
147
+ */
148
+ schemaDiff(params: SchemaDiffParams): Promise<string>;
149
+ /** Delete a branch (and its computes). Idempotent-ish: 404s throw. */
150
+ deleteBranch(branchId: string): Promise<void>;
151
+ }
152
+ //# sourceMappingURL=neon.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neon.d.ts","sourceRoot":"","sources":["../../src/lib/neon.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,171 @@
1
+ /**
2
+ * Neon API Client
3
+ *
4
+ * A thin, dependency-free wrapper over the Neon REST API (v2) covering the
5
+ * branch-canary orchestration surface: create a copy-on-write branch, resolve
6
+ * a branch's connection string, diff a branch's schema against its parent, and
7
+ * delete the branch.
8
+ *
9
+ * The underlying HTTP transport is INJECTABLE (`fetch`) so the canary
10
+ * orchestration can be unit-tested with a mocked Neon — no live token, no
11
+ * network. In production the global `fetch` is used.
12
+ *
13
+ * API reference: https://api-docs.neon.tech/reference/getting-started-with-neon-api
14
+ * Auth: `Authorization: Bearer <NEON_API_KEY>`.
15
+ */
16
+ /**
17
+ * Neon's default REST base. Override via `NEON_API_BASE` (or the constructor)
18
+ * for Neon-compatible proxies or a future host. Both `console.neon.tech` and
19
+ * `api.neon.tech` front the same v2 API; `console.neon.tech` is the one the
20
+ * public docs curl against, so it's the default.
21
+ */
22
+ export const DEFAULT_NEON_API_BASE = 'https://console.neon.tech/api/v2';
23
+ /** Structured error carrying Neon's HTTP status + response body for triage. */
24
+ export class NeonApiError extends Error {
25
+ status;
26
+ method;
27
+ path;
28
+ body;
29
+ constructor(method, path, status, body, message) {
30
+ super(message ?? `Neon API ${method} ${path} failed: ${status} ${body}`);
31
+ this.name = 'NeonApiError';
32
+ this.status = status;
33
+ this.method = method;
34
+ this.path = path;
35
+ this.body = body;
36
+ }
37
+ }
38
+ export class NeonClient {
39
+ apiKey;
40
+ projectId;
41
+ fetch;
42
+ baseUrl;
43
+ constructor(options) {
44
+ if (!options.apiKey)
45
+ throw new Error('NeonClient requires an apiKey (NEON_API_KEY).');
46
+ if (!options.projectId)
47
+ throw new Error('NeonClient requires a projectId (NEON_PROJECT_ID).');
48
+ this.apiKey = options.apiKey;
49
+ this.projectId = options.projectId;
50
+ this.fetch = options.fetch ?? globalThis.fetch;
51
+ this.baseUrl = (options.baseUrl ?? DEFAULT_NEON_API_BASE).replace(/\/+$/, '');
52
+ if (typeof this.fetch !== 'function') {
53
+ throw new Error('NeonClient requires a fetch implementation (global fetch or an injected one).');
54
+ }
55
+ }
56
+ getProjectId() {
57
+ return this.projectId;
58
+ }
59
+ /**
60
+ * Issue a request against the Neon REST API. `path` is relative to the
61
+ * project (e.g. `/branches`); it's expanded to
62
+ * `${baseUrl}/projects/${projectId}${path}`. Non-2xx responses throw a
63
+ * {@link NeonApiError}.
64
+ */
65
+ async request(method, path, options = {}) {
66
+ const url = new URL(`${this.baseUrl}/projects/${this.projectId}${path}`);
67
+ if (options.query) {
68
+ for (const [key, value] of Object.entries(options.query)) {
69
+ if (value === undefined)
70
+ continue;
71
+ url.searchParams.set(key, String(value));
72
+ }
73
+ }
74
+ const headers = {
75
+ Authorization: `Bearer ${this.apiKey}`,
76
+ Accept: 'application/json',
77
+ };
78
+ if (options.body !== undefined)
79
+ headers['Content-Type'] = 'application/json';
80
+ const response = await this.fetch(url.toString(), {
81
+ method,
82
+ headers,
83
+ body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
84
+ });
85
+ const text = await response.text();
86
+ if (!response.ok) {
87
+ throw new NeonApiError(method, `/projects/${this.projectId}${path}`, response.status, text);
88
+ }
89
+ if (!text)
90
+ return undefined;
91
+ try {
92
+ return JSON.parse(text);
93
+ }
94
+ catch {
95
+ throw new NeonApiError(method, `/projects/${this.projectId}${path}`, response.status, text, `Neon API returned non-JSON body for ${method} ${path}`);
96
+ }
97
+ }
98
+ /** List all branches in the project. */
99
+ async listBranches() {
100
+ const data = await this.request('GET', '/branches');
101
+ return data.branches ?? [];
102
+ }
103
+ /** Find a branch by its (non-unique in theory, unique in practice) name. */
104
+ async getBranchByName(name) {
105
+ const branches = await this.listBranches();
106
+ return branches.find((b) => b.name === name);
107
+ }
108
+ /**
109
+ * Create a copy-on-write branch. When `withEndpoint` (default true) a
110
+ * read-write compute is attached so the branch is immediately connectable;
111
+ * the response's `connectionUris` then carry ready-to-use URIs.
112
+ */
113
+ async createBranch(params) {
114
+ const branch = { name: params.name };
115
+ if (params.parentBranchId)
116
+ branch.parent_id = params.parentBranchId;
117
+ if (params.parentLsn)
118
+ branch.parent_lsn = params.parentLsn;
119
+ if (params.parentTimestamp)
120
+ branch.parent_timestamp = params.parentTimestamp;
121
+ const body = { branch };
122
+ if (params.withEndpoint !== false) {
123
+ body.endpoints = [{ type: 'read_write' }];
124
+ }
125
+ const data = await this.request('POST', '/branches', { body });
126
+ return {
127
+ branchId: data.branch.id,
128
+ branch: data.branch,
129
+ endpoints: data.endpoints ?? [],
130
+ connectionUris: data.connection_uris ?? [],
131
+ };
132
+ }
133
+ /**
134
+ * Resolve a connection string for a branch. Returns a `postgresql://…` URI.
135
+ * Neon requires `database_name` and `role_name`; sensible Neon defaults are
136
+ * applied when the caller doesn't specify them.
137
+ */
138
+ async getConnectionString(params) {
139
+ const data = await this.request('GET', '/connection_uri', {
140
+ query: {
141
+ branch_id: params.branchId,
142
+ database_name: params.database ?? 'neondb',
143
+ role_name: params.role ?? 'neondb_owner',
144
+ pooled: params.pooled ?? false,
145
+ },
146
+ });
147
+ if (!data.uri) {
148
+ throw new Error(`Neon returned no connection URI for branch ${params.branchId}.`);
149
+ }
150
+ return data.uri;
151
+ }
152
+ /**
153
+ * Diff a branch's schema against a base branch. Returns the DDL diff Neon
154
+ * computes (unified-diff text of the two schemas' `pg_dump --schema-only`).
155
+ * An empty string means the schemas are identical.
156
+ */
157
+ async schemaDiff(params) {
158
+ const data = await this.request('GET', `/branches/${params.branchId}/compare_schema`, {
159
+ query: {
160
+ base_branch_id: params.baseBranchId,
161
+ db_name: params.database ?? 'neondb',
162
+ },
163
+ });
164
+ return data.diff ?? '';
165
+ }
166
+ /** Delete a branch (and its computes). Idempotent-ish: 404s throw. */
167
+ async deleteBranch(branchId) {
168
+ await this.request('DELETE', `/branches/${branchId}`);
169
+ }
170
+ }
171
+ //# sourceMappingURL=neon.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neon.js","sourceRoot":"","sources":["../../src/lib/neon.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=neon.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neon.test.d.ts","sourceRoot":"","sources":["../../src/lib/neon.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,154 @@
1
+ /**
2
+ * Neon API client — mocked-transport unit tests.
3
+ *
4
+ * No live NEON_API_KEY, no network: an injected `fetch` returns ordinary
5
+ * `Response` objects and records every request so we can assert the exact
6
+ * URL / method / body the client emits against the Neon v2 REST surface.
7
+ */
8
+ import { describe, expect, test } from 'bun:test';
9
+ import { NeonApiError, NeonClient, DEFAULT_NEON_API_BASE } from './neon.js';
10
+ /** Build an injectable fetch that replays queued responses and records calls. */
11
+ function mockFetch(responder) {
12
+ const calls = [];
13
+ const fetch = (async (input, init) => {
14
+ const headers = {};
15
+ for (const [k, v] of Object.entries(init?.headers ?? {}))
16
+ headers[k.toLowerCase()] = String(v);
17
+ const rec = {
18
+ url: String(input),
19
+ method: init?.method ?? 'GET',
20
+ headers,
21
+ body: init?.body ? JSON.parse(init.body) : undefined,
22
+ };
23
+ calls.push(rec);
24
+ const { status = 200, body } = responder(rec);
25
+ const text = body === undefined ? '' : JSON.stringify(body);
26
+ return new Response(text, { status });
27
+ });
28
+ return { fetch, calls };
29
+ }
30
+ const base = { apiKey: 'neon_key_123', projectId: 'proj-abc' };
31
+ describe('NeonClient — construction', () => {
32
+ test('rejects missing apiKey / projectId', () => {
33
+ expect(() => new NeonClient({ apiKey: '', projectId: 'p', fetch: (() => { }) })).toThrow(/apiKey/);
34
+ expect(() => new NeonClient({ apiKey: 'k', projectId: '', fetch: (() => { }) })).toThrow(/projectId/);
35
+ });
36
+ test('defaults to the documented Neon base and injected fetch', async () => {
37
+ const { fetch, calls } = mockFetch(() => ({ body: { branches: [] } }));
38
+ const client = new NeonClient({ ...base, fetch });
39
+ await client.listBranches();
40
+ expect(calls[0].url.startsWith(`${DEFAULT_NEON_API_BASE}/projects/proj-abc/branches`)).toBe(true);
41
+ expect(calls[0].headers['authorization']).toBe('Bearer neon_key_123');
42
+ });
43
+ });
44
+ describe('NeonClient — branches', () => {
45
+ test('listBranches unwraps the branches array', async () => {
46
+ const { fetch } = mockFetch(() => ({ body: { branches: [{ id: 'br-1', name: 'main', project_id: 'proj-abc' }] } }));
47
+ const client = new NeonClient({ ...base, fetch });
48
+ const branches = await client.listBranches();
49
+ expect(branches).toHaveLength(1);
50
+ expect(branches[0].name).toBe('main');
51
+ });
52
+ test('getBranchByName finds by name', async () => {
53
+ const { fetch } = mockFetch(() => ({
54
+ body: { branches: [
55
+ { id: 'br-main', name: 'production', project_id: 'proj-abc' },
56
+ { id: 'br-2', name: 'staging', project_id: 'proj-abc' },
57
+ ] },
58
+ }));
59
+ const client = new NeonClient({ ...base, fetch });
60
+ expect((await client.getBranchByName('production'))?.id).toBe('br-main');
61
+ expect(await client.getBranchByName('nope')).toBeUndefined();
62
+ });
63
+ test('createBranch POSTs parent_id + a read_write endpoint and returns ids/URIs', async () => {
64
+ const { fetch, calls } = mockFetch(() => ({
65
+ status: 201,
66
+ body: {
67
+ branch: { id: 'br-canary', name: 'canary/x', project_id: 'proj-abc', parent_id: 'br-main' },
68
+ endpoints: [{ id: 'ep-1', branch_id: 'br-canary', host: 'ep-1.neon.tech', type: 'read_write' }],
69
+ connection_uris: [{ connection_uri: 'postgresql://u:p@ep-1.neon.tech/neondb' }],
70
+ },
71
+ }));
72
+ const client = new NeonClient({ ...base, fetch });
73
+ const result = await client.createBranch({ name: 'canary/x', parentBranchId: 'br-main' });
74
+ expect(calls[0].method).toBe('POST');
75
+ expect(calls[0].url.endsWith('/projects/proj-abc/branches')).toBe(true);
76
+ expect(calls[0].body).toEqual({
77
+ branch: { name: 'canary/x', parent_id: 'br-main' },
78
+ endpoints: [{ type: 'read_write' }],
79
+ });
80
+ expect(result.branchId).toBe('br-canary');
81
+ expect(result.connectionUris[0].connection_uri).toContain('postgresql://');
82
+ });
83
+ test('createBranch with withEndpoint:false omits endpoints', async () => {
84
+ const { fetch, calls } = mockFetch(() => ({ body: { branch: { id: 'br-x', name: 'x', project_id: 'proj-abc' } } }));
85
+ const client = new NeonClient({ ...base, fetch });
86
+ await client.createBranch({ name: 'x', withEndpoint: false });
87
+ expect(calls[0].body.endpoints).toBeUndefined();
88
+ });
89
+ test('deleteBranch issues DELETE on the branch path', async () => {
90
+ const { fetch, calls } = mockFetch(() => ({ body: {} }));
91
+ const client = new NeonClient({ ...base, fetch });
92
+ await client.deleteBranch('br-canary');
93
+ expect(calls[0].method).toBe('DELETE');
94
+ expect(calls[0].url.endsWith('/projects/proj-abc/branches/br-canary')).toBe(true);
95
+ });
96
+ });
97
+ describe('NeonClient — connection string + schema diff', () => {
98
+ test('getConnectionString passes branch/database/role query and returns uri', async () => {
99
+ const { fetch, calls } = mockFetch(() => ({ body: { uri: 'postgresql://u:p@ep-1.neon.tech/neondb?sslmode=require' } }));
100
+ const client = new NeonClient({ ...base, fetch });
101
+ const uri = await client.getConnectionString({ branchId: 'br-canary', database: 'appdb', role: 'quickback' });
102
+ const url = new URL(calls[0].url);
103
+ expect(url.pathname.endsWith('/projects/proj-abc/connection_uri')).toBe(true);
104
+ expect(url.searchParams.get('branch_id')).toBe('br-canary');
105
+ expect(url.searchParams.get('database_name')).toBe('appdb');
106
+ expect(url.searchParams.get('role_name')).toBe('quickback');
107
+ expect(uri).toContain('sslmode=require');
108
+ });
109
+ test('getConnectionString applies Neon defaults when unspecified', async () => {
110
+ const { fetch, calls } = mockFetch(() => ({ body: { uri: 'postgresql://x' } }));
111
+ const client = new NeonClient({ ...base, fetch });
112
+ await client.getConnectionString({ branchId: 'br-1' });
113
+ const url = new URL(calls[0].url);
114
+ expect(url.searchParams.get('database_name')).toBe('neondb');
115
+ expect(url.searchParams.get('role_name')).toBe('neondb_owner');
116
+ });
117
+ test('schemaDiff returns the diff text', async () => {
118
+ const { fetch, calls } = mockFetch(() => ({ body: { diff: 'CREATE TABLE foo (id int);' } }));
119
+ const client = new NeonClient({ ...base, fetch });
120
+ const diff = await client.schemaDiff({ branchId: 'br-canary', baseBranchId: 'br-main', database: 'appdb' });
121
+ const url = new URL(calls[0].url);
122
+ expect(url.pathname.endsWith('/projects/proj-abc/branches/br-canary/compare_schema')).toBe(true);
123
+ expect(url.searchParams.get('base_branch_id')).toBe('br-main');
124
+ expect(url.searchParams.get('db_name')).toBe('appdb');
125
+ expect(diff).toContain('CREATE TABLE foo');
126
+ });
127
+ test('schemaDiff returns empty string when Neon reports no diff', async () => {
128
+ const { fetch } = mockFetch(() => ({ body: {} }));
129
+ const client = new NeonClient({ ...base, fetch });
130
+ expect(await client.schemaDiff({ branchId: 'br-1' })).toBe('');
131
+ });
132
+ });
133
+ describe('NeonClient — errors', () => {
134
+ test('non-2xx throws NeonApiError carrying status + body', async () => {
135
+ const { fetch } = mockFetch(() => ({ status: 404, body: { message: 'branch not found' } }));
136
+ const client = new NeonClient({ ...base, fetch });
137
+ try {
138
+ await client.deleteBranch('br-missing');
139
+ throw new Error('should have thrown');
140
+ }
141
+ catch (err) {
142
+ expect(err).toBeInstanceOf(NeonApiError);
143
+ expect(err.status).toBe(404);
144
+ expect(err.body).toContain('branch not found');
145
+ }
146
+ });
147
+ test('honors a custom baseUrl', async () => {
148
+ const { fetch, calls } = mockFetch(() => ({ body: { branches: [] } }));
149
+ const client = new NeonClient({ ...base, fetch, baseUrl: 'https://api.neon.tech/api/v2/' });
150
+ await client.listBranches();
151
+ expect(calls[0].url.startsWith('https://api.neon.tech/api/v2/projects/proj-abc/branches')).toBe(true);
152
+ });
153
+ });
154
+ //# sourceMappingURL=neon.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neon.test.js","sourceRoot":"","sources":["../../src/lib/neon.test.ts"],"names":[],"mappings":"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"}