vocabflow 0.0.1

package/dist/lib/api-client.js

@@ -0,0 +1,93 @@
+import ky from 'ky';
+import { getToken } from './config.js';
+// API base URL without /api prefix, endpoints include /api path
+const API_BASE_URL = process.env.VOCAB_API_BASE_URL || 'https://api.enbook.site';
+// Webapp URL for login flow
+const WEBAPP_URL = process.env.VOCAB_WEBAPP_URL || 'https://vocab.now';
+// Create Ky instance with Bearer token injection
+const cliApiClient = ky.create({
+    prefixUrl: API_BASE_URL,
+    timeout: 30000,
+    hooks: {
+        beforeRequest: [
+            (request) => {
+                const token = getToken();
+                if (token) {
+                    request.headers.set('Authorization', `Bearer ${token}`);
+                }
+            },
+        ],
+    },
+});
+// Type-safe API methods
+export const cliApi = {
+    get: (url) => cliApiClient.get(url).json(),
+    post: (url, data) => cliApiClient.post(url, { json: data }).json(),
+    put: (url, data) => cliApiClient.put(url, { json: data }).json(),
+    delete: (url) => cliApiClient.delete(url).json(),
+};
+export class ApiError extends Error {
+    status;
+    response;
+    constructor(status, message, response) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.name = 'ApiError';
+    }
+}
+export { WEBAPP_URL };
+export function isApiSuccess(code) {
+    return code === 0 || code === 200;
+}
+export async function validateSession() {
+    try {
+        const response = await cliApi.get('api/users/me');
+        if (isApiSuccess(response.code) && response.data) {
+            return { valid: true, user: response.data };
+        }
+        return { valid: false, error: 'Invalid response from server' };
+    }
+    catch (err) {
+        if (err?.response?.status === 401) {
+            return { valid: false, error: 'Session expired. Please run `vocab login`.' };
+        }
+        if (err?.cause?.code === 'ECONNREFUSED' || err?.name === 'FetchError') {
+            return { valid: false, error: 'Unable to connect. Check your network.' };
+        }
+        return { valid: false, error: 'Unable to connect. Check your network.' };
+    }
+}
+// Require authenticated session - throws and exits if invalid
+export async function requireAuth() {
+    const { valid, user, error } = await validateSession();
+    if (!valid) {
+        console.error(error);
+        process.exit(1);
+    }
+    return user;
+}
+// Review API endpoints
+export const reviewApi = {
+    /**
+     * GET /api/review/today
+     * Fetch all words for today's review session
+     */
+    getTodayReview: () => cliApi.get('api/review/today'),
+    /**
+     * GET /api/review/questions/{wordId}?mode=FLASHCARD_FORWARD
+     * Fetch detailed word info for reveal
+     */
+    getReviewQuestion: (wordId) => cliApi.get(`api/review/questions/${wordId}?mode=FLASHCARD_FORWARD`),
+    /**
+     * POST /api/review/complete
+     * Submit rating for a word
+     */
+    submitReview: (data) => cliApi.post('api/review/complete', data),
+    /**
+     * DELETE /api/words/{wordId}
+     * Delete a word from user's wordbook
+     */
+    deleteWord: (wordId) => cliApi.delete(`api/words/${wordId}`),
+};
+//# sourceMappingURL=api-client.js.map

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

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

package/dist/lib/config.d.ts

@@ -0,0 +1,20 @@
+import Conf from 'conf';
+export interface ConfigSchema {
+    token: string | null;
+    email: string | null;
+    expiresAt: number | null;
+}
+declare const config: Conf<ConfigSchema>;
+export declare function getToken(): string | null;
+export declare function getEmail(): string | null;
+export declare function getExpiresAt(): number | null;
+export declare function setAuth(data: {
+    token: string;
+    email: string;
+    expiresAt: number | null;
+}): void;
+export declare function clearAuth(): void;
+export declare function hasToken(): boolean;
+export declare function isTokenExpired(): boolean;
+export { config };
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,QAAA,MAAM,MAAM,oBAOV,CAAC;AAEH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAI9F;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/lib/config.js

@@ -0,0 +1,39 @@
+import Conf from 'conf';
+const config = new Conf({
+    projectName: 'vocab-cli',
+    defaults: {
+        token: null,
+        email: null,
+        expiresAt: null,
+    },
+});
+export function getToken() {
+    return config.get('token');
+}
+export function getEmail() {
+    return config.get('email');
+}
+export function getExpiresAt() {
+    return config.get('expiresAt');
+}
+export function setAuth(data) {
+    config.set('token', data.token);
+    config.set('email', data.email);
+    config.set('expiresAt', data.expiresAt);
+}
+export function clearAuth() {
+    config.clear();
+}
+export function hasToken() {
+    const token = config.get('token');
+    return token !== null && token !== undefined;
+}
+export function isTokenExpired() {
+    const expiresAt = config.get('expiresAt');
+    if (expiresAt === null || expiresAt === undefined) {
+        return false; // No expiry stored, assume valid until server says otherwise
+    }
+    return Date.now() > expiresAt;
+}
+export { config };
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAe;IACpC,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE;QACR,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;KAChB;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAgE;IACtF,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,CAAC,6DAA6D;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;AAChC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/lib/oauth-callback.d.ts

@@ -0,0 +1,11 @@
+export interface CallbackSuccess {
+    type: 'success';
+    token: string;
+}
+export interface CallbackError {
+    type: 'error';
+    message: string;
+}
+export type CallbackResult = CallbackSuccess | CallbackError;
+export declare function startCallbackServer(): Promise<CallbackResult>;
+//# sourceMappingURL=oauth-callback.d.ts.map

package/dist/lib/oauth-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-callback.d.ts","sourceRoot":"","sources":["../../src/lib/oauth-callback.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAE7D,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC,CAmFnE"}

package/dist/lib/oauth-callback.js

@@ -0,0 +1,83 @@
+import http from 'node:http';
+import { URL } from 'node:url';
+const CALLBACK_PORT = 58421;
+const CALLBACK_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+export async function startCallbackServer() {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            server.close();
+            reject(new Error('Authentication timed out. Please try again.'));
+        }, CALLBACK_TIMEOUT_MS);
+        const server = http.createServer((req, res) => {
+            // Handle CORS preflight
+            if (req.method === 'OPTIONS') {
+                res.writeHead(200, {
+                    'Access-Control-Allow-Origin': '*',
+                    'Access-Control-Allow-Methods': 'GET, OPTIONS',
+                    'Access-Control-Allow-Headers': 'Content-Type',
+                });
+                res.end();
+                return;
+            }
+            const url = new URL(req.url ?? '/', `http://localhost:${CALLBACK_PORT}`);
+            const token = url.searchParams.get('token');
+            const error = url.searchParams.get('error');
+            const errorDescription = url.searchParams.get('error_description');
+            if (error || errorDescription) {
+                const msg = errorDescription ?? error ?? 'Unknown error';
+                res.writeHead(400, {
+                    'Content-Type': 'text/html',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                res.end(`
+          <html>
+            <head><title>Authentication Failed</title></head>
+            <body style="font-family: sans-serif; padding: 40px; text-align: center;">
+              <h1 style="color: #d97757;">Authentication Failed</h1>
+              <p>${msg}</p>
+              <p>You can close this window.</p>
+            </body>
+          </html>
+        `);
+                clearTimeout(timer);
+                server.close();
+                resolve({ type: 'error', message: msg });
+                return;
+            }
+            if (token) {
+                res.writeHead(200, {
+                    'Content-Type': 'text/html',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                res.end(`
+          <html>
+            <head><title>Authentication Successful</title></head>
+            <body style="font-family: sans-serif; padding: 40px; text-align: center;">
+              <h1 style="color: #22c55e;">Authentication Successful</h1>
+              <p>You can close this window and return to the CLI.</p>
+            </body>
+          </html>
+        `);
+                clearTimeout(timer);
+                server.close();
+                resolve({ type: 'success', token });
+                return;
+            }
+            // Unknown route
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not found. Expected callback with ?token=xxx or ?error=xxx');
+        });
+        server.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(`Port ${CALLBACK_PORT} is already in use. Please close other vocab processes and try again.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+        server.listen(CALLBACK_PORT, () => {
+            // Server started successfully
+        });
+    });
+}
+//# sourceMappingURL=oauth-callback.js.map

package/dist/lib/oauth-callback.js.map

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

package/dist/lib/tty.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Check if stdin is a TTY (interactive terminal)
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Setup raw mode for keypress capture.
+ * MUST check isInteractive() first - setRawMode only works with real TTY.
+ * Call cleanup() when done to restore normal terminal behavior.
+ */
+export declare function setupRawMode(): void;
+/**
+ * Cleanup raw mode - restore normal terminal behavior.
+ * Call this on exit (success, error, or quit).
+ */
+export declare function cleanup(): void;
+/**
+ * Clear the current line in terminal
+ */
+export declare function clearLine(): void;
+/**
+ * Move cursor to top-left of terminal
+ */
+export declare function moveCursorTop(): void;
+/**
+ * Clear screen from cursor position to bottom
+ */
+export declare function clearScreen(): void;
+//# sourceMappingURL=tty.d.ts.map

package/dist/lib/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../src/lib/tty.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAM9B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAGhC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAMlC"}

package/dist/lib/tty.js

@@ -0,0 +1,59 @@
+import * as readline from 'readline';
+/**
+ * Check if stdin is a TTY (interactive terminal)
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true;
+}
+/**
+ * Setup raw mode for keypress capture.
+ * MUST check isInteractive() first - setRawMode only works with real TTY.
+ * Call cleanup() when done to restore normal terminal behavior.
+ */
+export function setupRawMode() {
+    if (!isInteractive()) {
+        return;
+    }
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode?.(true);
+    process.stdin.resume?.();
+}
+/**
+ * Cleanup raw mode - restore normal terminal behavior.
+ * Call this on exit (success, error, or quit).
+ */
+export function cleanup() {
+    if (!isInteractive()) {
+        return;
+    }
+    process.stdin.setRawMode?.(false);
+    process.stdin.pause?.();
+}
+/**
+ * Clear the current line in terminal
+ */
+export function clearLine() {
+    readline.cursorTo(process.stdout, 0);
+    readline.clearLine(process.stdout, 0);
+}
+/**
+ * Move cursor to top-left of terminal
+ */
+export function moveCursorTop() {
+    if (!process.stdout.isTTY) {
+        return;
+    }
+    // ANSI cursor-home is more consistent across Windows + Git Bash terminals.
+    process.stdout.write('\u001B[H');
+}
+/**
+ * Clear screen from cursor position to bottom
+ */
+export function clearScreen() {
+    if (!process.stdout.isTTY) {
+        return;
+    }
+    // ANSI full-screen clear avoids stale lines in some TTY implementations.
+    process.stdout.write('\u001B[2J');
+}
+//# sourceMappingURL=tty.js.map

package/dist/lib/tty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.js","sourceRoot":"","sources":["../../src/lib/tty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/types/review.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Response from GET /api/review/today
+ */
+export interface TodayReviewVO {
+    id: number;
+    wordText: string;
+    phoneticUs?: string;
+    briefExplanation: string;
+    nextReviewTime: string;
+    reviewCount: number;
+    intervalDays: number;
+    easeFactor: number;
+}
+export interface PagedResponseTodayReviewVO {
+    datas?: TodayReviewVO[];
+    totalElements?: number;
+    page?: number;
+    size?: number;
+    totalPages?: number;
+    first?: boolean;
+    last?: boolean;
+    words?: TodayReviewVO[];
+    total?: number;
+}
+export interface ApiResponsePagedTodayReviewVO {
+    code: number;
+    message: string;
+    data: PagedResponseTodayReviewVO;
+    timestamp: number;
+}
+/**
+ * Response from GET /api/review/questions/{wordId}
+ */
+export interface ReviewQuestionVO {
+    wordId: number;
+    mode: string;
+    question: Record<string, unknown>;
+    answer: Record<string, unknown>;
+}
+export interface ApiResponseReviewQuestionVO {
+    code: number;
+    message: string;
+    data: ReviewQuestionVO;
+    timestamp: number;
+}
+/**
+ * Request body for POST /api/review/complete
+ */
+export type ReviewResult = 'UNKNOWN' | 'VAGUE' | 'KNOWN' | 'CORRECT' | 'INCORRECT';
+export type ReviewMode = 'FLASHCARD_FORWARD' | 'FLASHCARD_BACKWARD' | 'SPELLING' | 'CHOICE_EN2CN' | 'CHOICE_CN2EN';
+export interface SubmitReviewRequest {
+    wordId: number;
+    result: ReviewResult;
+    mode: ReviewMode;
+    userAnswer?: string;
+    timeCost?: number;
+}
+/**
+ * Response from POST /api/review/complete
+ */
+export interface ReviewResponseDto {
+    wordId: number;
+    wordText: string;
+    easeFactor: number;
+    intervalDays: number;
+    nextReviewTime: string;
+    reviewCount: number;
+    correctCount: number;
+    lastReviewResult: ReviewResult;
+}
+export interface ApiResponseReviewResponseDto {
+    code: number;
+    message: string;
+    data: ReviewResponseDto;
+    timestamp: number;
+}
+//# sourceMappingURL=review.d.ts.map

package/dist/types/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/types/review.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IAEzC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IAGf,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,0BAA0B,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,CAAC;AAEnH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/review.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=review.js.map

package/dist/types/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/types/review.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "vocabflow",
+  "version": "0.0.1",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "vocabflow": "./dist/index.js",
+    "vocab": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "conf": "^15.1.0",
+    "ky": "^1.14.3",
+    "open": "^11.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@repo/api-client": "workspace:*",
+    "@repo/utils": "workspace:*",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  }
+}

package/src/__tests__/api-client.test.ts

@@ -0,0 +1,123 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const mockGetToken = vi.fn();
+const mockGet = vi.fn();
+const mockPost = vi.fn();
+const mockPut = vi.fn();
+const mockDelete = vi.fn();
+const mockKyCreate = vi.fn();
+
+vi.mock('../lib/config.js', () => ({
+  getToken: mockGetToken,
+}));
+
+vi.mock('ky', () => ({
+  default: {
+    create: mockKyCreate,
+  },
+}));
+
+describe('CLI API client endpoint compatibility', () => {
+  beforeEach(() => {
+    vi.resetModules();
+    vi.clearAllMocks();
+
+    mockGetToken.mockReturnValue('test-token');
+    mockGet.mockImplementation((_url: string) => ({
+      json: vi.fn(),
+    }));
+    mockPost.mockImplementation((_url: string, _opts?: unknown) => ({
+      json: vi.fn(),
+    }));
+    mockPut.mockImplementation((_url: string, _opts?: unknown) => ({
+      json: vi.fn(),
+    }));
+    mockDelete.mockImplementation((_url: string) => ({
+      json: vi.fn(),
+    }));
+    mockKyCreate.mockReturnValue({
+      get: mockGet,
+      post: mockPost,
+      put: mockPut,
+      delete: mockDelete,
+    });
+  });
+
+  it('validateSession success should call relative endpoint without leading slash', async () => {
+    const jsonMock = vi.fn().mockResolvedValue({
+      code: 0,
+      message: 'ok',
+      data: { id: 'u1', email: 'test@example.com', name: 'Test User' },
+    });
+    mockGet.mockReturnValueOnce({ json: jsonMock });
+
+    const { validateSession } = await import('../lib/api-client.js');
+    const result = await validateSession();
+
+    expect(mockGet).toHaveBeenCalledWith('api/users/me');
+    expect(mockGet).not.toHaveBeenCalledWith('/api/users/me');
+    expect(result).toEqual({
+      valid: true,
+      user: { id: 'u1', email: 'test@example.com', name: 'Test User' },
+    });
+  });
+
+  it('isApiSuccess should accept both 0 and 200', async () => {
+    const { isApiSuccess } = await import('../lib/api-client.js');
+    expect(isApiSuccess(0)).toBe(true);
+    expect(isApiSuccess(200)).toBe(true);
+    expect(isApiSuccess(401)).toBe(false);
+  });
+
+  it('validateSession failure should return session-expired message for 401', async () => {
+    const jsonMock = vi.fn().mockRejectedValue({ response: { status: 401 } });
+    mockGet.mockReturnValueOnce({ json: jsonMock });
+
+    const { validateSession } = await import('../lib/api-client.js');
+    const result = await validateSession();
+
+    expect(mockGet).toHaveBeenCalledWith('api/users/me');
+    expect(result).toEqual({
+      valid: false,
+      error: 'Session expired. Please run `vocab login`.',
+    });
+  });
+
+  it('reviewApi should keep all endpoints relative to prefixUrl', async () => {
+    const getJsonMock = vi.fn().mockResolvedValue({ code: 200, data: {} });
+    const postJsonMock = vi.fn().mockResolvedValue({ code: 200, data: {} });
+    const deleteJsonMock = vi.fn().mockResolvedValue({ code: 200, data: {} });
+
+    mockGet.mockReturnValue({ json: getJsonMock });
+    mockPost.mockReturnValue({ json: postJsonMock });
+    mockDelete.mockReturnValue({ json: deleteJsonMock });
+
+    const { reviewApi } = await import('../lib/api-client.js');
+    await reviewApi.getTodayReview();
+    await reviewApi.getReviewQuestion(123);
+    await reviewApi.submitReview({
+      wordId: 123,
+      result: 'KNOWN',
+      mode: 'FLASHCARD_FORWARD',
+    });
+    await reviewApi.deleteWord(123);
+
+    expect(mockGet).toHaveBeenCalledWith('api/review/today');
+    expect(mockGet).toHaveBeenCalledWith('api/review/questions/123?mode=FLASHCARD_FORWARD');
+    expect(mockPost).toHaveBeenCalledWith(
+      'api/review/complete',
+      expect.objectContaining({
+        json: {
+          wordId: 123,
+          result: 'KNOWN',
+          mode: 'FLASHCARD_FORWARD',
+        },
+      })
+    );
+    expect(mockDelete).toHaveBeenCalledWith('api/words/123');
+    expect(mockGet).not.toHaveBeenCalledWith('/api/review/today');
+    expect(mockGet).not.toHaveBeenCalledWith('/api/review/questions/123?mode=FLASHCARD_FORWARD');
+    expect(mockPost).not.toHaveBeenCalledWith('/api/review/complete', expect.anything());
+    expect(mockDelete).not.toHaveBeenCalledWith('/api/words/123');
+  });
+});