@rewrlution/papyrus-cli 0.0.1

package/dist/lib/api/api-client.js

@@ -0,0 +1,111 @@
+import axios from 'axios';
+import { tokenStore } from '../storage/index.js';
+/**
+ * API Client for Papyrus server
+ * Uses shared types and storage layer for tokens
+ *
+ * Error handling strategy:
+ * - Validation errors: Caught by Zod client-side (before API call)
+ * - API errors: Descriptive messages from ApiErrorResponse
+ * - Network errors: Wrapped with descriptive message
+ */
+export class ApiClient {
+    http;
+    constructor(baseUrl) {
+        this.http = axios.create({
+            baseURL: baseUrl,
+            timeout: 90000, // set api timeout to 90 sec. serverless app warm-up may take up to a minute.
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        // Add token to requests automatically from storage layer
+        this.http.interceptors.request.use((config) => {
+            const token = tokenStore.get();
+            if (token) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+            return config;
+        });
+    }
+    async register(credentials) {
+        try {
+            const response = await this.http.post('/auth/signup', credentials);
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async login(credentials) {
+        try {
+            const response = await this.http.post('/auth/signin', credentials);
+            // Save token to storage layer
+            if (response.data.data.token) {
+                tokenStore.save(response.data.data.token);
+            }
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    logout() {
+        tokenStore.clear();
+    }
+    isAuthenticated() {
+        return tokenStore.exists();
+    }
+    async listJournalsMetadata() {
+        try {
+            const response = await this.http.get('/journals/metadata');
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async getJournal(date) {
+        try {
+            const response = await this.http.get(`/journals/${date}`);
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async createJournal(date, content) {
+        try {
+            const response = await this.http.post('/journals', {
+                date,
+                content,
+            });
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    async updateJournal(date, content) {
+        try {
+            const response = await this.http.put(`/journals/${date}`, { content });
+            return response.data.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    handleError(error) {
+        if (axios.isAxiosError(error)) {
+            // API returned an error response with message
+            if (error.response?.data.message) {
+                throw new Error(error.response.data.message);
+            }
+            // Network error (connection refused, timeout, DNS failure)
+            throw new Error(`Network error: ${error.message}`);
+        }
+        // Unknown error
+        throw new Error(error instanceof Error ? error.message : 'unknown error');
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api/api-client.js.map

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

package/dist/lib/api/index.d.ts

@@ -0,0 +1,3 @@
+import { ApiClient } from './api-client.js';
+export declare const api: ApiClient;
+export { ApiClient } from './api-client.js';

package/dist/lib/api/index.js

@@ -0,0 +1,6 @@
+import { configStore } from '../storage/index.js';
+import { ApiClient } from './api-client.js';
+const API_BASE_URL = configStore.get('apiUrl') || 'http://localhost:3000/api';
+export const api = new ApiClient(API_BASE_URL);
+export { ApiClient } from './api-client.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,2BAA2B,CAAC;AAC9E,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/lib/auth/index.d.ts

@@ -0,0 +1 @@
+export { requireAuth, ensureAuthenticated, type AuthCheckResult, type RequireAuthOptions, } from './require-auth.js';

package/dist/lib/auth/index.js

@@ -0,0 +1,2 @@
+export { requireAuth, ensureAuthenticated, } from './require-auth.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC"}

package/dist/lib/auth/require-auth.d.ts

@@ -0,0 +1,67 @@
+export interface AuthCheckResult {
+    isAuthenticated: boolean;
+    isExpired: boolean;
+    isExpiringSoon: boolean;
+    timeUntilExpiration: string | null;
+    message?: string;
+}
+/**
+ * Options for authentication check
+ */
+export interface RequireAuthOptions {
+    /**
+     * Hours before expiration to consider "expiring soon"
+     * @default 24
+     */
+    expirationThresholdHours?: number;
+    /**
+     * Whether to show warnings for tokens expiring soon
+     * @default true
+     */
+    warnOnExpiringSoon?: boolean;
+}
+/**
+ * Check if user is authenticated and token is valid
+ * Returns detailed auth status for flexible handling
+ *
+ * This is the core function that any command can use to check authentication.
+ * It handles all the edge cases: missing token, expired token, invalid token,
+ * and token expiring soon.
+ *
+ * @param options - Authentication check options
+ * @returns Authentication check result with detailed status
+ *
+ * @example
+ * ```typescript
+ * // Basic usage in a command
+ * const auth = requireAuth();
+ * if (!auth.isAuthenticated) {
+ *   console.error(`Error: ${auth.message}`);
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function requireAuth(options?: RequireAuthOptions): AuthCheckResult;
+/**
+ * Ensures user is authenticated, exits process if not
+ *
+ * This is a convenience function for commands that require authentication.
+ * It checks authentication and exits with a clear error message if not authenticated.
+ * If authenticated but token is expiring soon, it shows a warning but continues.
+ *
+ * Use this in commands that MUST have authentication to proceed.
+ *
+ * @param options - Authentication check options
+ *
+ * @example
+ * ```typescript
+ * // Simplest usage - one line in your command
+ * export async function sync() {
+ *   ensureAuthenticated(); // Will exit if not authenticated
+ *
+ *   // Safe to proceed - user is authenticated
+ *   await performSync();
+ * }
+ * ```
+ */
+export declare function ensureAuthenticated(options?: RequireAuthOptions): void;

package/dist/lib/auth/require-auth.js

@@ -0,0 +1,107 @@
+import { isTokenExpired, isTokenExpiringSoon, getTimeUntilExpiration, } from '../../utils/token.js';
+import { tokenStore } from '../storage/index.js';
+/**
+ * Check if user is authenticated and token is valid
+ * Returns detailed auth status for flexible handling
+ *
+ * This is the core function that any command can use to check authentication.
+ * It handles all the edge cases: missing token, expired token, invalid token,
+ * and token expiring soon.
+ *
+ * @param options - Authentication check options
+ * @returns Authentication check result with detailed status
+ *
+ * @example
+ * ```typescript
+ * // Basic usage in a command
+ * const auth = requireAuth();
+ * if (!auth.isAuthenticated) {
+ *   console.error(`Error: ${auth.message}`);
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export function requireAuth(options = {}) {
+    const { expirationThresholdHours = 23, warnOnExpiringSoon = true } = options;
+    // Check if token exists in storage
+    if (!tokenStore.exists()) {
+        return {
+            isAuthenticated: false,
+            isExpired: false,
+            isExpiringSoon: false,
+            timeUntilExpiration: null,
+            message: 'Not authenticated. Pleas run `papyrus login` first.',
+        };
+    }
+    const token = tokenStore.get();
+    if (!token) {
+        return {
+            isAuthenticated: false,
+            isExpired: false,
+            isExpiringSoon: false,
+            timeUntilExpiration: null,
+            message: 'Invalid token. Please run `papyrus login` again.',
+        };
+    }
+    // Check if token is expired
+    if (isTokenExpired(token)) {
+        // Automatically clear expired token
+        tokenStore.clear();
+        return {
+            isAuthenticated: false,
+            isExpired: true,
+            isExpiringSoon: false,
+            timeUntilExpiration: null,
+            message: 'Your session has expired. Please run `papyrus login` again.',
+        };
+    }
+    // Check if token is expiring soon
+    const expiringSoon = isTokenExpiringSoon(token, expirationThresholdHours);
+    const timeUntilExpiration = getTimeUntilExpiration(token);
+    return {
+        isAuthenticated: true,
+        isExpired: false,
+        isExpiringSoon: expiringSoon,
+        timeUntilExpiration,
+        message: expiringSoon && warnOnExpiringSoon && timeUntilExpiration
+            ? `Your session will expire in ${timeUntilExpiration}. Please run \`papyrus login\` to refresh.`
+            : undefined,
+    };
+}
+/**
+ * Ensures user is authenticated, exits process if not
+ *
+ * This is a convenience function for commands that require authentication.
+ * It checks authentication and exits with a clear error message if not authenticated.
+ * If authenticated but token is expiring soon, it shows a warning but continues.
+ *
+ * Use this in commands that MUST have authentication to proceed.
+ *
+ * @param options - Authentication check options
+ *
+ * @example
+ * ```typescript
+ * // Simplest usage - one line in your command
+ * export async function sync() {
+ *   ensureAuthenticated(); // Will exit if not authenticated
+ *
+ *   // Safe to proceed - user is authenticated
+ *   await performSync();
+ * }
+ * ```
+ */
+export function ensureAuthenticated(options = {}) {
+    const authResult = requireAuth(options);
+    if (!authResult.isAuthenticated) {
+        console.error(`Error: ${authResult.message}`);
+        process.exit(1);
+    }
+    if (authResult.isExpired) {
+        console.error(`Error: ${authResult.message}`);
+        process.exit(1);
+    }
+    if (authResult.isExpiringSoon && authResult.message) {
+        console.warn(`Warning: ${authResult.message}`);
+    }
+}
+//# sourceMappingURL=require-auth.js.map

package/dist/lib/auth/require-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-auth.js","sourceRoot":"","sources":["../../../src/lib/auth/require-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA2BjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,EAAE,wBAAwB,GAAG,EAAE,EAAE,kBAAkB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE7E,mCAAmC;IACnC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACzB,OAAO;YACL,eAAe,EAAE,KAAK;YACtB,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,IAAI;YACzB,OAAO,EAAE,qDAAqD;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,eAAe,EAAE,KAAK;YACtB,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,IAAI;YACzB,OAAO,EAAE,kDAAkD;SAC5D,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,oCAAoC;QACpC,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO;YACL,eAAe,EAAE,KAAK;YACtB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,IAAI;YACzB,OAAO,EAAE,6DAA6D;SACvE,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC1E,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAE1D,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,YAAY;QAC5B,mBAAmB;QACnB,OAAO,EACL,YAAY,IAAI,kBAAkB,IAAI,mBAAmB;YACvD,CAAC,CAAC,+BAA+B,mBAAmB,4CAA4C;YAChG,CAAC,CAAC,SAAS;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA8B,EAAE;IAClE,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,UAAU,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,UAAU,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,CAAC,cAAc,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,YAAY,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/lib/storage/base-storage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Base storage class that follows the XDG-base directory standard
+ * and handles cross-platform directory management
+ * and common file operations
+ */
+export declare class BaseStorage {
+    /**
+     * the env-paths will add `runtime` to the path name.
+     * we must set { suffix: "" }, otherwise, in Windows,
+     * the folder will become:
+     * /c/users/{username}/appdata/local/papyrus-nodejs/data
+     * instead of
+     * /c/users/{username}/appdata/local/papyrus/data
+     */
+    private paths;
+    /**
+     * Get config directory
+     * Linux: ~/.config/papyrus
+     * Windows: %APPDATA%\papyrus\Config
+     * macOS: ~/Library/Preferences/papyrus
+     */
+    protected getConfigDir(): string;
+    /**
+     * Get data directory
+     * Linux: ~/.local/share/papyrus
+     * Windows: %LOCALAPPDATA%\papyrus\Data
+     * macOS: ~/Library/Application Support/papyrus
+     */
+    protected getDataDir(): string;
+    /**
+     * Ensure directory exists, create if it doesn't
+     */
+    protected ensureDir(dir: string): void;
+    /**
+     * Read file contents, return null if doesn't exist
+     */
+    protected readFile(filePath: string): string | null;
+    /**
+     * Write file contents, create parent directories if needed
+     */
+    protected writeFile(filePath: string, content: string): void;
+    /**
+     * Delete file if it exists
+     */
+    protected deleteFile(filePath: string): void;
+    /**
+     * Check if file exists
+     */
+    protected fileExists(filePath: string): boolean;
+}

package/dist/lib/storage/base-storage.js

@@ -0,0 +1,91 @@
+import fs from 'fs';
+import path from 'path';
+import envPaths from 'env-paths';
+/**
+ * Base storage class that follows the XDG-base directory standard
+ * and handles cross-platform directory management
+ * and common file operations
+ */
+export class BaseStorage {
+    /**
+     * the env-paths will add `runtime` to the path name.
+     * we must set { suffix: "" }, otherwise, in Windows,
+     * the folder will become:
+     * /c/users/{username}/appdata/local/papyrus-nodejs/data
+     * instead of
+     * /c/users/{username}/appdata/local/papyrus/data
+     */
+    paths = envPaths('papyrus', { suffix: '' });
+    /**
+     * Get config directory
+     * Linux: ~/.config/papyrus
+     * Windows: %APPDATA%\papyrus\Config
+     * macOS: ~/Library/Preferences/papyrus
+     */
+    getConfigDir() {
+        return this.paths.config;
+    }
+    /**
+     * Get data directory
+     * Linux: ~/.local/share/papyrus
+     * Windows: %LOCALAPPDATA%\papyrus\Data
+     * macOS: ~/Library/Application Support/papyrus
+     */
+    getDataDir() {
+        return this.paths.data;
+    }
+    /**
+     * Ensure directory exists, create if it doesn't
+     */
+    ensureDir(dir) {
+        if (!fs.existsSync(dir)) {
+            /**
+             * The mode 0o700 grants the owner of the file or directory full read, write, and execute permissions,
+             * while denying all access to everyone else.
+             * - 1st digit (7): Owner (User, with `rwx` permissions)
+             * - 2nd digit (0): Group
+             * - 3rd digit (0): Others (anyone not the owner or in the group)
+             *
+             * For directories, `x` permission is required to `cd` into a dir or access files inside
+             */
+            fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+    }
+    /**
+     * Read file contents, return null if doesn't exist
+     */
+    readFile(filePath) {
+        try {
+            if (fs.existsSync(filePath)) {
+                return fs.readFileSync(filePath, 'utf-8');
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Write file contents, create parent directories if needed
+     */
+    writeFile(filePath, content) {
+        const dir = path.dirname(filePath);
+        this.ensureDir(dir);
+        fs.writeFileSync(filePath, content, 'utf-8');
+    }
+    /**
+     * Delete file if it exists
+     */
+    deleteFile(filePath) {
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    /**
+     * Check if file exists
+     */
+    fileExists(filePath) {
+        return fs.existsSync(filePath);
+    }
+}
+//# sourceMappingURL=base-storage.js.map

package/dist/lib/storage/base-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-storage.js","sourceRoot":"","sources":["../../../src/lib/storage/base-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;;;OAOG;IACK,KAAK,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAEpD;;;;;OAKG;IACO,YAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACO,UAAU;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACO,SAAS,CAAC,GAAW;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB;;;;;;;;eAQG;YACH,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,QAAgB;QACjC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACO,SAAS,CAAC,QAAgB,EAAE,OAAe;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,QAAgB;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,QAAgB;QACnC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/lib/storage/config-store.d.ts

@@ -0,0 +1,40 @@
+import { BaseStorage } from './base-storage.js';
+/**
+ * User configuration structure
+ */
+export interface Config {
+    apiUrl?: string;
+    editor?: string;
+}
+/**
+ * Manages user configuration stored in XDG_CONFIG_HOME
+ * Example: ~/.config/papyrus/config.json
+ */
+export declare class ConfigStore extends BaseStorage {
+    private configPath;
+    constructor(configDir?: string);
+    /**
+     * Load configuration, returns empty object if not found
+     */
+    load(): Config;
+    /**
+     * Save configuration
+     */
+    save(config: Config): void;
+    /**
+     * Update specific config values
+     */
+    update(updates: Partial<Config>): void;
+    /**
+     * Get specific config value
+     */
+    get<K extends keyof Config>(key: K): Config[K] | undefined;
+    /**
+     * Set specific config value
+     */
+    set<K extends keyof Config>(key: K, value: Config[K]): void;
+    /**
+     * Clear all configuration
+     */
+    clear(): void;
+}

package/dist/lib/storage/config-store.js

@@ -0,0 +1,63 @@
+import path from 'path';
+import { BaseStorage } from './base-storage.js';
+/**
+ * Manages user configuration stored in XDG_CONFIG_HOME
+ * Example: ~/.config/papyrus/config.json
+ */
+export class ConfigStore extends BaseStorage {
+    configPath;
+    constructor(configDir) {
+        super();
+        const dir = configDir ?? this.getConfigDir();
+        this.configPath = path.join(dir, 'config.json');
+    }
+    /**
+     * Load configuration, returns empty object if not found
+     */
+    load() {
+        const content = this.readFile(this.configPath);
+        if (!content)
+            return {};
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Save configuration
+     */
+    save(config) {
+        const content = JSON.stringify(config, null, 2);
+        this.writeFile(this.configPath, content);
+    }
+    /**
+     * Update specific config values
+     */
+    update(updates) {
+        const current = this.load();
+        const updated = { ...current, ...updates };
+        this.save(updated);
+    }
+    /**
+     * Get specific config value
+     */
+    get(key) {
+        const config = this.load();
+        return config[key];
+    }
+    /**
+     * Set specific config value
+     */
+    set(key, value) {
+        this.update({ [key]: value });
+    }
+    /**
+     * Clear all configuration
+     */
+    clear() {
+        this.deleteFile(this.configPath);
+    }
+}
+//# sourceMappingURL=config-store.js.map

package/dist/lib/storage/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../../src/lib/storage/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAClC,UAAU,CAAS;IAE3B,YAAY,SAAkB;QAC5B,KAAK,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAwB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAyB,GAAM;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAyB,GAAM,EAAE,KAAgB;QAClD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAqB,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/lib/storage/index.d.ts

@@ -0,0 +1,12 @@
+import { ConfigStore } from './config-store.js';
+import { JournalStore } from './journal-storage.js';
+import { SyncMetaStore } from './sync-meta-store.js';
+import { TokenStore } from './token-store.js';
+export { ConfigStore, type Config } from './config-store.js';
+/**
+ * Singletons for easy access
+ */
+export declare const configStore: ConfigStore;
+export declare const tokenStore: TokenStore;
+export declare const syncMetaStore: SyncMetaStore;
+export declare const journalStore: JournalStore;

package/dist/lib/storage/index.js

@@ -0,0 +1,13 @@
+import { ConfigStore } from './config-store.js';
+import { JournalStore } from './journal-storage.js';
+import { SyncMetaStore } from './sync-meta-store.js';
+import { TokenStore } from './token-store.js';
+export { ConfigStore } from './config-store.js';
+/**
+ * Singletons for easy access
+ */
+export const configStore = new ConfigStore();
+export const tokenStore = new TokenStore();
+export const syncMetaStore = new SyncMetaStore();
+export const journalStore = new JournalStore();
+//# sourceMappingURL=index.js.map

package/dist/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAC7D;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/lib/storage/journal-storage.d.ts

@@ -0,0 +1,46 @@
+import { BaseStorage } from './base-storage.js';
+export interface JournalFileInfo {
+    date: string;
+    path: string;
+    size: number;
+    modified: Date;
+}
+/**
+ * Manages journal entries stored as markdown files with YAML frontmatter.
+ *
+ * File format:
+ * ---
+ * date: "20251210"
+ * hash: "abc123..."
+ * createdAt: "2025-12-10T10:00:00.000Z"
+ * updatedAt: "2025-12-10T10:00:00.000Z"
+ * deletedAt: null
+ * ---
+ *
+ * # Journal content here
+ */
+export declare class JournalStore extends BaseStorage {
+    private journalsDir;
+    constructor(dataDir?: string);
+    private getEntryPath;
+    /**
+     * Create a new journal entry
+     */
+    create(date: string, content?: string): void;
+    /**
+     * Get journal entry by date
+     */
+    load(date: string): string | null;
+    /**
+     * Delete journal entry
+     */
+    delete(date: string): void;
+    /**
+     * Check if entry exists for date
+     */
+    exists(date: string): boolean;
+    /**
+     * List all journal entries (sorted by date descending)
+     */
+    list(): JournalFileInfo[];
+}