teak-cli 1.0.51 → 1.0.53

package/README.md

@@ -0,0 +1,48 @@
+# Teak CLI
+
+Command-line client for [Teak](https://teakvault.com), the personal knowledge hub for saving and rediscovering ideas, links, files, notes, and references.
+
+## Install
+
+```bash
+npm install -g teak-cli
+```
+
+```bash
+teak --version
+```
+
+## Sign In
+
+```bash
+teak login
+```
+
+The CLI opens Teak in your browser and stores the resulting session securely in macOS Keychain when available. You can also use an API key:
+
+```bash
+teak --api-key teakapi_... cards list
+```
+
+## Common Commands
+
+```bash
+teak add "Design note from today's review" --tags design,research
+teak add --url https://example.com --tags reference
+teak add --file ./screenshot.png --notes "Homepage inspiration"
+teak search "homepage inspiration"
+teak cards list --type link --limit 20
+teak cards get <card-id>
+teak cards update <card-id> --tags design,approved
+teak fav <card-id>
+teak rm <card-id>
+teak tags
+```
+
+Use `--json` on any command for script-friendly output.
+
+## Docs
+
+- CLI guide: [teakvault.com/docs/cli](https://teakvault.com/docs/cli)
+- API docs: [teakvault.com/docs/api](https://teakvault.com/docs/api)
+- MCP docs: [teakvault.com/docs/mcp](https://teakvault.com/docs/mcp)

package/dist/index.js

@@ -4,8 +4,8 @@
 import { readFileSync as readFileSync3, realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
-// ../../packages/sdk/src/index.ts
-var CARD_TYPES = [
+// ../../packages/convex/shared/constants.ts
+var cardTypes = [
   "text",
   "link",
   "image",
@@ -15,6 +15,61 @@ var CARD_TYPES = [
   "palette",
   "quote"
 ];
+var MAX_FILE_SIZE = 20 * 1024 * 1024;
+var CARD_TYPES = [...cardTypes];
+var CARD_TYPE_REGISTRY = {
+  text: {
+    label: "Text",
+    icon: "FileText",
+    searchLabel: "Text"
+  },
+  link: {
+    label: "Link",
+    icon: "Link",
+    searchLabel: "Links"
+  },
+  image: {
+    label: "Image",
+    icon: "Image",
+    searchLabel: "Images"
+  },
+  video: {
+    label: "Video",
+    icon: "Video",
+    searchLabel: "Videos"
+  },
+  audio: {
+    label: "Audio",
+    icon: "Volume2",
+    searchLabel: "Audio"
+  },
+  document: {
+    label: "Document",
+    icon: "File",
+    searchLabel: "Documents"
+  },
+  palette: {
+    label: "Palette",
+    icon: "Palette",
+    searchLabel: "Palettes"
+  },
+  quote: {
+    label: "Quote",
+    icon: "Quote",
+    searchLabel: "Quotes"
+  }
+};
+var RESERVED_KEYWORDS = [
+  ...cardTypes.map((cardType) => ({
+    value: cardType,
+    label: CARD_TYPE_REGISTRY[cardType].searchLabel
+  })),
+  { value: "favorites", label: "Favorites" },
+  { value: "trash", label: "Trash" }
+];
+
+// ../../packages/convex/client/sdk.ts
+var CARD_TYPES2 = cardTypes;
 var ERROR_CODES = [
   "AUTH_REQUIRED",
   "BAD_REQUEST",
@@ -73,6 +128,21 @@ var normalizeLimit = (limit) => {
   }
   return Math.max(1, Math.min(Math.trunc(limit ?? 50), 100));
 };
+var byteLengthForBody = (bytes) => {
+  if (bytes instanceof ArrayBuffer) {
+    return bytes.byteLength;
+  }
+  if (ArrayBuffer.isView(bytes)) {
+    return bytes.byteLength;
+  }
+  if (typeof Blob !== "undefined" && bytes instanceof Blob) {
+    return bytes.size;
+  }
+  if (typeof bytes === "string") {
+    return new TextEncoder().encode(bytes).byteLength;
+  }
+  return null;
+};
 var buildCardsSearchParams = (input) => {
   const search = new URLSearchParams;
   if (input.query?.trim()) {
@@ -239,9 +309,14 @@ var createTeakClient = (options) => {
     uploads: {
       create: (input) => request("/v1/uploads", { body: JSON.stringify(input), method: "POST" }, asUpload),
       putFile: async (uploadUrl, bytes, mimeType) => {
+        const headers = new Headers({ "Content-Type": mimeType });
+        const byteLength = byteLengthForBody(bytes);
+        if (byteLength !== null) {
+          headers.set("Content-Length", String(byteLength));
+        }
         const response = await fetchImpl(uploadUrl, {
           body: bytes,
-          headers: { "Content-Type": mimeType },
+          headers,
           method: "PUT"
         });
         if (!response.ok) {
@@ -252,7 +327,7 @@ var createTeakClient = (options) => {
   };
 };
 var parseTags = (value) => value === undefined ? undefined : Array.from(new Set(value.split(",").map((tag) => tag.trim()).filter(Boolean)));
-var isCardType = (value) => CARD_TYPES.includes(value);
+var isCardType = (value) => CARD_TYPES2.includes(value);
 
 // ../../node_modules/commander/lib/error.js
 class CommanderError extends Error {
@@ -2327,6 +2402,7 @@ var VERSION = readPackageVersion();
 var EXIT = { api: 1, auth: 3, notFound: 4, rateLimited: 5, usage: 2 };
 var DEFAULT_API_URL = "https://api.teakvault.com";
 var DEFAULT_AUTH_URL = "https://app.teakvault.com";
+var CLI_OAUTH_SCOPE = "profile email offline_access";
 var SERVICE = "com.teakvault.cli";
 var ACCOUNT = "default";
 var readJson = (value) => {
@@ -2498,6 +2574,17 @@ var openBrowser = (url) => {
   const args = platform() === "win32" ? ["/c", "start", "", url] : [url];
   spawn(command, args, { detached: true, stdio: "ignore" }).unref();
 };
+var createAuthorizeUrl = (options, params) => {
+  const authUrl = new URL(authorizeEndpoint(options));
+  authUrl.searchParams.set("response_type", "code");
+  authUrl.searchParams.set("client_id", "teak-cli");
+  authUrl.searchParams.set("redirect_uri", params.redirectUri);
+  authUrl.searchParams.set("code_challenge", params.codeChallenge);
+  authUrl.searchParams.set("code_challenge_method", "S256");
+  authUrl.searchParams.set("scope", CLI_OAUTH_SCOPE);
+  authUrl.searchParams.set("state", params.state);
+  return authUrl;
+};
 var login = async (options) => {
   const verifier = b64url(randomBytes(32));
   const state = b64url(randomBytes(24));
@@ -2536,13 +2623,11 @@ var login = async (options) => {
           }
         });
         server.listen(port, "127.0.0.1", () => {
-          const authUrl = new URL(authorizeEndpoint(options));
-          authUrl.searchParams.set("response_type", "code");
-          authUrl.searchParams.set("client_id", "teak-cli");
-          authUrl.searchParams.set("redirect_uri", redirectUri);
-          authUrl.searchParams.set("code_challenge", sha256(verifier));
-          authUrl.searchParams.set("code_challenge_method", "S256");
-          authUrl.searchParams.set("state", state);
+          const authUrl = createAuthorizeUrl(options, {
+            codeChallenge: sha256(verifier),
+            redirectUri,
+            state
+          });
           process.stdout.write(`${authUrl.toString()}
 `);
           if (options.browser !== false) {
@@ -2565,7 +2650,7 @@ var login = async (options) => {
 
 // src/files.ts
 var MAX_STDIN_BYTES = 1024 * 1024;
-var MAX_FILE_SIZE = 20 * 1024 * 1024;
+var MAX_FILE_SIZE2 = 20 * 1024 * 1024;
 var readStdin = async () => {
   if (process.stdin.isTTY) {
     return "";
@@ -2622,8 +2707,8 @@ var addCard = async (input, options) => {
   const { candidate, raw } = await resolveAddInput(input, options.file);
   if (candidate && existsSync2(candidate) && statSync(candidate).isFile()) {
     const stats = statSync(candidate);
-    if (stats.size > MAX_FILE_SIZE) {
-      throw new InvalidArgumentError(`file must be at most ${MAX_FILE_SIZE} bytes`);
+    if (stats.size > MAX_FILE_SIZE2) {
+      throw new InvalidArgumentError(`file must be at most ${MAX_FILE_SIZE2} bytes`);
     }
     const mimeType = mimeFor(candidate);
     const upload = await api.uploads.create({
@@ -2706,7 +2791,7 @@ var parseSince = (value) => {
 };
 var parseType = (value) => {
   if (!isCardType(value)) {
-    throw new InvalidArgumentError(`type must be one of: ${CARD_TYPES.join(", ")}`);
+    throw new InvalidArgumentError(`type must be one of: ${CARD_TYPES2.join(", ")}`);
   }
   return value;
 };

package/package.json

@@ -1,13 +1,24 @@
 {
   "name": "teak-cli",
-  "version": "1.0.51",
-  "description": "Command line client for Teak.",
+  "version": "1.0.53",
+  "description": "Command-line client for Teak, the personal knowledge hub for saving and rediscovering ideas.",
   "type": "module",
   "bin": {
     "teak": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "teak",
+    "cli",
+    "knowledge-base",
+    "bookmark-manager",
+    "notes",
+    "mcp",
+    "api-client",
+    "productivity"
   ],
   "engines": {
     "node": ">=20"
@@ -21,6 +32,7 @@
     "commander": "^15.0.0"
   },
   "devDependencies": {
+    "@teak/convex": "workspace:*",
     "@types/node": "^25.9.3",
     "typescript": "^6.0.3"
   },
@@ -33,5 +45,10 @@
     "url": "git+https://github.com/praveenjuge/teak.git",
     "directory": "apps/cli"
   },
+  "homepage": "https://teakvault.com/docs/cli",
+  "bugs": {
+    "url": "https://github.com/praveenjuge/teak/issues"
+  },
+  "author": "Praveen Juge <hello@praveenjuge.com>",
   "license": "MIT"
 }