ticktick-cli 1.0.1 → 1.0.3

package/README.md

@@ -5,7 +5,7 @@ A TypeScript CLI wrapper for the TickTick Open API documented at:
 - https://developer.ticktick.com/
 - https://developer.ticktick.com/docs#/openapi
 
-`v1.0.0` covers the documented OAuth flow plus every documented task and project endpoint.
+`v1.0.2` covers the documented OAuth flow plus every documented task and project endpoint.
 
 The CLI is available as both `ticktick` and the short alias `tt`.
 
@@ -100,6 +100,8 @@ Interactive login:
 ticktick auth login
 ```
 
+Successful auth stores the token in your local config file and masks secrets in the terminal output by default.
+
 If you already have an authorization code:
 
 ```bash
@@ -118,6 +120,8 @@ Check current auth state:
 ticktick auth status
 ```
 
+If you need the raw token values in the terminal, add `--show-secrets` to `auth login`, `auth exchange`, or `auth status`.
+
 Clear the stored access token:
 
 ```bash
@@ -205,20 +209,12 @@ ticktick request POST https://httpbin.org/post --no-auth --json '{"hello":"world
 
 ## Development
 
-Run the normal test suite:
-
-```bash
-npm test
-```
-
-Run the enforced coverage check:
+Build the CLI:
 
 ```bash
-npm run coverage
+npm run build
 ```
 
-`npm run coverage` currently enforces `100%` line, branch, and function coverage on the published runtime files.
-
 ## Notes
 
 - The docs currently show `api.ticktick.com` for most endpoints, but `api.dida365.com` in the examples for `task/move`, `task/completed`, and `task/filter`. This CLI defaults to the selected service profile and lets you override base URLs explicitly if your account needs something different.

package/dist/auth.js

@@ -118,7 +118,7 @@ export async function openBrowserWith(url, options = {}) {
     const stderr = options.stderr ?? ((text) => process.stderr.write(text));
     try {
         if (platform === "win32") {
-            await run("cmd", ["/c", "start", "", url]);
+            await run("rundll32", ["url.dll,FileProtocolHandler", url]);
             return;
         }
         if (platform === "darwin") {

package/dist/cli.js

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import { pathToFileURL } from "node:url";
 import { buildAuthorizationUrl, exchangeAuthorizationCode, isLoopbackRedirect, openBrowser, waitForOAuthCode, } from "./auth.js";
 import { TickTickClient } from "./client.js";
 import { loadStoredConfig, resolveRuntimeConfig, saveStoredConfig, validateService, } from "./config.js";
@@ -82,6 +83,7 @@ function buildAuthCommands(root, dependencies) {
         .command("login")
         .description("Open the OAuth flow, exchange the code, and store the access token")
         .option("--timeout-ms <number>", "Timeout while waiting for the callback", parseInteger, 120000)
+        .option("--show-secrets", "Include access token and refresh token in the output")
         .action(async (...args) => {
         const command = args.at(-1);
         const options = command.optsWithGlobals();
@@ -96,24 +98,27 @@ function buildAuthCommands(root, dependencies) {
             });
             return;
         }
+        dependencies.stderr(`Waiting for OAuth callback on ${config.redirectUri}...\n`);
         const codePromise = dependencies.waitForOAuthCode(config.redirectUri, state, options.timeoutMs);
         await dependencies.openBrowser(url);
         const code = await codePromise;
         const token = await dependencies.exchangeAuthorizationCode(config, code);
         await persistConfig(config, token, dependencies);
-        dependencies.printJson(token);
+        dependencies.printJson(formatAuthSuccess(config, token, options.showSecrets, dependencies));
     });
     auth
         .command("exchange <code>")
         .description("Exchange an authorization code for an access token")
+        .option("--show-secrets", "Include access token and refresh token in the output")
         .action(async (...args) => {
         const command = args.at(-1);
         const [code] = args;
-        const config = await dependencies.resolveRuntimeConfig(runtimeOverrides(command.optsWithGlobals(), dependencies));
+        const options = command.optsWithGlobals();
+        const config = await dependencies.resolveRuntimeConfig(runtimeOverrides(options, dependencies));
         requireClientCredentials(config);
         const token = await dependencies.exchangeAuthorizationCode(config, code);
         await persistConfig(config, token, dependencies);
-        dependencies.printJson(token);
+        dependencies.printJson(formatAuthSuccess(config, token, options.showSecrets, dependencies));
     });
     auth
         .command("status")
@@ -508,6 +513,26 @@ async function persistConfig(runtime, token, dependencies) {
     };
     await dependencies.saveStoredConfig(runtime.configFile, next);
 }
+function formatAuthSuccess(runtime, token, showSecrets, dependencies) {
+    return {
+        ok: true,
+        message: "Authorization complete.",
+        service: runtime.service,
+        configFile: runtime.configFile,
+        redirectUri: runtime.redirectUri,
+        scope: token.scope ?? runtime.scopes,
+        tokenType: token.token_type,
+        expiresIn: token.expires_in,
+        accessToken: showSecrets
+            ? token.access_token
+            : dependencies.maskSecret(token.access_token),
+        refreshToken: token.refresh_token
+            ? showSecrets
+                ? token.refresh_token
+                : dependencies.maskSecret(token.refresh_token)
+            : undefined,
+    };
+}
 function requireClientCredentials(config) {
     if (!config.clientId || !config.clientSecret) {
         throw new Error("Client credentials are required. Set TICKTICK_CLIENT_ID and TICKTICK_CLIENT_SECRET or use `ticktick config set`.");
@@ -524,3 +549,9 @@ function collectString(value, previous = []) {
 function collectInteger(value, previous = []) {
     return [...previous, parseInteger(value)];
 }
+function isDirectExecution() {
+    return Boolean(process.argv[1]) && import.meta.url === pathToFileURL(process.argv[1]).href;
+}
+if (isDirectExecution()) {
+    await main();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticktick-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI wrapper for the TickTick Open API",
   "type": "module",
   "files": [
@@ -14,14 +14,10 @@
   },
   "scripts": {
     "build": "npm run clean && tsc -p tsconfig.json",
-    "build:coverage": "npm run clean:coverage && tsc -p tsconfig.coverage.json",
-    "check": "npm run coverage",
+    "check": "npm run build",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "clean:coverage": "node -e \"require('node:fs').rmSync('.coverage-dist',{recursive:true,force:true})\"",
     "dev": "tsx src/cli.ts",
-    "prepack": "npm run coverage",
-    "test": "npm run build && node --import tsx --test src/test/*.test.ts",
-    "coverage": "npm run build:coverage && node --experimental-test-coverage --test-coverage-lines=100 --test-coverage-functions=100 --test-coverage-branches=100 --test-coverage-include=.coverage-dist/*.js --test-coverage-exclude=.coverage-dist/bin.js --test .coverage-dist/test/*.test.js"
+    "prepack": "npm run build"
   },
   "keywords": [
     "ticktick",