gudong-inbox-cli 1.0.0

package/dist/index.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { createRequire } from 'node:module';
+import { loadConfig, saveConfig, configExists, getConfigPath } from './config.js';
+import { createCloudProvider, notesDirFor } from './cloud/factory.js';
+import { NoteService } from './note/service.js';
+// Read version from package.json so it stays in sync automatically.
+const require = createRequire(import.meta.url);
+const VERSION = require('../package.json').version;
+function printHelp() {
+    const text = `
+gudong-inbox v${VERSION} — read and write your inBox notes from the command line.
+
+Usage:
+  gudong-inbox list [--limit N] [--since ISO] [--until ISO] [--field updated_at|created_at]
+  gudong-inbox read --id <20-hex-id>
+  gudong-inbox search --query "keyword" [--limit N]
+  gudong-inbox tags
+  gudong-inbox create --content "text" [--title "title"] [--tag tag1] [--tag tag2] [--box name]
+  gudong-inbox update --id <id> [--content "text"] [--title "title"] [--tag tag1]
+  gudong-inbox delete --id <id> --confirm
+  gudong-inbox config init   Set up credentials (interactive or via flags)
+  gudong-inbox config show   Show current config (secrets masked)
+  gudong-inbox config test   Test connection to cloud storage
+  gudong-inbox --version
+  gudong-inbox --help
+
+Examples:
+  gudong-inbox list --limit 5
+  gudong-inbox list --since 2026-06-25T00:00:00+08:00 --field created_at
+  gudong-inbox search --query "Flutter" --limit 10
+  gudong-inbox read --id b10a4576df11401c8673
+  gudong-inbox create --content "hello world" --title "test" --tag idea
+
+Config:
+  ~/.gudong-inbox/config.json  (primary, created by \`config init\`)
+  Environment variables     (fallback: CLOUD_TYPE, S3_ENDPOINT, S3_BUCKET, ...)
+`;
+    console.log(text);
+}
+function output(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function getService() {
+    const cfg = loadConfig();
+    const cloud = createCloudProvider(cfg);
+    const dir = notesDirFor(cfg.workDir, cfg.cloudType);
+    return new NoteService(cloud, dir, { cacheTtlMs: cfg.cacheTtlMs });
+}
+// --- helpers for parseArgs ---
+function getArg(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? v : undefined;
+}
+function getArgNumber(args, key) {
+    const v = args[key];
+    return typeof v === 'string' ? Number(v) : undefined;
+}
+function getArgArray(args, key) {
+    const v = args[key];
+    if (Array.isArray(v))
+        return v;
+    if (typeof v === 'string')
+        return [v];
+    return undefined;
+}
+function getArgBool(args, key) {
+    const v = args[key];
+    return v === true || v === 'true';
+}
+// --- command handlers ---
+async function cmdList(args) {
+    const svc = getService();
+    const limit = getArgNumber(args, 'limit') ?? 20;
+    const since = getArg(args, 'since');
+    const until = getArg(args, 'until');
+    const field = (getArg(args, 'field') ?? 'updated_at');
+    const notes = await svc.listRecent({ limit, since, until, date_field: field });
+    output({ count: notes.length, notes });
+}
+async function cmdRead(args) {
+    const id = getArg(args, 'id');
+    if (!id)
+        return fail('--id is required');
+    const svc = getService();
+    const note = await svc.readById(id);
+    if (!note)
+        return fail(`note not found: ${id}`);
+    output(note);
+}
+async function cmdSearch(args) {
+    const query = getArg(args, 'query');
+    if (!query)
+        return fail('--query is required');
+    const limit = getArgNumber(args, 'limit') ?? 20;
+    const svc = getService();
+    const notes = await svc.search(query, limit);
+    output({ query, count: notes.length, notes });
+}
+async function cmdTags() {
+    const svc = getService();
+    const tags = await svc.listTags();
+    output({ count: tags.length, tags });
+}
+async function cmdCreate(args) {
+    const content = getArg(args, 'content');
+    if (!content)
+        return fail('--content is required');
+    const svc = getService();
+    const result = await svc.createNote({
+        content,
+        title: getArg(args, 'title'),
+        tags: getArgArray(args, 'tag'),
+        box: getArg(args, 'box'),
+    });
+    output({ success: true, ...result });
+}
+async function cmdUpdate(args) {
+    const id = getArg(args, 'id');
+    if (!id)
+        return fail('--id is required');
+    const svc = getService();
+    const result = await svc.updateNote({
+        id,
+        content: getArg(args, 'content'),
+        title: getArg(args, 'title'),
+        tags: getArgArray(args, 'tag'),
+        box: getArg(args, 'box'),
+    });
+    output({ success: true, ...result });
+}
+async function cmdDelete(args) {
+    const id = getArg(args, 'id');
+    if (!id)
+        return fail('--id is required');
+    if (!getArgBool(args, 'confirm'))
+        return fail('--confirm is required to delete');
+    const svc = getService();
+    const result = await svc.deleteNote(id);
+    output({ success: true, ...result });
+}
+// --- config commands ---
+async function cmdConfigInit(args) {
+    const cloudType = getArg(args, 'cloud-type') ?? getArg(args, 'cloud_type');
+    if (!cloudType) {
+        console.log(`
+gudong-inbox config init
+
+Usage:
+  gudong-inbox config init --cloud-type s3 \\
+    --endpoint https://s3.example.com \\
+    --bucket my-bucket \\
+    --access-key AKID... \\
+    --secret-key SECRET... \\
+    [--region cn-south-1] \\
+    [--force-path-style] \\
+    [--work-dir inBox]
+
+  gudong-inbox config init --cloud-type webdav \\
+    --url https://dav.example.com/path \\
+    --username user \\
+    --password pass \\
+    [--work-dir inBox]
+`);
+        return;
+    }
+    const workDir = getArg(args, 'work-dir') ?? getArg(args, 'work_dir') ?? 'inBox';
+    const cfg = { cloud_type: cloudType, work_dir: workDir };
+    if (cloudType === 's3') {
+        const endpoint = getArg(args, 'endpoint');
+        const bucket = getArg(args, 'bucket');
+        const accessKey = getArg(args, 'access-key') ?? getArg(args, 'access_key');
+        const secretKey = getArg(args, 'secret-key') ?? getArg(args, 'secret_key');
+        const region = getArg(args, 'region') ?? 'auto';
+        const forcePathStyle = args['force-path-style'] === true || args['force-path-style'] === 'true';
+        if (!endpoint)
+            return fail('--endpoint is required');
+        if (!bucket)
+            return fail('--bucket is required');
+        if (!accessKey)
+            return fail('--access-key is required');
+        if (!secretKey)
+            return fail('--secret-key is required');
+        cfg.s3 = { endpoint, bucket, accessKey, secretKey, region, forcePathStyle };
+    }
+    else if (cloudType === 'webdav') {
+        const url = getArg(args, 'url');
+        const username = getArg(args, 'username');
+        const password = getArg(args, 'password');
+        if (!url)
+            return fail('--url is required');
+        if (!username)
+            return fail('--username is required');
+        if (!password)
+            return fail('--password is required');
+        cfg.webdav = { url, username, password };
+    }
+    else {
+        return fail(`unknown cloud type: ${cloudType}`);
+    }
+    saveConfig(cfg);
+    console.log(`Config saved to ${getConfigPath()}`);
+}
+async function cmdConfigShow() {
+    if (!configExists()) {
+        console.log('No config found. Run `gudong-inbox config init` first.');
+        return;
+    }
+    const { readFileSync } = await import('node:fs');
+    const text = readFileSync(getConfigPath(), 'utf-8');
+    const cfg = JSON.parse(text);
+    // Mask secrets
+    if (cfg.s3) {
+        if (cfg.s3.accessKey)
+            cfg.s3.accessKey = mask(cfg.s3.accessKey);
+        if (cfg.s3.secretKey)
+            cfg.s3.secretKey = '***';
+    }
+    if (cfg.webdav) {
+        if (cfg.webdav.password)
+            cfg.webdav.password = '***';
+    }
+    output(cfg);
+}
+function mask(s) {
+    if (s.length <= 4)
+        return '***';
+    return s.slice(0, 2) + '***' + s.slice(-2);
+}
+async function cmdConfigTest() {
+    const cfg = loadConfig();
+    const cloud = createCloudProvider(cfg);
+    const dir = notesDirFor(cfg.workDir, cfg.cloudType);
+    const svc = new NoteService(cloud, dir, { cacheTtlMs: 0 });
+    const notes = await svc.fetchAll();
+    output({
+        status: 'ok',
+        cloud_type: cfg.cloudType,
+        work_dir: cfg.workDir,
+        notes_dir: dir,
+        total_notes: notes.length,
+    });
+}
+function fail(msg) {
+    console.error(`[gudong-inbox] ${msg}`);
+    process.exit(1);
+}
+// --- main ---
+function main() {
+    const argv = process.argv.slice(2);
+    if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+        printHelp();
+        return;
+    }
+    if (argv[0] === '--version' || argv[0] === '-v') {
+        console.log(VERSION);
+        return;
+    }
+    const command = argv[0];
+    const rest = argv.slice(1);
+    // For multi-value options like --tag, parseArgs needs special handling
+    // We use { multiple: true } for --tag only
+    if (command === 'config') {
+        const subCmd = rest[0] ?? '';
+        const configArgs = rest.slice(1);
+        if (subCmd === 'init') {
+            const { values } = parseArgs({
+                args: configArgs,
+                options: {
+                    'cloud-type': { type: 'string' },
+                    'cloud_type': { type: 'string' },
+                    endpoint: { type: 'string' },
+                    bucket: { type: 'string' },
+                    'access-key': { type: 'string' },
+                    'access_key': { type: 'string' },
+                    'secret-key': { type: 'string' },
+                    'secret_key': { type: 'string' },
+                    region: { type: 'string' },
+                    'force-path-style': { type: 'boolean' },
+                    url: { type: 'string' },
+                    username: { type: 'string' },
+                    password: { type: 'string' },
+                    'work-dir': { type: 'string' },
+                    'work_dir': { type: 'string' },
+                },
+                allowNegative: true,
+            });
+            cmdConfigInit(values).catch((e) => fail(e.message));
+        }
+        else if (subCmd === 'show') {
+            cmdConfigShow().catch((e) => fail(e.message));
+        }
+        else if (subCmd === 'test') {
+            cmdConfigTest().catch((e) => fail(e.message));
+        }
+        else {
+            console.log('Usage: gudong-inbox config <init|show|test>');
+        }
+        return;
+    }
+    const baseOptions = {
+        limit: { type: 'string' },
+        since: { type: 'string' },
+        until: { type: 'string' },
+        field: { type: 'string' },
+        id: { type: 'string' },
+        query: { type: 'string' },
+        content: { type: 'string' },
+        title: { type: 'string' },
+        box: { type: 'string' },
+        confirm: { type: 'boolean' },
+    };
+    // --tag can appear multiple times, needs { multiple: true }
+    const hasTag = rest.includes('--tag');
+    if (hasTag) {
+        const { values } = parseArgs({
+            args: rest,
+            options: { ...baseOptions, tag: { type: 'string', multiple: true } },
+            allowNegative: true,
+        });
+        const tagArr = values.tag;
+        delete values.tag;
+        runCommand(command, values, tagArr).catch((e) => fail(e.message));
+    }
+    else {
+        const { values } = parseArgs({
+            args: rest,
+            options: baseOptions,
+            allowNegative: true,
+        });
+        runCommand(command, values).catch((e) => fail(e.message));
+    }
+}
+async function runCommand(cmd, args, tags) {
+    if (tags)
+        args.tag = tags;
+    switch (cmd) {
+        case 'list': return cmdList(args);
+        case 'read': return cmdRead(args);
+        case 'search': return cmdSearch(args);
+        case 'tags': return cmdTags();
+        case 'create': return cmdCreate(args);
+        case 'update': return cmdUpdate(args);
+        case 'delete': return cmdDelete(args);
+        default:
+            console.error(`Unknown command: ${cmd}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/note/parser.d.ts

@@ -0,0 +1,2 @@
+import type { NoteJson } from './types.js';
+export declare function parseNote(id: string, raw: Buffer | string): NoteJson;

package/dist/note/parser.js

@@ -0,0 +1,110 @@
+const ASSET_TYPES = ['image', 'video', 'audio', 'attachment'];
+const STORAGE_TYPES = [
+    'local',
+    'webdav',
+    's3',
+    'minio',
+    'aliyun',
+    'tencent',
+    'generic',
+];
+function str(x, fallback = '') {
+    return typeof x === 'string' ? x : fallback;
+}
+function strOrNull(x) {
+    return typeof x === 'string' ? x : null;
+}
+function num(x, fallback = 0) {
+    return typeof x === 'number' && Number.isFinite(x) ? x : fallback;
+}
+function numOrNull(x) {
+    return typeof x === 'number' && Number.isFinite(x) ? x : null;
+}
+function bool(x, fallback = false) {
+    return typeof x === 'boolean' ? x : fallback;
+}
+function asStringArray(x) {
+    return Array.isArray(x) ? x.filter((v) => typeof v === 'string') : [];
+}
+function parseLink(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const obj = raw;
+    const targetId = str(obj.targetId);
+    if (!/^[a-f0-9]{20}$/.test(targetId))
+        return null;
+    return {
+        text: typeof obj.text === 'string' || obj.text === null ? obj.text : null,
+        targetId,
+    };
+}
+function parseAsset(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const obj = raw;
+    const type = str(obj.type);
+    const path = str(obj.path);
+    if (!ASSET_TYPES.includes(type))
+        return null;
+    if (!path)
+        return null;
+    const storageRaw = str(obj.storageType, 'local');
+    const storageType = STORAGE_TYPES.includes(storageRaw)
+        ? storageRaw
+        : 'local';
+    return {
+        type: type,
+        path,
+        storageType,
+        cloudUrl: strOrNull(obj.cloudUrl),
+        mime_type: str(obj.mime_type),
+        size: num(obj.size, 0),
+        width: numOrNull(obj.width),
+        height: numOrNull(obj.height),
+        duration: numOrNull(obj.duration),
+    };
+}
+export function parseNote(id, raw) {
+    const text = typeof raw === 'string' ? raw : raw.toString('utf-8');
+    const d = JSON.parse(text);
+    const metaSrc = (d.meta ?? {});
+    const contentSrc = (d.content ?? {});
+    const flagsSrc = (d.flags ?? {});
+    const meta = {
+        created_at: str(metaSrc.created_at),
+        updated_at: str(metaSrc.updated_at),
+        device_id: str(metaSrc.device_id),
+    };
+    const links = Array.isArray(contentSrc.links)
+        ? contentSrc.links.map(parseLink).filter((l) => l !== null)
+        : [];
+    const assets = Array.isArray(contentSrc.assets)
+        ? contentSrc.assets.map(parseAsset).filter((a) => a !== null)
+        : [];
+    const content = {
+        content: str(contentSrc.content),
+        title: strOrNull(contentSrc.title),
+        tags: asStringArray(contentSrc.tags),
+        links,
+        assets,
+        box: strOrNull(contentSrc.box),
+    };
+    const flags = {
+        is_removed: bool(flagsSrc.is_removed, false),
+        is_top: bool(flagsSrc.is_top, false),
+        favorite: bool(flagsSrc.favorite, false),
+    };
+    const parentIdRaw = d.parent_id;
+    const parent_id = typeof parentIdRaw === 'string' && /^[a-f0-9]{20}$/.test(parentIdRaw)
+        ? parentIdRaw
+        : null;
+    return {
+        id,
+        ver: num(d.ver, 1),
+        meta,
+        content,
+        flags,
+        parent_id,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/note/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/note/parser.ts"],"names":[],"mappings":"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"}

package/dist/note/parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/note/parser.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect } from 'vitest';
+import { parseNote } from './parser.js';
+const VALID_ID = 'b10a4576df11401c8673';
+function makeNoteJson(overrides = {}) {
+    return JSON.stringify({
+        id: VALID_ID,
+        ver: 1,
+        meta: {
+            created_at: '2026-06-01T00:00:00.000Z',
+            updated_at: '2026-06-02T00:00:00.000Z',
+            device_id: 'test-device',
+        },
+        content: {
+            content: 'hello world',
+            title: 'Test Note',
+            tags: ['idea', 'work'],
+            links: [{ text: 'ref', targetId: 'a'.repeat(20) }],
+            assets: [
+                {
+                    type: 'image',
+                    path: '/img/photo.jpg',
+                    storageType: 's3',
+                    mime_type: 'image/jpeg',
+                    size: 1024,
+                },
+            ],
+        },
+        flags: {
+            is_removed: false,
+            is_top: true,
+            favorite: false,
+        },
+        ...overrides,
+    });
+}
+describe('parseNote', () => {
+    it('parses a valid note JSON', () => {
+        const note = parseNote(VALID_ID, makeNoteJson());
+        expect(note.id).toBe(VALID_ID);
+        expect(note.ver).toBe(1);
+        expect(note.meta.created_at).toBe('2026-06-01T00:00:00.000Z');
+        expect(note.meta.updated_at).toBe('2026-06-02T00:00:00.000Z');
+        expect(note.content.content).toBe('hello world');
+        expect(note.content.title).toBe('Test Note');
+        expect(note.content.tags).toEqual(['idea', 'work']);
+        expect(note.flags.is_top).toBe(true);
+        expect(note.flags.is_removed).toBe(false);
+    });
+    it('handles content as an array (legacy format)', () => {
+        const json = makeNoteJson({
+            content: { content: ['line1', 'line2'], tags: [] },
+        });
+        const note = parseNote(VALID_ID, json);
+        expect(note.content.content).toBe('');
+    });
+    it('handles null title', () => {
+        const json = makeNoteJson({
+            content: { content: 'test', title: null, tags: [], links: [], assets: [] },
+        });
+        const note = parseNote(VALID_ID, json);
+        expect(note.content.title).toBeNull();
+    });
+    it('filters out invalid links (bad targetId)', () => {
+        const json = makeNoteJson({
+            content: {
+                content: 'test',
+                tags: [],
+                links: [
+                    { text: 'good', targetId: 'a'.repeat(20) },
+                    { text: 'bad', targetId: 'short' },
+                ],
+                assets: [],
+            },
+        });
+        const note = parseNote(VALID_ID, json);
+        expect(note.content.links).toHaveLength(1);
+        expect(note.content.links[0].targetId).toBe('a'.repeat(20));
+    });
+    it('filters out invalid assets (missing path)', () => {
+        const json = makeNoteJson({
+            content: {
+                content: 'test',
+                tags: [],
+                links: [],
+                assets: [
+                    { type: 'image', path: '/ok.jpg', storageType: 'local', mime_type: '', size: 0 },
+                    { type: 'image', path: '', storageType: 'local', mime_type: '', size: 0 },
+                ],
+            },
+        });
+        const note = parseNote(VALID_ID, json);
+        expect(note.content.assets).toHaveLength(1);
+    });
+    it('defaults flags to false when missing', () => {
+        const json = makeNoteJson({ flags: {} });
+        const note = parseNote(VALID_ID, json);
+        expect(note.flags.is_removed).toBe(false);
+        expect(note.flags.is_top).toBe(false);
+        expect(note.flags.favorite).toBe(false);
+    });
+    it('handles parent_id', () => {
+        const json = makeNoteJson({ parent_id: 'b'.repeat(20) });
+        const note = parseNote(VALID_ID, json);
+        expect(note.parent_id).toBe('b'.repeat(20));
+    });
+    it('rejects invalid parent_id (non-hex)', () => {
+        const json = makeNoteJson({ parent_id: 'invalid' });
+        const note = parseNote(VALID_ID, json);
+        expect(note.parent_id).toBeNull();
+    });
+    it('accepts Buffer input', () => {
+        const json = makeNoteJson();
+        const note = parseNote(VALID_ID, Buffer.from(json, 'utf-8'));
+        expect(note.id).toBe(VALID_ID);
+    });
+    it('falls back gracefully for unknown asset/storage types', () => {
+        const json = makeNoteJson({
+            content: {
+                content: 'test',
+                tags: [],
+                links: [],
+                assets: [
+                    {
+                        type: 'mystery',
+                        path: '/x.dat',
+                        storageType: 'unknown_storage',
+                        mime_type: '',
+                        size: 0,
+                    },
+                ],
+            },
+        });
+        const note = parseNote(VALID_ID, json);
+        expect(note.content.assets).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/note/parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../../src/note/parser.test.ts"],"names":[],"mappings":"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"}