@parix/cli 0.1.5

package/dist/lib/session.d.cts

@@ -0,0 +1,28 @@
+export interface StoredSession {
+    version: 2;
+    baseUrl: string;
+    accessToken: string;
+    accessTokenExpiresAt: string;
+    refreshToken: string | null;
+    scopes: string[];
+    tokenType: string;
+    createdAt: string;
+    updatedAt: string;
+    user: {
+        id: string;
+        email: string | null;
+        emailVerified: boolean | null;
+        name: string | null;
+        image: string | null;
+    };
+    organization: {
+        id: string | null;
+        memberRole: string | null;
+        name: string | null;
+        slug: string | null;
+    };
+}
+export declare const SESSION_FILE_PATH: string;
+export declare function readStoredSession(): Promise<StoredSession | null>;
+export declare function writeStoredSession(session: StoredSession): Promise<void>;
+export declare function clearStoredSession(): Promise<void>;

package/dist/lib/session.d.ts

@@ -0,0 +1,28 @@
+export interface StoredSession {
+    version: 2;
+    baseUrl: string;
+    accessToken: string;
+    accessTokenExpiresAt: string;
+    refreshToken: string | null;
+    scopes: string[];
+    tokenType: string;
+    createdAt: string;
+    updatedAt: string;
+    user: {
+        id: string;
+        email: string | null;
+        emailVerified: boolean | null;
+        name: string | null;
+        image: string | null;
+    };
+    organization: {
+        id: string | null;
+        memberRole: string | null;
+        name: string | null;
+        slug: string | null;
+    };
+}
+export declare const SESSION_FILE_PATH: string;
+export declare function readStoredSession(): Promise<StoredSession | null>;
+export declare function writeStoredSession(session: StoredSession): Promise<void>;
+export declare function clearStoredSession(): Promise<void>;

package/dist/lib/session.js

@@ -0,0 +1,74 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export const SESSION_FILE_PATH = join(homedir(), '.config', 'parix', 'session.json');
+export async function readStoredSession() {
+    try {
+        const raw = await readFile(SESSION_FILE_PATH, 'utf8');
+        return parseStoredSession(JSON.parse(raw));
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        if (error instanceof SyntaxError) {
+            throw new TypeError(`Failed to parse ${SESSION_FILE_PATH}`);
+        }
+        throw error;
+    }
+}
+export async function writeStoredSession(session) {
+    await mkdir(dirname(SESSION_FILE_PATH), { recursive: true });
+    await writeFile(SESSION_FILE_PATH, `${JSON.stringify(session, null, 2)}\n`, 'utf8');
+}
+export async function clearStoredSession() {
+    await rm(SESSION_FILE_PATH, { force: true });
+}
+function parseStoredSession(value) {
+    if (!value || typeof value !== 'object') {
+        throw new Error(`Invalid session data in ${SESSION_FILE_PATH}`);
+    }
+    const row = value;
+    const user = row.user;
+    const organization = row.organization;
+    if (row.version !== 2 ||
+        typeof row.baseUrl !== 'string' ||
+        typeof row.accessToken !== 'string' ||
+        typeof row.accessTokenExpiresAt !== 'string' ||
+        typeof row.createdAt !== 'string' ||
+        !Array.isArray(row.scopes) ||
+        typeof row.tokenType !== 'string' ||
+        typeof row.updatedAt !== 'string' ||
+        !user ||
+        typeof user.id !== 'string' ||
+        !organization) {
+        throw new Error(`Invalid session data in ${SESSION_FILE_PATH}`);
+    }
+    return {
+        version: 2,
+        accessToken: row.accessToken,
+        accessTokenExpiresAt: row.accessTokenExpiresAt,
+        baseUrl: row.baseUrl,
+        createdAt: row.createdAt,
+        refreshToken: typeof row.refreshToken === 'string' ? row.refreshToken : null,
+        scopes: row.scopes.filter((scope) => typeof scope === 'string'),
+        tokenType: row.tokenType,
+        updatedAt: row.updatedAt,
+        user: {
+            id: user.id,
+            email: typeof user.email === 'string' ? user.email : null,
+            emailVerified: typeof user.emailVerified === 'boolean' ? user.emailVerified : null,
+            name: typeof user.name === 'string' ? user.name : null,
+            image: typeof user.image === 'string' ? user.image : null,
+        },
+        organization: {
+            id: typeof organization.id === 'string' ? organization.id : null,
+            memberRole: typeof organization.memberRole === 'string' ? organization.memberRole : null,
+            name: typeof organization.name === 'string' ? organization.name : null,
+            slug: typeof organization.slug === 'string' ? organization.slug : null,
+        },
+    };
+}
+function isMissingFileError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}

package/dist/lib/tb-payloads.cjs

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tbOperationNames = void 0;
+exports.resolveTbPayload = resolveTbPayload;
+exports.buildCreateAccountsPayload = buildCreateAccountsPayload;
+exports.buildCreateTransfersPayload = buildCreateTransfersPayload;
+exports.buildLookupPayload = buildLookupPayload;
+exports.buildAccountFilterPayload = buildAccountFilterPayload;
+exports.buildQueryPayload = buildQueryPayload;
+const promises_1 = require("node:fs/promises");
+const SPLIT_IDS_REGEX = /[\s,]+/;
+const FLAG_NAME_TO_BIT = new Map([
+    ['linked', 1 << 0],
+    ['debits_must_not_exceed_credits', 1 << 1],
+    ['credits_must_not_exceed_debits', 1 << 2],
+    ['history', 1 << 3],
+    ['imported', 1 << 4],
+    ['closed', 1 << 5],
+    ['pending', 1 << 1],
+    ['post_pending_transfer', 1 << 2],
+    ['void_pending_transfer', 1 << 3],
+    ['balancing_debit', 1 << 4],
+    ['balancing_credit', 1 << 5],
+    ['closing_debit', 1 << 6],
+    ['closing_credit', 1 << 7],
+    ['debits', 1 << 0],
+    ['credits', 1 << 1],
+    ['reversed', 1 << 2],
+]);
+exports.tbOperationNames = [
+    'create_accounts',
+    'create_transfers',
+    'lookup_accounts',
+    'lookup_transfers',
+    'get_account_transfers',
+    'get_account_balances',
+    'query_accounts',
+    'query_transfers',
+];
+async function resolveTbPayload(options, buildFromFlags) {
+    if (options.file) {
+        return JSON.parse(await (0, promises_1.readFile)(options.file, 'utf8'));
+    }
+    if (options.payload) {
+        return JSON.parse(options.payload);
+    }
+    return buildFromFlags();
+}
+function buildCreateAccountsPayload(options) {
+    return [
+        omitEmpty({
+            code: requiredValue(options.code, '--code'),
+            flags: flagsBitfield(options.flags),
+            id: options.id ?? randomTbId(),
+            ledger: requiredValue(options.ledger, '--ledger'),
+            user_data_128: options.userData128,
+            user_data_32: options.userData32,
+            user_data_64: options.userData64,
+        }),
+    ];
+}
+function buildCreateTransfersPayload(options) {
+    return [
+        omitEmpty({
+            amount: requiredValue(options.amount, '--amount'),
+            code: requiredValue(options.code, '--code'),
+            credit_account_id: requiredValue(options.creditAccountId, '--to'),
+            debit_account_id: requiredValue(options.debitAccountId, '--from'),
+            flags: flagsBitfield(options.flags),
+            id: options.id ?? randomTbId(),
+            ledger: requiredValue(options.ledger, '--ledger'),
+            pending_id: options.pendingId,
+            timeout: options.timeout,
+        }),
+    ];
+}
+function buildLookupPayload(options) {
+    const ids = [...(options.id ?? []), ...splitIds(options.ids)];
+    if (ids.length === 0) {
+        throw new Error('Provide at least one `--id` or `--ids` value.');
+    }
+    return ids;
+}
+function buildAccountFilterPayload(options) {
+    return omitEmpty({
+        account_id: requiredValue(options.accountId, '--account-id'),
+        code: options.code,
+        flags: flagsBitfield(options.flags),
+        limit: requiredValue(options.limit, '--limit'),
+        timestamp_max: options.timestampMax,
+        timestamp_min: options.timestampMin,
+        user_data_128: options.userData128,
+        user_data_32: options.userData32,
+        user_data_64: options.userData64,
+    });
+}
+function buildQueryPayload(options) {
+    return omitEmpty({
+        code: options.code,
+        flags: flagsBitfield(options.flags),
+        ledger: options.ledger,
+        limit: requiredValue(options.limit, '--limit'),
+        timestamp_max: options.timestampMax,
+        timestamp_min: options.timestampMin,
+        user_data_128: options.userData128,
+        user_data_32: options.userData32,
+        user_data_64: options.userData64,
+    });
+}
+function flagsBitfield(flags) {
+    if (!flags || flags.length === 0) {
+        return '0';
+    }
+    let bitfield = 0;
+    for (const flag of flags) {
+        const normalized = flag.trim();
+        if (!normalized) {
+            continue;
+        }
+        const direct = Number.parseInt(normalized, 10);
+        if (Number.isInteger(direct) && direct >= 0) {
+            bitfield |= direct;
+            continue;
+        }
+        const bit = FLAG_NAME_TO_BIT.get(normalized);
+        if (bit === undefined) {
+            throw new Error(`Unsupported flag: ${flag}`);
+        }
+        bitfield |= bit;
+    }
+    return bitfield.toString();
+}
+function omitEmpty(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined && value.trim().length > 0));
+}
+function randomTbId() {
+    return BigInt(`0x${crypto.getRandomValues(new Uint8Array(16)).reduce((value, byte) => value + byte.toString(16).padStart(2, '0'), '')}`).toString();
+}
+function requiredValue(value, flagName) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${flagName} is required unless --payload or --file is used.`);
+    }
+    return value.trim();
+}
+function splitIds(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(SPLIT_IDS_REGEX)
+        .map((item) => item.trim())
+        .filter(Boolean);
+}

package/dist/lib/tb-payloads.d.cts

@@ -0,0 +1,61 @@
+export declare const tbOperationNames: readonly ["create_accounts", "create_transfers", "lookup_accounts", "lookup_transfers", "get_account_transfers", "get_account_balances", "query_accounts", "query_transfers"];
+export type TbOperationName = (typeof tbOperationNames)[number];
+export interface PayloadOverrideOptions {
+    file?: string;
+    payload?: string;
+}
+export declare function resolveTbPayload<T>(options: PayloadOverrideOptions, buildFromFlags: () => T): Promise<T>;
+export declare function buildCreateAccountsPayload(options: {
+    code?: string;
+    flags?: string[];
+    id?: string;
+    ledger?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+}[];
+export declare function buildCreateTransfersPayload(options: {
+    amount?: string;
+    code?: string;
+    creditAccountId?: string;
+    debitAccountId?: string;
+    flags?: string[];
+    id?: string;
+    ledger?: string;
+    pendingId?: string;
+    timeout?: string;
+}): {
+    [k: string]: string | undefined;
+}[];
+export declare function buildLookupPayload(options: {
+    id?: string[];
+    ids?: string;
+}): string[];
+export declare function buildAccountFilterPayload(options: {
+    accountId?: string;
+    code?: string;
+    flags?: string[];
+    limit?: string;
+    timestampMax?: string;
+    timestampMin?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+};
+export declare function buildQueryPayload(options: {
+    code?: string;
+    flags?: string[];
+    ledger?: string;
+    limit?: string;
+    timestampMax?: string;
+    timestampMin?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+};

package/dist/lib/tb-payloads.d.ts

@@ -0,0 +1,61 @@
+export declare const tbOperationNames: readonly ["create_accounts", "create_transfers", "lookup_accounts", "lookup_transfers", "get_account_transfers", "get_account_balances", "query_accounts", "query_transfers"];
+export type TbOperationName = (typeof tbOperationNames)[number];
+export interface PayloadOverrideOptions {
+    file?: string;
+    payload?: string;
+}
+export declare function resolveTbPayload<T>(options: PayloadOverrideOptions, buildFromFlags: () => T): Promise<T>;
+export declare function buildCreateAccountsPayload(options: {
+    code?: string;
+    flags?: string[];
+    id?: string;
+    ledger?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+}[];
+export declare function buildCreateTransfersPayload(options: {
+    amount?: string;
+    code?: string;
+    creditAccountId?: string;
+    debitAccountId?: string;
+    flags?: string[];
+    id?: string;
+    ledger?: string;
+    pendingId?: string;
+    timeout?: string;
+}): {
+    [k: string]: string | undefined;
+}[];
+export declare function buildLookupPayload(options: {
+    id?: string[];
+    ids?: string;
+}): string[];
+export declare function buildAccountFilterPayload(options: {
+    accountId?: string;
+    code?: string;
+    flags?: string[];
+    limit?: string;
+    timestampMax?: string;
+    timestampMin?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+};
+export declare function buildQueryPayload(options: {
+    code?: string;
+    flags?: string[];
+    ledger?: string;
+    limit?: string;
+    timestampMax?: string;
+    timestampMin?: string;
+    userData128?: string;
+    userData32?: string;
+    userData64?: string;
+}): {
+    [k: string]: string | undefined;
+};

package/dist/lib/tb-payloads.js

@@ -0,0 +1,144 @@
+import { readFile } from 'node:fs/promises';
+const SPLIT_IDS_REGEX = /[\s,]+/;
+const FLAG_NAME_TO_BIT = new Map([
+    ['linked', 1 << 0],
+    ['debits_must_not_exceed_credits', 1 << 1],
+    ['credits_must_not_exceed_debits', 1 << 2],
+    ['history', 1 << 3],
+    ['imported', 1 << 4],
+    ['closed', 1 << 5],
+    ['pending', 1 << 1],
+    ['post_pending_transfer', 1 << 2],
+    ['void_pending_transfer', 1 << 3],
+    ['balancing_debit', 1 << 4],
+    ['balancing_credit', 1 << 5],
+    ['closing_debit', 1 << 6],
+    ['closing_credit', 1 << 7],
+    ['debits', 1 << 0],
+    ['credits', 1 << 1],
+    ['reversed', 1 << 2],
+]);
+export const tbOperationNames = [
+    'create_accounts',
+    'create_transfers',
+    'lookup_accounts',
+    'lookup_transfers',
+    'get_account_transfers',
+    'get_account_balances',
+    'query_accounts',
+    'query_transfers',
+];
+export async function resolveTbPayload(options, buildFromFlags) {
+    if (options.file) {
+        return JSON.parse(await readFile(options.file, 'utf8'));
+    }
+    if (options.payload) {
+        return JSON.parse(options.payload);
+    }
+    return buildFromFlags();
+}
+export function buildCreateAccountsPayload(options) {
+    return [
+        omitEmpty({
+            code: requiredValue(options.code, '--code'),
+            flags: flagsBitfield(options.flags),
+            id: options.id ?? randomTbId(),
+            ledger: requiredValue(options.ledger, '--ledger'),
+            user_data_128: options.userData128,
+            user_data_32: options.userData32,
+            user_data_64: options.userData64,
+        }),
+    ];
+}
+export function buildCreateTransfersPayload(options) {
+    return [
+        omitEmpty({
+            amount: requiredValue(options.amount, '--amount'),
+            code: requiredValue(options.code, '--code'),
+            credit_account_id: requiredValue(options.creditAccountId, '--to'),
+            debit_account_id: requiredValue(options.debitAccountId, '--from'),
+            flags: flagsBitfield(options.flags),
+            id: options.id ?? randomTbId(),
+            ledger: requiredValue(options.ledger, '--ledger'),
+            pending_id: options.pendingId,
+            timeout: options.timeout,
+        }),
+    ];
+}
+export function buildLookupPayload(options) {
+    const ids = [...(options.id ?? []), ...splitIds(options.ids)];
+    if (ids.length === 0) {
+        throw new Error('Provide at least one `--id` or `--ids` value.');
+    }
+    return ids;
+}
+export function buildAccountFilterPayload(options) {
+    return omitEmpty({
+        account_id: requiredValue(options.accountId, '--account-id'),
+        code: options.code,
+        flags: flagsBitfield(options.flags),
+        limit: requiredValue(options.limit, '--limit'),
+        timestamp_max: options.timestampMax,
+        timestamp_min: options.timestampMin,
+        user_data_128: options.userData128,
+        user_data_32: options.userData32,
+        user_data_64: options.userData64,
+    });
+}
+export function buildQueryPayload(options) {
+    return omitEmpty({
+        code: options.code,
+        flags: flagsBitfield(options.flags),
+        ledger: options.ledger,
+        limit: requiredValue(options.limit, '--limit'),
+        timestamp_max: options.timestampMax,
+        timestamp_min: options.timestampMin,
+        user_data_128: options.userData128,
+        user_data_32: options.userData32,
+        user_data_64: options.userData64,
+    });
+}
+function flagsBitfield(flags) {
+    if (!flags || flags.length === 0) {
+        return '0';
+    }
+    let bitfield = 0;
+    for (const flag of flags) {
+        const normalized = flag.trim();
+        if (!normalized) {
+            continue;
+        }
+        const direct = Number.parseInt(normalized, 10);
+        if (Number.isInteger(direct) && direct >= 0) {
+            bitfield |= direct;
+            continue;
+        }
+        const bit = FLAG_NAME_TO_BIT.get(normalized);
+        if (bit === undefined) {
+            throw new Error(`Unsupported flag: ${flag}`);
+        }
+        bitfield |= bit;
+    }
+    return bitfield.toString();
+}
+function omitEmpty(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined && value.trim().length > 0));
+}
+function randomTbId() {
+    return BigInt(`0x${crypto.getRandomValues(new Uint8Array(16)).reduce((value, byte) => value + byte.toString(16).padStart(2, '0'), '')}`).toString();
+}
+function requiredValue(value, flagName) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${flagName} is required unless --payload or --file is used.`);
+    }
+    return value.trim();
+}
+function splitIds(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(SPLIT_IDS_REGEX)
+        .map((item) => item.trim())
+        .filter(Boolean);
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@parix/cli",
+  "description": "Parix command line interface",
+  "type": "module",
+  "version": "0.1.5",
+  "bin": {
+    "parix": "dist/cli.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "packageManager": "bun@1.3.12",
+  "homepage": "https://github.com/parixtech/parix-cli#readme",
+  "bugs": {
+    "url": "https://github.com/parixtech/parix-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parixtech/parix-cli.git"
+  },
+  "keywords": [
+    "parix",
+    "cli",
+    "parix",
+    "database",
+    "tigerbeetle"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "zshy && node scripts/normalize-package-bin.mjs && chmod +x dist/cli.cjs",
+    "build:link": "bun run build && bun link",
+    "fmt": "oxfmt --write src test scripts package.json tsconfig.json .oxlintrc.json .oxfmtrc.json commitlint.config.js",
+    "fmt:check": "oxfmt --check src test scripts package.json tsconfig.json .oxlintrc.json .oxfmtrc.json commitlint.config.js",
+    "lint": "oxlint src test scripts",
+    "lint:fix": "oxlint --fix src test scripts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "cli": "node ./dist/cli.cjs",
+    "pack:dry-run": "npm pack --dry-run --cache .npm-cache",
+    "publish:check": "bun run fmt:check && bun run lint && bun run test && bun run typecheck && bun run build && bun run pack:dry-run",
+    "prepublishOnly": "bun run publish:check",
+    "publish:npm": "npm publish --access public --cache .npm-cache",
+    "prepare": "husky"
+  },
+  "zshy": {
+    "bin": {
+      "parix": "./src/cli.ts"
+    }
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.0",
+    "@types/node": "^25.3.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "oxfmt": "^0.46.0",
+    "oxlint": "^1.61.0",
+    "typescript": "^5.9.3",
+    "zshy": "^0.7.0"
+  },
+  "lint-staged": {
+    "*.{js,ts,json}": [
+      "oxfmt --write"
+    ],
+    "*.{js,ts}": [
+      "oxlint --fix src test scripts"
+    ]
+  }
+}