neonctl 1.29.5 → 1.31.0

package/README.md

@@ -70,7 +70,7 @@ The Neon CLI supports autocompletion, which you can configure in a few easy step
 | [projects](https://neon.tech/docs/reference/cli-projects)                   | `list`, `create`, `update`, `delete`, `get`                               | Manage projects              |
 | [ip-allow](https://neon.tech/docs/reference/cli-ip-allow)                   | `list`, `add`, `remove`, `reset`                                          | Manage IP Allow              |
 | [me](https://neon.tech/docs/reference/cli-me)                               |                                                                           | Show current user            |
-| [branches](https://neon.tech/docs/reference/cli-branches)                   | `list`, `create`, `rename`, `add-compute`, `set-primary`, `delete`, `get` | Manage branches              |
+| [branches](https://neon.tech/docs/reference/cli-branches)                   | `list`, `create`, `rename`, `add-compute`, `set-default`, `delete`, `get` | Manage branches              |
 | [databases](https://neon.tech/docs/reference/cli-databases)                 | `list`, `create`, `delete`                                                | Manage databases             |
 | [roles](https://neon.tech/docs/reference/cli-roles)                         | `list`, `create`, `delete`                                                | Manage roles                 |
 | [operations](https://neon.tech/docs/reference/cli-operations)               | `list`                                                                    | Manage operations            |

package/analytics.js

@@ -9,11 +9,13 @@ import pkg from './pkg.js';
 import { getApiClient } from './api.js';
 const WRITE_KEY = '3SQXn5ejjXWLEJ8xU2PRYhAotLtTaeeV';
 let client;
+let clientInitialized = false;
 let userId = '';
 export const analyticsMiddleware = async (args) => {
-    if (!args.analytics) {
+    if (!args.analytics || clientInitialized) {
         return;
     }
+    clientInitialized = true;
     try {
         const credentialsPath = join(args.configDir, CREDENTIALS_FILE);
         const credentials = readFileSync(credentialsPath, { encoding: 'utf-8' });
@@ -39,6 +41,7 @@ export const analyticsMiddleware = async (args) => {
         writeKey: WRITE_KEY,
         host: 'https://track.neon.tech',
     });
+    log.debug('Initialized CLI analytics');
     client.identify({
         userId: userId?.toString() ?? 'anonymous',
     });
@@ -54,9 +57,13 @@ export const analyticsMiddleware = async (args) => {
             ci: isCi(),
         },
     });
-    log.debug('Flushing CLI started event with userId: %s', userId);
-    await client.closeAndFlush();
-    log.debug('Flushed CLI started event with userId: %s', userId);
+};
+export const closeAnalytics = async () => {
+    if (client) {
+        log.debug('Flushing CLI analytics');
+        await client.closeAndFlush();
+        log.debug('Flushed CLI analytics');
+    }
 };
 export const sendError = (err, errCode) => {
     if (!client) {
@@ -73,6 +80,5 @@ export const sendError = (err, errCode) => {
             statusCode: axiosError?.response?.status,
         },
     });
-    client.closeAndFlush();
     log.debug('Sent CLI error event: %s', errCode);
 };

package/commands/branches.js

@@ -7,10 +7,12 @@ import { looksLikeBranchId, looksLikeLSN, looksLikeTimestamp, } from '../utils/f
 import { psql } from '../utils/psql.js';
 import { parsePointInTime } from '../utils/point_in_time.js';
 import { log } from '../log.js';
+import { parseSchemaDiffParams, schemaDiff } from './schema_diff.js';
 const BRANCH_FIELDS = [
     'id',
     'name',
     'primary',
+    'default',
     'created_at',
     'updated_at',
 ];
@@ -18,6 +20,7 @@ const BRANCH_FIELDS_RESET = [
     'id',
     'name',
     'primary',
+    'default',
     'created_at',
     'last_reset_at',
 ];
@@ -37,7 +40,7 @@ export const builder = (argv) => argv
     .command('create', 'Create a branch', (yargs) => yargs.options({
     name: branchCreateRequest['branch.name'],
     parent: {
-        describe: 'Parent branch name or id or timestamp or LSN. Defaults to the primary branch',
+        describe: 'Parent branch name or id or timestamp or LSN. Defaults to the default branch',
         type: 'string',
     },
     compute: {
@@ -107,7 +110,8 @@ export const builder = (argv) => argv
     ],
 ]), async (args) => await restore(args))
     .command('rename <id|name> <new-name>', 'Rename a branch', (yargs) => yargs, async (args) => await rename(args))
-    .command('set-primary <id|name>', 'Set a branch as primary', (yargs) => yargs, async (args) => await setPrimary(args))
+    .command('set-primary <id|name>', 'DEPRECATED: Use set-default. Set a branch as primary', (yargs) => yargs, async (args) => await setDefault(args))
+    .command('set-default <id|name>', 'Set a branch as default', (yargs) => yargs, async (args) => await setDefault(args))
     .command('add-compute <id|name>', 'Add a compute to a branch', (yargs) => yargs.options({
     type: {
         type: 'string',
@@ -117,7 +121,47 @@ export const builder = (argv) => argv
     },
 }), async (args) => await addCompute(args))
     .command('delete <id|name>', 'Delete a branch', (yargs) => yargs, async (args) => await deleteBranch(args))
-    .command('get <id|name>', 'Get a branch', (yargs) => yargs, async (args) => await get(args));
+    .command('get <id|name>', 'Get a branch', (yargs) => yargs, async (args) => await get(args))
+    .command({
+    command: 'schema-diff [base-branch] [compare-source[@(timestamp|lsn)]]',
+    aliases: ['sd'],
+    describe: "Compare the latest schemas of any two branches, or compare a branch to its own or another branch's history.",
+    builder: (yargs) => {
+        return yargs
+            .middleware((args) => (args.compareSource = args['compare-source@(timestamp']))
+            .middleware(parseSchemaDiffParams)
+            .options({
+            database: {
+                alias: 'db',
+                type: 'string',
+                description: 'Name of the database for which the schema comparison is performed',
+            },
+        })
+            .example([
+            [
+                '$0 branches schema-diff main br-compare-branch-123456',
+                'Compares the main branch to the head of the branch with ID br-compare-branch-123456',
+            ],
+            [
+                '$0 branches schema-diff main compare@2024-06-01T00:00:00Z',
+                'Compares the main branch to the state of the compare branch at timestamp 2024-06-01T00:00:00.000Z',
+            ],
+            [
+                '$0 branches schema-diff my-branch ^self@0/123456',
+                'Compares my-branch to LSN 0/123456 from its own history',
+            ],
+            [
+                '$0 branches schema-diff my-branch ^parent',
+                'Compares my-branch to the head of its parent branch',
+            ],
+            [
+                '$0 branches schema-diff',
+                "If a branch is specified in 'set-context', compares this branch to its parent. Otherwise, compares the default branch to its parent.",
+            ],
+        ]);
+    },
+    handler: async (args) => schemaDiff(args),
+});
 export const handler = (args) => {
     return args;
 };
@@ -133,9 +177,9 @@ const create = async (props) => {
             return props.apiClient
                 .listProjectBranches(props.projectId)
                 .then(({ data }) => {
-                const branch = data.branches.find((b) => b.primary);
+                const branch = data.branches.find((b) => b.default);
                 if (!branch) {
-                    throw new Error('No primary branch found');
+                    throw new Error('No default branch found');
                 }
                 return { parent_id: branch.id };
             });
@@ -211,9 +255,9 @@ const rename = async (props) => {
         fields: BRANCH_FIELDS,
     });
 };
-const setPrimary = async (props) => {
+const setDefault = async (props) => {
     const branchId = await branchIdFromProps(props);
-    const { data } = await retryOnLock(() => props.apiClient.setPrimaryProjectBranch(props.projectId, branchId));
+    const { data } = await retryOnLock(() => props.apiClient.setDefaultProjectBranch(props.projectId, branchId));
     writer(props).end(data.branch, {
         fields: BRANCH_FIELDS,
     });

package/commands/branches.test.js

@@ -195,6 +195,20 @@ describe('branches', () => {
             snapshot: true,
         },
     });
+    /* set default */
+    testCliCommand({
+        name: 'set default by id',
+        args: [
+            'branches',
+            'set-default',
+            'br-sunny-branch-123456',
+            '--project-id',
+            'test',
+        ],
+        expected: {
+            snapshot: true,
+        },
+    });
     /* get */
     testCliCommand({
         name: 'get by id',

package/commands/connection_string.js

@@ -14,7 +14,7 @@ export const builder = (argv) => {
         .example('$0 cs main@2024-01-01T00:00:00Z', 'Get connection string for the main branch at a specific point in time')
         .example('$0 cs main@0/234235', 'Get connection string for the main branch at a specific LSN')
         .positional('branch', {
-        describe: `Branch name or id. Defaults to the primary branch if omitted. Can be written in the point-in-time format: "branch@timestamp" or "branch@lsn"`,
+        describe: `Branch name or id. Defaults to the default branch if omitted. Can be written in the point-in-time format: "branch@timestamp" or "branch@lsn"`,
         type: 'string',
     })
         .options({

package/commands/index.js

@@ -2,6 +2,7 @@ import * as auth from './auth.js';
 import * as projects from './projects.js';
 import * as ipAllow from './ip_allow.js';
 import * as users from './user.js';
+import * as orgs from './orgs.js';
 import * as branches from './branches.js';
 import * as databases from './databases.js';
 import * as roles from './roles.js';
@@ -11,6 +12,7 @@ import * as setContext from './set_context.js';
 export default [
     auth,
     users,
+    orgs,
     projects,
     ipAllow,
     branches,

package/commands/orgs.js

@@ -0,0 +1,23 @@
+import { writer } from '../writer.js';
+const ORG_FIELDS = ['id', 'name'];
+export const command = 'orgs';
+export const describe = 'Manage organizations';
+export const aliases = ['org'];
+export const builder = (argv) => {
+    return argv.usage('$0 orgs <sub-command> [options]').command('list', 'List organizations', (yargs) => yargs, async (args) => {
+        // @ts-expect-error: TODO - Assert `args` is `CommonProps`
+        await list(args);
+    });
+};
+export const handler = (args) => {
+    return args;
+};
+const list = async (props) => {
+    const out = writer(props);
+    const { data: { organizations }, } = await props.apiClient.getCurrentUserOrganizations();
+    out.write(organizations, {
+        fields: ORG_FIELDS,
+        title: 'Organizations',
+    });
+    out.end();
+};

package/commands/schema_diff.js

@@ -0,0 +1,150 @@
+import { createPatch } from 'diff';
+import chalk from 'chalk';
+import { writer } from '../writer.js';
+import { branchIdFromProps } from '../utils/enrichers.js';
+import { parsePointInTime, } from '../utils/point_in_time.js';
+import { isAxiosError } from 'axios';
+import { sendError } from '../analytics.js';
+import { log } from '../log.js';
+const COLORS = {
+    added: chalk.green,
+    removed: chalk.red,
+    header: chalk.yellow,
+    section: chalk.magenta,
+};
+export const schemaDiff = async (props) => {
+    props.branch = props.baseBranch || props.branch;
+    const baseBranch = await branchIdFromProps(props);
+    let pointInTime = await parsePointInTime({
+        pointInTime: props.compareSource,
+        targetBranchId: baseBranch,
+        projectId: props.projectId,
+        api: props.apiClient,
+    });
+    // Swap base and compare points if comparing with parent branch
+    const comparingWithParent = props.compareSource.startsWith('^parent');
+    let baseBranchPoint = {
+        branchId: baseBranch,
+        tag: 'head',
+    };
+    [baseBranchPoint, pointInTime] = comparingWithParent
+        ? [pointInTime, baseBranchPoint]
+        : [baseBranchPoint, pointInTime];
+    const baseDatabases = await fetchDatabases(baseBranch, props);
+    if (props.database) {
+        const database = baseDatabases.find((db) => db.name === props.database);
+        if (!database) {
+            throw new Error(`Database ${props.database} does not exist in base branch ${baseBranch}`);
+        }
+        const patch = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
+        writer(props).text(colorize(patch));
+        return;
+    }
+    await Promise.all(baseDatabases.map(async (database) => {
+        const patch = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
+        writer(props).text(colorize(patch));
+    }));
+};
+const fetchDatabases = async (branch, props) => {
+    return props.apiClient
+        .listProjectBranchDatabases(props.projectId, branch)
+        .then((response) => response.data.databases);
+};
+const createSchemaDiff = async (baseBranch, pointInTime, database, props) => {
+    const [baseSchema, compareSchema] = await Promise.all([
+        fetchSchema(baseBranch, database, props),
+        fetchSchema(pointInTime, database, props),
+    ]);
+    return createPatch(`Database: ${database.name}`, baseSchema, compareSchema, generateHeader(baseBranch), generateHeader(pointInTime));
+};
+const fetchSchema = async (pointInTime, database, props) => {
+    try {
+        return props.apiClient
+            .getProjectBranchSchema({
+            projectId: props.projectId,
+            branchId: pointInTime.branchId,
+            db_name: database.name,
+            role: database.owner_name,
+            ...pointInTimeParams(pointInTime),
+        })
+            .then((response) => response.data.sql ?? '');
+    }
+    catch (error) {
+        if (isAxiosError(error)) {
+            const data = error.response?.data;
+            sendError(error, 'API_ERROR');
+            throw new Error(data.message ??
+                `Error while fetching schema for branch ${pointInTime.branchId}`);
+        }
+        throw error;
+    }
+};
+const colorize = (patch) => {
+    return patch
+        .replace(/^([^\n]+)\n([^\n]+)\n/m, '') // Remove first two lines
+        .replace(/^-.*/gm, colorizer('removed'))
+        .replace(/^\+.*/gm, colorizer('added'))
+        .replace(/^@@.+@@.*/gm, colorizer('section'));
+};
+const colorizer = (colorId) => {
+    const color = COLORS[colorId];
+    return (line) => color(line);
+};
+const pointInTimeParams = (pointInTime) => {
+    switch (pointInTime.tag) {
+        case 'timestamp':
+            return {
+                timestamp: pointInTime.timestamp,
+            };
+        case 'lsn':
+            return {
+                lsn: pointInTime.lsn ?? undefined,
+            };
+        default:
+            return {};
+    }
+};
+const generateHeader = (pointInTime) => {
+    const header = `(Branch: ${pointInTime.branchId}`;
+    switch (pointInTime.tag) {
+        case 'timestamp':
+            return `${header} at ${pointInTime.timestamp})`;
+        case 'lsn':
+            return `${header} at ${pointInTime.lsn})`;
+        default:
+            return `${header})`;
+    }
+};
+/*
+  The command has two positional optional arguments - [base-branch] and [compare-source]
+  If only one argument is specified, we should consider it as `compare-source`
+    and `base-branch` will be either read from context or the default branch of project.
+  If no branches are specified, compare the context branch with its parent
+*/
+export const parseSchemaDiffParams = async (props) => {
+    if (!props.compareSource) {
+        if (props.baseBranch) {
+            props.compareSource = props.baseBranch;
+            props.baseBranch = props.branch;
+        }
+        else if (props.branch) {
+            const { data } = await props.apiClient.listProjectBranches(props.projectId);
+            const contextBranch = data.branches.find((b) => b.id === props.branch || b.name === props.branch);
+            if (contextBranch?.parent_id == undefined) {
+                throw new Error(`No branch specified. Your context branch (${props.branch}) has no parent, so no comparison is possible.`);
+            }
+            log.info(`No branches specified. Comparing your context branch '${props.branch}' with its parent`);
+            props.compareSource = '^parent';
+        }
+        else {
+            const { data } = await props.apiClient.listProjectBranches(props.projectId);
+            const defaultBranch = data.branches.find((b) => b.default);
+            if (defaultBranch?.parent_id == undefined) {
+                throw new Error('No branch specified. Include a base branch or add a set-context branch to continue. Your default branch has no parent, so no comparison is possible.');
+            }
+            log.info(`No branches specified. Comparing default branch with its parent`);
+            props.compareSource = '^parent';
+        }
+    }
+    return props;
+};

package/commands/set_context.js

@@ -1,5 +1,4 @@
 import { updateContextFile } from '../context.js';
-import { branchIdFromProps } from '../utils/enrichers.js';
 export const command = 'set-context';
 export const describe = 'Set the current context';
 export const builder = (argv) => argv.usage('$0 set-context [options]').options({
@@ -7,16 +6,10 @@ export const builder = (argv) => argv.usage('$0 set-context [options]').options(
         describe: 'Project ID',
         type: 'string',
     },
-    branch: {
-        describe: 'Branch ID or name',
-        type: 'string',
-    },
 });
 export const handler = async (props) => {
-    const branchId = await branchIdFromProps(props);
     const context = {
         projectId: props.projectId,
-        branchId,
     };
     updateContextFile(props.contextFile, context);
 };

package/commands/set_context.test.js

@@ -28,24 +28,64 @@ describe('set_context', () => {
         });
         const overrideContextFile = join(tmpdir(), `neon_override_ctx_${Date.now()}`);
         testCliCommand({
-            name: 'get branch id overrides context set branch',
+            name: 'get project id overrides context set project',
             before: async () => {
                 writeFileSync(overrideContextFile, JSON.stringify({
-                    projectId: 'test',
-                    branchId: 'br-cloudy-branch-12345678',
+                    projectId: 'new-project id',
                 }));
             },
             after: async () => {
                 rmSync(overrideContextFile);
             },
             args: [
-                'branches',
+                'project',
                 'get',
-                'br-sunny-branch-123456',
+                'project-id-123',
+                '--context-file',
+                overrideContextFile,
+            ],
+            expected: {
+                snapshot: true,
+            },
+        });
+        testCliCommand({
+            name: 'set the branchId and projectId is from context',
+            before: async () => {
+                writeFileSync(overrideContextFile, JSON.stringify({
+                    projectId: 'test',
+                    branchId: 'test_branch',
+                }));
+            },
+            after: async () => {
+                rmSync(overrideContextFile);
+            },
+            args: ['databases', 'list', '--context-file', overrideContextFile],
+            expected: {
+                snapshot: true,
+            },
+        });
+        testCliCommand({
+            name: 'should not set branchId from context for non-context projectId',
+            before: async () => {
+                writeFileSync(overrideContextFile, JSON.stringify({
+                    projectId: 'project-id-123',
+                    branchId: 'test_branch',
+                }));
+            },
+            after: async () => {
+                rmSync(overrideContextFile);
+            },
+            args: [
+                'databases',
+                'list',
+                '--project-id',
+                'test',
                 '--context-file',
                 overrideContextFile,
             ],
             expected: {
+                code: 1,
+                stderr: 'ERROR: Not Found',
                 snapshot: true,
             },
         });

package/context.js

@@ -36,12 +36,15 @@ export const enrichFromContext = (args) => {
         return;
     }
     const context = readContextFile(args.contextFile);
-    if (!args.branch && !args.id && !args.name) {
-        args.branch = context.branchId;
-    }
     if (!args.projectId) {
         args.projectId = context.projectId;
     }
+    if (!args.branch &&
+        !args.id &&
+        !args.name &&
+        context.projectId === args.projectId) {
+        args.branch = context.branchId;
+    }
 };
 export const updateContextFile = (file, context) => {
     writeFileSync(file, JSON.stringify(context, null, 2));

package/index.js

@@ -20,7 +20,7 @@ import { defaultClientID } from './auth.js';
 import { fillInArgs } from './utils/middlewares.js';
 import pkg from './pkg.js';
 import commands from './commands/index.js';
-import { analyticsMiddleware, sendError } from './analytics.js';
+import { analyticsMiddleware, closeAnalytics, sendError } from './analytics.js';
 import { isAxiosError } from 'axios';
 import { matchErrorCode } from './errors.js';
 import { showHelp } from './help.js';
@@ -96,6 +96,12 @@ builder = builder
         type: 'string',
         default: currentContextFile,
     },
+    color: {
+        group: 'Global options:',
+        describe: 'Colorize the output. Example: --no-color, --color false',
+        type: 'boolean',
+        default: true,
+    },
 })
     .middleware((args) => fillInArgs(args), true)
     .help(false)
@@ -156,13 +162,20 @@ builder = builder
         sendError(err || new Error(msg), matchErrorCode(msg || err?.message));
         log.error(msg || err?.message);
     }
+    await closeAnalytics();
     err?.stack && log.debug('Stack: %s', err.stack);
     process.exit(1);
 });
 (async () => {
-    const args = await builder.argv;
-    if (args._.length === 0 || args.help) {
-        await showHelp(builder);
-        process.exit(0);
+    try {
+        const args = await builder.argv;
+        if (args._.length === 0 || args.help) {
+            await showHelp(builder);
+            process.exit(0);
+        }
+        await closeAnalytics();
+    }
+    catch {
+        // noop
     }
 })();

package/package.json

@@ -5,7 +5,7 @@
     "url": "git+ssh://git@github.com/neondatabase/neonctl.git"
   },
   "type": "module",
-  "version": "1.29.5",
+  "version": "1.31.0",
   "description": "CLI tool for NeonDB Cloud management",
   "main": "index.js",
   "author": "NeonDB",
@@ -29,6 +29,7 @@
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@types/cli-table": "^0.3.0",
+    "@types/diff": "^5.2.1",
     "@types/express": "^4.17.17",
     "@types/inquirer": "^9.0.3",
     "@types/node": "^18.7.13",
@@ -53,12 +54,13 @@
     "typescript": "^4.7.4"
   },
   "dependencies": {
-    "@neondatabase/api-client": "1.5.0",
+    "@neondatabase/api-client": "1.9.0",
     "@segment/analytics-node": "^1.0.0-beta.26",
     "axios": "^1.4.0",
     "axios-debug-log": "^1.0.0",
     "chalk": "^5.2.0",
     "cli-table": "^0.3.11",
+    "diff": "^5.2.0",
     "inquirer": "^9.2.6",
     "open": "^10.1.0",
     "openid-client": "^5.6.5",

package/parameters.gen.js

@@ -30,10 +30,15 @@ export const projectCreateRequest = {
         description: "A list of IP addresses that are allowed to connect to the endpoint.",
         demandOption: false,
     },
+    'project.settings.allowed_ips.protected_branches_only': {
+        type: "boolean",
+        description: "If true, the list will be applied only to protected branches.",
+        demandOption: false,
+    },
     'project.settings.allowed_ips.primary_branch_only': {
         type: "boolean",
-        description: "If true, the list will be applied only to the primary branch.",
-        demandOption: true,
+        description: "If true, the list will be applied only to the default branch.",
+        demandOption: false,
     },
     'project.settings.enable_logical_replication': {
         type: "boolean",
@@ -91,6 +96,11 @@ export const projectCreateRequest = {
         description: "The number of seconds to retain the point-in-time restore (PITR) backup history for this project.\nThe default is 604800 seconds (7 days).\n",
         demandOption: false,
     },
+    'project.org_id': {
+        type: "string",
+        description: "Organization id in case the project created belongs to an organization.\nIf not present, project is owned by a user and not by org.\n",
+        demandOption: false,
+    },
 };
 export const projectUpdateRequest = {
     'project.settings.quota.active_time_seconds': {
@@ -123,10 +133,15 @@ export const projectUpdateRequest = {
         description: "A list of IP addresses that are allowed to connect to the endpoint.",
         demandOption: false,
     },
+    'project.settings.allowed_ips.protected_branches_only': {
+        type: "boolean",
+        description: "If true, the list will be applied only to protected branches.",
+        demandOption: false,
+    },
     'project.settings.allowed_ips.primary_branch_only': {
         type: "boolean",
-        description: "If true, the list will be applied only to the primary branch.",
-        demandOption: true,
+        description: "If true, the list will be applied only to the default branch.",
+        demandOption: false,
     },
     'project.settings.enable_logical_replication': {
         type: "boolean",
@@ -157,7 +172,7 @@ export const branchCreateRequest = {
     },
     'branch.parent_id': {
         type: "string",
-        description: "The `branch_id` of the parent branch. If omitted or empty, the branch will be created from the project's primary branch.\n",
+        description: "The `branch_id` of the parent branch. If omitted or empty, the branch will be created from the project's default branch.\n",
         demandOption: false,
     },
     'branch.name': {

package/utils/enrichers.js

@@ -25,11 +25,11 @@ export const branchIdFromProps = async (props) => {
         });
     }
     const { data } = await props.apiClient.listProjectBranches(props.projectId);
-    const primaryBranch = data.branches.find((b) => b.primary);
-    if (primaryBranch) {
-        return primaryBranch.id;
+    const defaultBranch = data.branches.find((b) => b.default);
+    if (defaultBranch) {
+        return defaultBranch.id;
     }
-    throw new Error('No primary branch found');
+    throw new Error('No default branch found');
 };
 export const fillSingleProject = async (props) => {
     if (props.projectId) {

package/utils/point_in_time.js

@@ -18,8 +18,14 @@ export const parsePITBranch = (input) => {
                 ? { tag: 'lsn', lsn: exactPIT }
                 : { tag: 'timestamp', timestamp: exactPIT }),
     };
-    if (result.tag === 'timestamp' && !looksLikeTimestamp(result.timestamp)) {
-        throw new PointInTimeParseError('Invalid source branch format');
+    if (result.tag === 'timestamp') {
+        const timestamp = result.timestamp;
+        if (!looksLikeTimestamp(timestamp)) {
+            throw new PointInTimeParseError(`Invalid source branch format - ${input}`);
+        }
+        if (Date.parse(timestamp) > Date.now()) {
+            throw new PointInTimeParseError(`Timestamp can not be in future - ${input}`);
+        }
     }
     return result;
 };

package/writer.js

@@ -71,6 +71,9 @@ export const writer = (props) => {
             chunks.push({ data, config });
             return this;
         },
+        text(data) {
+            return out.write(data);
+        },
         end: (...args) => {
             if (args.length === 2) {
                 chunks.push({ data: args[0], config: args[1] });