@crosscopy/clipboard 0.1.0-beta

package/README.md

@@ -0,0 +1,96 @@
+# General Clipboard Listener
+
+> A Cross-Platform clipboard listener that listens for both text and image (screenshots).
+
+npm package: https://www.npmjs.com/package/general-clipboard-listener
+
+## Installation
+
+`npm i @crosscopy/clipboard`
+
+## Usage
+
+It has a very easy to use event-based system.
+
+See [demo.ts](./demo.ts) for a demo.
+
+Run `ts-node demo.ts`.
+
+```ts
+import clipboardEventListener from "./@crosscopy/clipboard";
+
+console.log(clipboard.readTextSync());
+  console.log(await clipboard.readText());
+  const imgBuf = clipboard.readImageSync();
+  // console.log(imgBuf.toString("base64"));
+  // console.log(clipboard.readImageBase64Sync());
+  // await clipboard.writeImage(base64img); // add fake image to clipboard
+  clipboard.writeImageSync(base64img); // add fake image to clipboard
+  console.log(""); // give some time
+  console.assert(clipboard.readImageBase64Sync() === base64img);
+
+  // * test readimage
+  clipboard.writeImageSync(base64img);
+  console.log();
+  console.assert(
+    (await clipboard.readImage()).toString("base64") === base64img
+  );
+
+  await clipboard.writeImage(base64img);
+  console.log();
+  console.assert((await clipboard.readImageBase64()) === base64img);
+  clipboard.on("text", (text) => {
+    console.log(text);
+  });
+  clipboard.on("image", (data) => {
+    fs.writeFileSync("test.png", data);
+  });
+  clipboard.listen();
+  setTimeout(() => {
+    clipboard.close();
+  }, 10000);
+```
+
+### Note
+
+This is an important note. If you write some data and read it immediately using the `sync` APIs, you may not be able to get the data.
+It needs a tiny bit of time to process. any code between the two lines should work, such as `console.log()`.
+
+Here I use `await sleep(1)` to make it work.
+
+```js
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+cb.writeTextSync("abc");
+await sleep(1);
+const text = cb.readTextSync();
+```
+
+If this package becomes popular some day and people requires a fix, I will fix it. For now, this implementation is good enough for CrossCopy.
+
+I never need to write and read immediately after unless during testing.
+
+## Explanation
+
+It's achieved using child process + `stdout`. 
+
+I took a golang version of the listener from [golang-design/clipboard](https://github.com/golang-design/clipboard). 
+
+When a change is detected, `IMAGE_CHANGED` or `TEXT_CHANGED` is printed to `stdout`. 
+
+This library runs compiled go-version clipboard listener using child process and listen to the `stdout`.
+
+If it sees the keywords in child process's `stdout`, an event will be emitted. 
+
+Run `npm run demo` to see a demo for 10 sec. Once started, copy some text and screenshot and check the terminal.
+
+
+## Supported Platforms
+
+Format: `process.platform/process.arch`
+
+The process here is from nodejs.
+
+Supported platforms can be found in `go-clipboard-monitor`.
+
+If your nodejs gives different platform or arch, it may not work.

package/dist/demo.d.ts

@@ -0,0 +1 @@
+

package/dist/demo.js

@@ -0,0 +1,94 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var events = require('events');
+var child_process = require('child_process');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
+var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
+
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var ClipboardEventListener, clipboard_default;
+var init_clipboard = __esm({
+  "index.ts"() {
+    ClipboardEventListener = class extends events.EventEmitter {
+      constructor() {
+        super();
+        this.child = void 0;
+      }
+      startListening() {
+        var _a, _b;
+        const { platform, arch } = process;
+        const pathArr = [__dirname];
+        if (path__default["default"].basename(__dirname) === "dist") {
+          pathArr.push("..");
+        }
+        let exeFilename = `go-clipboard-${platform}-${arch}`;
+        if (platform === "win32") {
+          exeFilename += ".exe";
+        }
+        pathArr.push(...["go-clipboard", "binaries", exeFilename]);
+        const exePath = path__default["default"].join(...pathArr);
+        console.log(exePath);
+        if (!fs__default["default"].existsSync(exePath)) {
+          throw new Error(
+            `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`
+          );
+        }
+        this.child = child_process.execFile(exePath);
+        (_a = this.child.stdout) == null ? void 0 : _a.on("data", (data) => {
+          const dataStr = data.toString();
+          if (dataStr.trim() === "TEXT_CHANGED") {
+            this.emit("text");
+          }
+          if (dataStr.trim() === "IMAGE_CHANGED") {
+            this.emit("image");
+          }
+        });
+        (_b = this.child.stderr) == null ? void 0 : _b.on("data", (data) => {
+          this.emit("open", data.toString());
+        });
+      }
+      stopListening() {
+        var _a;
+        this.emit("close");
+        const res = (_a = this.child) == null ? void 0 : _a.kill();
+        return res;
+      }
+    };
+    clipboard_default = new ClipboardEventListener();
+  }
+});
+
+// demo.ts
+var require_demo = __commonJS({
+  "demo.ts"() {
+    init_clipboard();
+    clipboard_default.on("text", () => {
+      console.log("Clipboard Text Updated");
+    });
+    clipboard_default.on("image", () => {
+      console.log("Clipboard Image Updated");
+    });
+    clipboard_default.on("open", (data) => {
+      console.log(data);
+    });
+    clipboard_default.startListening();
+    setTimeout(() => {
+      clipboard_default.stopListening();
+    }, 1e4);
+  }
+});
+var demo = require_demo();
+
+module.exports = demo;
+//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../demo.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAC7B,SAAgB,gBAA8D;AAH9E,IAKM,wBAkDC;AAvDP;AAAA;AAAA;AAKA,IAAM,yBAAN,cAAqC,aAAa;AAAA,MAEhD,cAAc;AACZ,cAAM;AACN,aAAK,QAAQ;AAAA,MACf;AAAA,MAEA,iBAAiB;AAZnB;AAaI,cAAM,EAAE,UAAU,KAAK,IAAI;AAC3B,cAAM,UAAU,CAAC,SAAS;AAE1B,YAAI,KAAK,SAAS,SAAS,MAAM,QAAQ;AACvC,kBAAQ,KAAK,IAAI;AAAA,QACnB;AACA,YAAI,cAAc,gBAAgB,YAAY;AAC9C,YAAI,aAAa,SAAS;AACxB,yBAAe;AAAA,QACjB;AACA,gBAAQ,KAAK,GAAG,CAAC,gBAAgB,YAAY,WAAW,CAAC;AACzD,cAAM,UAAU,KAAK,KAAK,GAAG,OAAO;AACpC,gBAAQ,IAAI,OAAO;AAEnB,YAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,gBAAM,IAAI;AAAA,YACR,eAAe,4CAA4C,YAAY;AAAA,UACzE;AAAA,QACF;AACA,aAAK,QAAQ,SAAS,OAAO;AAC7B,mBAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,gBAAM,UAAU,KAAK,SAAS;AAC9B,cAAI,QAAQ,KAAK,MAAM,gBAAgB;AACrC,iBAAK,KAAK,MAAM;AAAA,UAClB;AACA,cAAI,QAAQ,KAAK,MAAM,iBAAiB;AACtC,iBAAK,KAAK,OAAO;AAAA,UACnB;AAAA,QACF;AAEA,mBAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,eAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,QACnC;AAAA,MACF;AAAA,MAEA,gBAAgB;AAhDlB;AAiDI,aAAK,KAAK,OAAO;AACjB,cAAM,OAAM,UAAK,UAAL,mBAAY;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,IAAO,oBAAQ,IAAI,uBAAuB;AAAA;AAAA;;;ACvD1C;AAAA;AAAA;AAEA,sBAAuB,GAAG,QAAQ,MAAM;AACtC,cAAQ,IAAI,wBAAwB;AAAA,IACtC,CAAC;AAED,sBAAuB,GAAG,SAAS,MAAM;AACvC,cAAQ,IAAI,yBAAyB;AAAA,IACvC,CAAC;AAED,sBAAuB,GAAG,QAAQ,CAAC,SAAS;AAC1C,cAAQ,IAAI,IAAI;AAAA,IAClB,CAAC;AAED,sBAAuB,eAAe;AAEtC,eAAW,MAAM;AACf,wBAAuB,cAAc;AAAA,IACvC,GAAG,GAAK;AAAA;AAAA","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { EventEmitter } from 'events';\nimport { spawn, execFile, ChildProcessWithoutNullStreams, ChildProcess } from 'node:child_process';\n\nclass ClipboardEventListener extends EventEmitter {\n  child: ChildProcess | undefined;\n  constructor() {\n    super();\n    this.child = undefined;\n  }\n\n  startListening() {\n    const { platform, arch } = process;\n    const pathArr = [__dirname];\n\n    if (path.basename(__dirname) === 'dist') {\n      pathArr.push('..');\n    }\n    let exeFilename = `go-clipboard-${platform}-${arch}`;\n    if (platform === 'win32') {\n      exeFilename += '.exe';\n    }\n    pathArr.push(...['go-clipboard', 'binaries', exeFilename]);\n    const exePath = path.join(...pathArr);\n    console.log(exePath);\n    \n    if (!fs.existsSync(exePath)) {\n      throw new Error(\n        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`\n      );\n    }\n    this.child = execFile(exePath);\n    this.child.stdout?.on('data', (data: Buffer) => {\n      const dataStr = data.toString();\n      if (dataStr.trim() === 'TEXT_CHANGED') {\n        this.emit('text');\n      }\n      if (dataStr.trim() === 'IMAGE_CHANGED') {\n        this.emit('image');\n      }\n    });\n\n    this.child.stderr?.on('data', (data: Buffer) => {\n      this.emit('open', data.toString());\n    });\n  }\n\n  stopListening() {\n    this.emit('close');\n    const res = this.child?.kill();\n    return res;\n  }\n}\n\nexport default new ClipboardEventListener();\n","import clipboardEventListener from \"./index\";\n\nclipboardEventListener.on(\"text\", () => {\n  console.log(\"Clipboard Text Updated\");\n});\n\nclipboardEventListener.on(\"image\", () => {\n  console.log(\"Clipboard Image Updated\");\n});\n\nclipboardEventListener.on(\"open\", (data) => {\n  console.log(data);\n});\n\nclipboardEventListener.startListening();\n\nsetTimeout(() => {\n  clipboardEventListener.stopListening();\n}, 10000);\n"]}

package/dist/demo.mjs

@@ -0,0 +1,87 @@
+import fs from 'fs';
+import path from 'path';
+import { EventEmitter } from 'events';
+import { execFile } from 'child_process';
+
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var ClipboardEventListener, clipboard_default;
+var init_clipboard = __esm({
+  "index.ts"() {
+    ClipboardEventListener = class extends EventEmitter {
+      constructor() {
+        super();
+        this.child = void 0;
+      }
+      startListening() {
+        var _a, _b;
+        const { platform, arch } = process;
+        const pathArr = [__dirname];
+        if (path.basename(__dirname) === "dist") {
+          pathArr.push("..");
+        }
+        let exeFilename = `go-clipboard-${platform}-${arch}`;
+        if (platform === "win32") {
+          exeFilename += ".exe";
+        }
+        pathArr.push(...["go-clipboard", "binaries", exeFilename]);
+        const exePath = path.join(...pathArr);
+        console.log(exePath);
+        if (!fs.existsSync(exePath)) {
+          throw new Error(
+            `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`
+          );
+        }
+        this.child = execFile(exePath);
+        (_a = this.child.stdout) == null ? void 0 : _a.on("data", (data) => {
+          const dataStr = data.toString();
+          if (dataStr.trim() === "TEXT_CHANGED") {
+            this.emit("text");
+          }
+          if (dataStr.trim() === "IMAGE_CHANGED") {
+            this.emit("image");
+          }
+        });
+        (_b = this.child.stderr) == null ? void 0 : _b.on("data", (data) => {
+          this.emit("open", data.toString());
+        });
+      }
+      stopListening() {
+        var _a;
+        this.emit("close");
+        const res = (_a = this.child) == null ? void 0 : _a.kill();
+        return res;
+      }
+    };
+    clipboard_default = new ClipboardEventListener();
+  }
+});
+
+// demo.ts
+var require_demo = __commonJS({
+  "demo.ts"() {
+    init_clipboard();
+    clipboard_default.on("text", () => {
+      console.log("Clipboard Text Updated");
+    });
+    clipboard_default.on("image", () => {
+      console.log("Clipboard Image Updated");
+    });
+    clipboard_default.on("open", (data) => {
+      console.log(data);
+    });
+    clipboard_default.startListening();
+    setTimeout(() => {
+      clipboard_default.stopListening();
+    }, 1e4);
+  }
+});
+var demo = require_demo();
+
+export { demo as default };
+//# sourceMappingURL=demo.mjs.map

package/dist/demo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../demo.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAC7B,SAAgB,gBAA8D;AAH9E,IAKM,wBAkDC;AAvDP;AAAA;AAAA;AAKA,IAAM,yBAAN,cAAqC,aAAa;AAAA,MAEhD,cAAc;AACZ,cAAM;AACN,aAAK,QAAQ;AAAA,MACf;AAAA,MAEA,iBAAiB;AAZnB;AAaI,cAAM,EAAE,UAAU,KAAK,IAAI;AAC3B,cAAM,UAAU,CAAC,SAAS;AAE1B,YAAI,KAAK,SAAS,SAAS,MAAM,QAAQ;AACvC,kBAAQ,KAAK,IAAI;AAAA,QACnB;AACA,YAAI,cAAc,gBAAgB,YAAY;AAC9C,YAAI,aAAa,SAAS;AACxB,yBAAe;AAAA,QACjB;AACA,gBAAQ,KAAK,GAAG,CAAC,gBAAgB,YAAY,WAAW,CAAC;AACzD,cAAM,UAAU,KAAK,KAAK,GAAG,OAAO;AACpC,gBAAQ,IAAI,OAAO;AAEnB,YAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,gBAAM,IAAI;AAAA,YACR,eAAe,4CAA4C,YAAY;AAAA,UACzE;AAAA,QACF;AACA,aAAK,QAAQ,SAAS,OAAO;AAC7B,mBAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,gBAAM,UAAU,KAAK,SAAS;AAC9B,cAAI,QAAQ,KAAK,MAAM,gBAAgB;AACrC,iBAAK,KAAK,MAAM;AAAA,UAClB;AACA,cAAI,QAAQ,KAAK,MAAM,iBAAiB;AACtC,iBAAK,KAAK,OAAO;AAAA,UACnB;AAAA,QACF;AAEA,mBAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,eAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,QACnC;AAAA,MACF;AAAA,MAEA,gBAAgB;AAhDlB;AAiDI,aAAK,KAAK,OAAO;AACjB,cAAM,OAAM,UAAK,UAAL,mBAAY;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,IAAO,oBAAQ,IAAI,uBAAuB;AAAA;AAAA;;;ACvD1C;AAAA;AAAA;AAEA,sBAAuB,GAAG,QAAQ,MAAM;AACtC,cAAQ,IAAI,wBAAwB;AAAA,IACtC,CAAC;AAED,sBAAuB,GAAG,SAAS,MAAM;AACvC,cAAQ,IAAI,yBAAyB;AAAA,IACvC,CAAC;AAED,sBAAuB,GAAG,QAAQ,CAAC,SAAS;AAC1C,cAAQ,IAAI,IAAI;AAAA,IAClB,CAAC;AAED,sBAAuB,eAAe;AAEtC,eAAW,MAAM;AACf,wBAAuB,cAAc;AAAA,IACvC,GAAG,GAAK;AAAA;AAAA","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { EventEmitter } from 'events';\nimport { spawn, execFile, ChildProcessWithoutNullStreams, ChildProcess } from 'node:child_process';\n\nclass ClipboardEventListener extends EventEmitter {\n  child: ChildProcess | undefined;\n  constructor() {\n    super();\n    this.child = undefined;\n  }\n\n  startListening() {\n    const { platform, arch } = process;\n    const pathArr = [__dirname];\n\n    if (path.basename(__dirname) === 'dist') {\n      pathArr.push('..');\n    }\n    let exeFilename = `go-clipboard-${platform}-${arch}`;\n    if (platform === 'win32') {\n      exeFilename += '.exe';\n    }\n    pathArr.push(...['go-clipboard', 'binaries', exeFilename]);\n    const exePath = path.join(...pathArr);\n    console.log(exePath);\n    \n    if (!fs.existsSync(exePath)) {\n      throw new Error(\n        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`\n      );\n    }\n    this.child = execFile(exePath);\n    this.child.stdout?.on('data', (data: Buffer) => {\n      const dataStr = data.toString();\n      if (dataStr.trim() === 'TEXT_CHANGED') {\n        this.emit('text');\n      }\n      if (dataStr.trim() === 'IMAGE_CHANGED') {\n        this.emit('image');\n      }\n    });\n\n    this.child.stderr?.on('data', (data: Buffer) => {\n      this.emit('open', data.toString());\n    });\n  }\n\n  stopListening() {\n    this.emit('close');\n    const res = this.child?.kill();\n    return res;\n  }\n}\n\nexport default new ClipboardEventListener();\n","import clipboardEventListener from \"./index\";\n\nclipboardEventListener.on(\"text\", () => {\n  console.log(\"Clipboard Text Updated\");\n});\n\nclipboardEventListener.on(\"image\", () => {\n  console.log(\"Clipboard Image Updated\");\n});\n\nclipboardEventListener.on(\"open\", (data) => {\n  console.log(data);\n});\n\nclipboardEventListener.startListening();\n\nsetTimeout(() => {\n  clipboardEventListener.stopListening();\n}, 10000);\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { EventEmitter } from 'events';
+import { ChildProcess } from 'node:child_process';
+
+declare class ClipboardEventListener extends EventEmitter {
+    child: ChildProcess | undefined;
+    constructor();
+    startListening(): void;
+    stopListening(): boolean | undefined;
+}
+declare const _default: ClipboardEventListener;
+
+export { _default as default };

package/dist/index.js

@@ -0,0 +1,62 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var events = require('events');
+var child_process = require('child_process');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
+var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
+
+// index.ts
+var ClipboardEventListener = class extends events.EventEmitter {
+  constructor() {
+    super();
+    this.child = void 0;
+  }
+  startListening() {
+    var _a, _b;
+    const { platform, arch } = process;
+    const pathArr = [__dirname];
+    if (path__default["default"].basename(__dirname) === "dist") {
+      pathArr.push("..");
+    }
+    let exeFilename = `go-clipboard-${platform}-${arch}`;
+    if (platform === "win32") {
+      exeFilename += ".exe";
+    }
+    pathArr.push(...["go-clipboard", "binaries", exeFilename]);
+    const exePath = path__default["default"].join(...pathArr);
+    console.log(exePath);
+    if (!fs__default["default"].existsSync(exePath)) {
+      throw new Error(
+        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`
+      );
+    }
+    this.child = child_process.execFile(exePath);
+    (_a = this.child.stdout) == null ? void 0 : _a.on("data", (data) => {
+      const dataStr = data.toString();
+      if (dataStr.trim() === "TEXT_CHANGED") {
+        this.emit("text");
+      }
+      if (dataStr.trim() === "IMAGE_CHANGED") {
+        this.emit("image");
+      }
+    });
+    (_b = this.child.stderr) == null ? void 0 : _b.on("data", (data) => {
+      this.emit("open", data.toString());
+    });
+  }
+  stopListening() {
+    var _a;
+    this.emit("close");
+    const res = (_a = this.child) == null ? void 0 : _a.kill();
+    return res;
+  }
+};
+var clipboard_default = new ClipboardEventListener();
+
+module.exports = clipboard_default;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts"],"names":[],"mappings":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAC7B,SAAgB,gBAA8D;AAE9E,IAAM,yBAAN,cAAqC,aAAa;AAAA,EAEhD,cAAc;AACZ,UAAM;AACN,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,iBAAiB;AAZnB;AAaI,UAAM,EAAE,UAAU,KAAK,IAAI;AAC3B,UAAM,UAAU,CAAC,SAAS;AAE1B,QAAI,KAAK,SAAS,SAAS,MAAM,QAAQ;AACvC,cAAQ,KAAK,IAAI;AAAA,IACnB;AACA,QAAI,cAAc,gBAAgB,YAAY;AAC9C,QAAI,aAAa,SAAS;AACxB,qBAAe;AAAA,IACjB;AACA,YAAQ,KAAK,GAAG,CAAC,gBAAgB,YAAY,WAAW,CAAC;AACzD,UAAM,UAAU,KAAK,KAAK,GAAG,OAAO;AACpC,YAAQ,IAAI,OAAO;AAEnB,QAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,YAAM,IAAI;AAAA,QACR,eAAe,4CAA4C,YAAY;AAAA,MACzE;AAAA,IACF;AACA,SAAK,QAAQ,SAAS,OAAO;AAC7B,eAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,YAAM,UAAU,KAAK,SAAS;AAC9B,UAAI,QAAQ,KAAK,MAAM,gBAAgB;AACrC,aAAK,KAAK,MAAM;AAAA,MAClB;AACA,UAAI,QAAQ,KAAK,MAAM,iBAAiB;AACtC,aAAK,KAAK,OAAO;AAAA,MACnB;AAAA,IACF;AAEA,eAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,WAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,IACnC;AAAA,EACF;AAAA,EAEA,gBAAgB;AAhDlB;AAiDI,SAAK,KAAK,OAAO;AACjB,UAAM,OAAM,UAAK,UAAL,mBAAY;AACxB,WAAO;AAAA,EACT;AACF;AAEA,IAAO,oBAAQ,IAAI,uBAAuB","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { EventEmitter } from 'events';\nimport { spawn, execFile, ChildProcessWithoutNullStreams, ChildProcess } from 'node:child_process';\n\nclass ClipboardEventListener extends EventEmitter {\n  child: ChildProcess | undefined;\n  constructor() {\n    super();\n    this.child = undefined;\n  }\n\n  startListening() {\n    const { platform, arch } = process;\n    const pathArr = [__dirname];\n\n    if (path.basename(__dirname) === 'dist') {\n      pathArr.push('..');\n    }\n    let exeFilename = `go-clipboard-${platform}-${arch}`;\n    if (platform === 'win32') {\n      exeFilename += '.exe';\n    }\n    pathArr.push(...['go-clipboard', 'binaries', exeFilename]);\n    const exePath = path.join(...pathArr);\n    console.log(exePath);\n    \n    if (!fs.existsSync(exePath)) {\n      throw new Error(\n        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`\n      );\n    }\n    this.child = execFile(exePath);\n    this.child.stdout?.on('data', (data: Buffer) => {\n      const dataStr = data.toString();\n      if (dataStr.trim() === 'TEXT_CHANGED') {\n        this.emit('text');\n      }\n      if (dataStr.trim() === 'IMAGE_CHANGED') {\n        this.emit('image');\n      }\n    });\n\n    this.child.stderr?.on('data', (data: Buffer) => {\n      this.emit('open', data.toString());\n    });\n  }\n\n  stopListening() {\n    this.emit('close');\n    const res = this.child?.kill();\n    return res;\n  }\n}\n\nexport default new ClipboardEventListener();\n"]}

package/dist/index.mjs

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+import { EventEmitter } from 'events';
+import { execFile } from 'child_process';
+
+// index.ts
+var ClipboardEventListener = class extends EventEmitter {
+  constructor() {
+    super();
+    this.child = void 0;
+  }
+  startListening() {
+    var _a, _b;
+    const { platform, arch } = process;
+    const pathArr = [__dirname];
+    if (path.basename(__dirname) === "dist") {
+      pathArr.push("..");
+    }
+    let exeFilename = `go-clipboard-${platform}-${arch}`;
+    if (platform === "win32") {
+      exeFilename += ".exe";
+    }
+    pathArr.push(...["go-clipboard", "binaries", exeFilename]);
+    const exePath = path.join(...pathArr);
+    console.log(exePath);
+    if (!fs.existsSync(exePath)) {
+      throw new Error(
+        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`
+      );
+    }
+    this.child = execFile(exePath);
+    (_a = this.child.stdout) == null ? void 0 : _a.on("data", (data) => {
+      const dataStr = data.toString();
+      if (dataStr.trim() === "TEXT_CHANGED") {
+        this.emit("text");
+      }
+      if (dataStr.trim() === "IMAGE_CHANGED") {
+        this.emit("image");
+      }
+    });
+    (_b = this.child.stderr) == null ? void 0 : _b.on("data", (data) => {
+      this.emit("open", data.toString());
+    });
+  }
+  stopListening() {
+    var _a;
+    this.emit("close");
+    const res = (_a = this.child) == null ? void 0 : _a.kill();
+    return res;
+  }
+};
+var clipboard_default = new ClipboardEventListener();
+
+export { clipboard_default as default };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts"],"names":[],"mappings":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAC7B,SAAgB,gBAA8D;AAE9E,IAAM,yBAAN,cAAqC,aAAa;AAAA,EAEhD,cAAc;AACZ,UAAM;AACN,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,iBAAiB;AAZnB;AAaI,UAAM,EAAE,UAAU,KAAK,IAAI;AAC3B,UAAM,UAAU,CAAC,SAAS;AAE1B,QAAI,KAAK,SAAS,SAAS,MAAM,QAAQ;AACvC,cAAQ,KAAK,IAAI;AAAA,IACnB;AACA,QAAI,cAAc,gBAAgB,YAAY;AAC9C,QAAI,aAAa,SAAS;AACxB,qBAAe;AAAA,IACjB;AACA,YAAQ,KAAK,GAAG,CAAC,gBAAgB,YAAY,WAAW,CAAC;AACzD,UAAM,UAAU,KAAK,KAAK,GAAG,OAAO;AACpC,YAAQ,IAAI,OAAO;AAEnB,QAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,YAAM,IAAI;AAAA,QACR,eAAe,4CAA4C,YAAY;AAAA,MACzE;AAAA,IACF;AACA,SAAK,QAAQ,SAAS,OAAO;AAC7B,eAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,YAAM,UAAU,KAAK,SAAS;AAC9B,UAAI,QAAQ,KAAK,MAAM,gBAAgB;AACrC,aAAK,KAAK,MAAM;AAAA,MAClB;AACA,UAAI,QAAQ,KAAK,MAAM,iBAAiB;AACtC,aAAK,KAAK,OAAO;AAAA,MACnB;AAAA,IACF;AAEA,eAAK,MAAM,WAAX,mBAAmB,GAAG,QAAQ,CAAC,SAAiB;AAC9C,WAAK,KAAK,QAAQ,KAAK,SAAS,CAAC;AAAA,IACnC;AAAA,EACF;AAAA,EAEA,gBAAgB;AAhDlB;AAiDI,SAAK,KAAK,OAAO;AACjB,UAAM,OAAM,UAAK,UAAL,mBAAY;AACxB,WAAO;AAAA,EACT;AACF;AAEA,IAAO,oBAAQ,IAAI,uBAAuB","sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { EventEmitter } from 'events';\nimport { spawn, execFile, ChildProcessWithoutNullStreams, ChildProcess } from 'node:child_process';\n\nclass ClipboardEventListener extends EventEmitter {\n  child: ChildProcess | undefined;\n  constructor() {\n    super();\n    this.child = undefined;\n  }\n\n  startListening() {\n    const { platform, arch } = process;\n    const pathArr = [__dirname];\n\n    if (path.basename(__dirname) === 'dist') {\n      pathArr.push('..');\n    }\n    let exeFilename = `go-clipboard-${platform}-${arch}`;\n    if (platform === 'win32') {\n      exeFilename += '.exe';\n    }\n    pathArr.push(...['go-clipboard', 'binaries', exeFilename]);\n    const exePath = path.join(...pathArr);\n    console.log(exePath);\n    \n    if (!fs.existsSync(exePath)) {\n      throw new Error(\n        `Executable (${exeFilename}) not found, your platform is ${platform} ${arch} and may not be supported.`\n      );\n    }\n    this.child = execFile(exePath);\n    this.child.stdout?.on('data', (data: Buffer) => {\n      const dataStr = data.toString();\n      if (dataStr.trim() === 'TEXT_CHANGED') {\n        this.emit('text');\n      }\n      if (dataStr.trim() === 'IMAGE_CHANGED') {\n        this.emit('image');\n      }\n    });\n\n    this.child.stderr?.on('data', (data: Buffer) => {\n      this.emit('open', data.toString());\n    });\n  }\n\n  stopListening() {\n    this.emit('close');\n    const res = this.child?.kill();\n    return res;\n  }\n}\n\nexport default new ClipboardEventListener();\n"]}

package/go-clipboard/.idea/go-clipboard.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="Go" enabled="true" />
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/go-clipboard/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/go-clipboard.iml" filepath="$PROJECT_DIR$/.idea/go-clipboard.iml" />
+    </modules>
+  </component>
+</project>

package/go-clipboard/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

package/go-clipboard/Makefile

@@ -0,0 +1,8 @@
+build:
+	GOOS=darwin GORACH=arm64 go build -o binaries/go-clipboard-darwin-arm64
+	GOOS=darwin GORACH=amd64 go build -o binaries/go-clipboard-darwin-x64
+	GOOS=linux GORACH=386 go build -o binaries/go-clipboard-linux-386
+	GOOS=linux GORACH=arm go build -o binaries/go-clipboard-linux-arm
+	GOOS=linux GORACH=arm64 go build -o binaries/go-clipboard-linux-arm64
+	GOOS=linux GORACH=amd64 go build -o binaries/go-clipboard-linux-x64
+	GOOS=windows GORACH=amd64 go build -o binaries/go-clipboard-win32-x64.exe

package/go-clipboard/example/README.md

@@ -0,0 +1,11 @@
+# Example for IPC between Golang and Nodejs on the context of Clipboard Update Listening
+
+To run this example, within this folder
+
+```bash
+go build client.go && node server
+```
+
+Then copy some text or take a screenshot and see what's printed to stdout and image saved to disk.
+
+The screenshot image is updated for every screenshot you take.

package/go-clipboard/example/cb-ops.js

@@ -0,0 +1,34 @@
+const { execFile } = require("node:child_process");
+const fs = require("fs");
+
+const execPath = "./client";
+// const childWriteText = execFile(execPath, ["WRITE_TEXT"]);
+// childWriteText.stdin.write("huakun zui shuai")
+// childWriteText.stdin.end()
+// childWriteText.stdout.on('data', (d) => {
+//   console.log(d);
+// })
+
+const childWriteImage = execFile(execPath, ["WRITE_IMAGE"]);
+const base64img =
+  "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";
+childWriteImage.stdin.write(base64img);
+childWriteImage.stdin.end();
+
+// const childWriteImage = execFile(execPath, ["WRITE_IMAGE"]);
+// const base64img = "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"
+// childWriteImage.stdin.write(base64img)
+// childWriteImage.stdin.end()
+
+// const childtext = execFile(execPath, ["READ_TEXT"]);
+// childtext.stdout.on("data", (data) => {
+//   console.log(Buffer.from(data, 'base64').toString());
+// });
+
+setTimeout(() => {
+  const childimg = execFile(execPath, ["READ_IMAGE"]);
+  childimg.stdout.on("data", (data) => {
+    const imgBuf = Buffer.from(data, "base64");
+    fs.writeFileSync("test.png", imgBuf);
+  });
+}, 1000);

package/go-clipboard/example/client.go

@@ -0,0 +1,131 @@
+package main
+
+import (
+	"bufio"
+	"context"
+	"encoding/base64"
+	"fmt"
+	"log"
+	"net"
+	"os"
+	"sync"
+
+	"golang.design/x/clipboard"
+)
+
+// All possible ways to call this program
+// 1. client				(set up TCP socket client to connect to default port 8090)
+// 2. client 9999			(set up TCP socket client to connect to custom port 9999)
+// 3. client READ_TEXT		(Read Text from clipboard and output to stdout)
+// 4. client READ_IMAGE		(Read Image from clipboard and output to stdout in base64 encoding, whoever is reading this must decode it into bytes)
+// 5. client WRITE_TEXT		(Write Text to clipboard, data passed in through stdin, in base64 format (since there may be '\n' in raw data, base64 makes sure this doesn't exist))
+// 6. client WRITE_IMAGE	(Write Image to clipboard, data passed in through stdin, read as string, in base64 format. Have to decode into buffer before saving to clipboard)
+func main() {
+	err := clipboard.Init()
+	var port = "8090"
+	if len(os.Args) == 2 {
+		if os.Args[1] == "READ_TEXT" {
+			cbText := clipboard.Read(clipboard.FmtText)
+			fmt.Print(base64.StdEncoding.EncodeToString(cbText))
+			return
+		}
+
+		if os.Args[1] == "READ_IMAGE" {
+			cbImage := clipboard.Read(clipboard.FmtImage)
+			fmt.Println(base64.StdEncoding.EncodeToString(cbImage))
+			return
+		}
+
+		if os.Args[1] == "WRITE_TEXT" {
+			reader := bufio.NewReader(os.Stdin)
+			text, _ := reader.ReadString('\n')
+			clipboard.Write(clipboard.FmtText, []byte(text))
+			return
+		}
+
+		// This works with base64 string
+		if os.Args[1] == "WRITE_IMAGE" {
+			reader := bufio.NewReader(os.Stdin)
+			data, _ := reader.ReadString('\n')
+			imgBuf, _ := base64.StdEncoding.DecodeString(data)
+			clipboard.Write(clipboard.FmtImage, imgBuf)
+			return
+		}
+		// If none of the above are true, then parent process is calling me for setting up a TCP socket connection
+		// for bidirectional communication (for clipboard listening)
+		// So, the second command line arg is port
+		port = os.Args[1]
+	}
+
+	// The rest of the code is for clipboard watching
+	// connect TCP socket to server
+	address := fmt.Sprintf("localhost:%s", port)
+	// setup a long connection, but not used to transfer clipboard data, only for message notifications
+	con, err := net.Dial("tcp", address)
+	checkErr(err)
+	defer con.Close()
+
+	// since we continuously watch clipboard update, use wait group keep go routines running
+	var wg sync.WaitGroup
+	// * this is how to write send message to parent process using stdout
+	msg := "connection from go"
+	_, err = con.Write([]byte(msg))
+	checkErr(err)
+
+	textCh := clipboard.Watch(context.TODO(), clipboard.FmtText)
+	imgCh := clipboard.Watch(context.TODO(), clipboard.FmtImage)
+
+	// the text and image clipboard listeners will send message using separate socket connection
+	// because closing socket channel is required for the socket server to know when to wrap up received data
+	// large data chunks have to be sent in multiple TCP packages which have a size limit
+	// the socket server keeps getting data, accumulating data by concatenating packets received, but when to stop?
+	// socket server wraps up the data chunks received upon connection close
+	// this is why we use short socket connections to send data
+	// con (the long socket connection) is only used for sending notifications instead of data
+	wg.Add(1)
+	go func() {
+		for data := range textCh {
+			textCon, err := net.Dial("tcp", address)
+			checkErr(err)
+			// fmt.Println("TEXT_CHANGED") // write TEXT_CHANGED to stdout for parent process to detect clipboard text update
+			// cbText := clipboard.Read(clipboard.FmtText)
+			payload := "TEXT_CHANGED:" + base64.StdEncoding.EncodeToString(data)
+			textCon.Write([]byte(payload))
+			textCon.Close()
+		}
+
+	}()
+	wg.Add(1)
+	go func() {
+		for data := range imgCh {
+			imgCon, err := net.Dial("tcp", address)
+			checkErr(err)
+			fmt.Println("IMAGE_CHANGED") // write TEXT_CHANGED to stdout for parent process to detect clipboard text update
+			base64Img := base64.StdEncoding.EncodeToString(data)
+			payload := "IMAGE_CHANGED:" + base64Img
+			log.Println(len(payload))
+			imgCon.Write([]byte(payload))
+			imgCon.Close()
+		}
+	}()
+
+	// this is used to receive data from socket server / parent process
+	// doesn't need to be large, no massive data will be sent
+	reply := make([]byte, 1024)
+	wg.Add(1)
+	go func() {
+		for {
+			_, err = con.Read(reply)
+			checkErr(err)
+			data := string(reply)
+			fmt.Println(data)
+		}
+	}()
+	wg.Wait()
+}
+
+func checkErr(err error) {
+	if err != nil {
+		log.Fatal(err)
+	}
+}

package/go-clipboard/example/server.js

@@ -0,0 +1,48 @@
+const net = require("net");
+const fs = require("fs");
+const path = require("path");
+const { execFile } = require("node:child_process");
+
+const server = net.createServer(function (con) {
+  // client connected
+  let data = "";
+
+  // * demo of sending message to client,
+  // con.write("close");
+
+  /**
+   * Accumulate data by concatenating chunks of received data
+   */
+  con.on("data", (packet) => {
+    data += packet.toString();
+  });
+
+  /**
+   * When socket connection closes, wrap up received data
+   */
+  con.on("close", () => {
+    const strData = data.toString();
+    const subStr = strData.substring(0, 14);
+    if (subStr.includes("TEXT_CHANGED:")) {
+      console.log(
+        `Text Changed: ${Buffer.from(
+          strData.substring(13),
+          "base64"
+        ).toString()}`
+      );
+    } else if (subStr.includes("IMAGE_CHANGED:")) {
+      const imageBase64 = strData.substring(14).toString("base64");
+      console.log(`Image Changed`);
+      fs.writeFileSync('test.png', Buffer.from(imageBase64, "base64"));
+    }
+  });
+});
+
+server.listen(8090, function () {
+  console.log("server is listening");
+  const execPath = path.join(__dirname, "client");
+  const child = execFile(execPath, [server.address().port]);
+  child.stdout.on("data", (data) => {
+    console.log("Received data from client socket stdout:\n" + data);
+  });
+});

package/go-clipboard/main.go

@@ -0,0 +1,131 @@
+package main
+
+import (
+	"bufio"
+	"context"
+	"encoding/base64"
+	"fmt"
+	"log"
+	"net"
+	"os"
+	"sync"
+
+	"golang.design/x/clipboard"
+)
+
+// All possible ways to call this program
+// 1. client				(set up TCP socket client to connect to default port 8090)
+// 2. client 9999			(set up TCP socket client to connect to custom port 9999)
+// 3. client READ_TEXT		(Read Text from clipboard and output to stdout)
+// 4. client READ_IMAGE		(Read Image from clipboard and output to stdout in base64 encoding, whoever is reading this must decode it into bytes)
+// 5. client WRITE_TEXT		(Write Text to clipboard, data passed in through stdin, in base64 format (since there may be '\n' in raw data, base64 makes sure this doesn't exist))
+// 6. client WRITE_IMAGE	(Write Image to clipboard, data passed in through stdin, read as string, in base64 format. Have to decode into buffer before saving to clipboard)
+func main() {
+	err := clipboard.Init()
+	var port = "8090"
+	if len(os.Args) == 2 {
+		if os.Args[1] == "READ_TEXT" {
+			cbText := clipboard.Read(clipboard.FmtText)
+			fmt.Print(base64.StdEncoding.EncodeToString(cbText))
+			return
+		}
+
+		if os.Args[1] == "READ_IMAGE" {
+			cbImage := clipboard.Read(clipboard.FmtImage)
+			fmt.Println(base64.StdEncoding.EncodeToString(cbImage))
+			return
+		}
+
+		if os.Args[1] == "WRITE_TEXT" {
+			reader := bufio.NewReader(os.Stdin)
+			text, _ := reader.ReadString('\n')
+			clipboard.Write(clipboard.FmtText, []byte(text))
+			return
+		}
+
+		// This works with base64 string
+		if os.Args[1] == "WRITE_IMAGE" {
+			reader := bufio.NewReader(os.Stdin)
+			data, _ := reader.ReadString('\n')
+			imgBuf, _ := base64.StdEncoding.DecodeString(data)
+			clipboard.Write(clipboard.FmtImage, imgBuf)
+			return
+		}
+		// If none of the above are true, then parent process is calling me for setting up a TCP socket connection
+		// for bidirectional communication (for clipboard listening)
+		// So, the second command line arg is port
+		port = os.Args[1]
+	}
+
+	// The rest of the code is for clipboard watching
+	// connect TCP socket to server
+	address := fmt.Sprintf("localhost:%s", port)
+	// setup a long connection, but not used to transfer clipboard data, only for message notifications
+	con, err := net.Dial("tcp", address)
+	checkErr(err)
+	defer con.Close()
+
+	// since we continuously watch clipboard update, use wait group keep go routines running
+	var wg sync.WaitGroup
+	// * this is how to write send message to parent process using stdout
+	msg := "connection from go"
+	_, err = con.Write([]byte(msg))
+	checkErr(err)
+
+	textCh := clipboard.Watch(context.TODO(), clipboard.FmtText)
+	imgCh := clipboard.Watch(context.TODO(), clipboard.FmtImage)
+
+	// the text and image clipboard listeners will send message using separate socket connection
+	// because closing socket channel is required for the socket server to know when to wrap up received data
+	// large data chunks have to be sent in multiple TCP packages which have a size limit
+	// the socket server keeps getting data, accumulating data by concatenating packets received, but when to stop?
+	// socket server wraps up the data chunks received upon connection close
+	// this is why we use short socket connections to send data
+	// con (the long socket connection) is only used for sending notifications instead of data
+	wg.Add(1)
+	go func() {
+		for data := range textCh {
+			textCon, err := net.Dial("tcp", address)
+			checkErr(err)
+			// fmt.Println("TEXT_CHANGED") // write TEXT_CHANGED to stdout for parent process to detect clipboard text update
+			// cbText := clipboard.Read(clipboard.FmtText)
+			payload := "TEXT_CHANGED:" + base64.StdEncoding.EncodeToString(data)
+			textCon.Write([]byte(payload))
+			textCon.Close()
+		}
+
+	}()
+	wg.Add(1)
+	go func() {
+		for data := range imgCh {
+			imgCon, err := net.Dial("tcp", address)
+			checkErr(err)
+			fmt.Println("IMAGE_CHANGED") // write TEXT_CHANGED to stdout for parent process to detect clipboard text update
+			base64Img := base64.StdEncoding.EncodeToString(data)
+			payload := "IMAGE_CHANGED:" + base64Img
+			log.Println(len(payload))
+			imgCon.Write([]byte(payload))
+			imgCon.Close()
+		}
+	}()
+
+	// this is used to receive data from socket server / parent process
+	// doesn't need to be large, no massive data will be sent
+	reply := make([]byte, 1024)
+	wg.Add(1)
+	go func() {
+		for {
+			_, err = con.Read(reply)
+			checkErr(err)
+			data := string(reply)
+			fmt.Println(data)
+		}
+	}()
+	wg.Wait()
+}
+
+func checkErr(err error) {
+	if err != nil {
+		log.Fatal(err)
+	}
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@crosscopy/clipboard",
+  "version": "0.1.0-beta",
+  "description": "Cross Platform Clipboard listener that detects both text and image update in clipboard",
+  "source": "index.ts",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "type": "commonjs",
+  "scripts": {
+    "build": "tsup",
+    "demo": "ts-node demo.ts",
+    "test": "jest ./__tests__"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HuakunShen/general-clipboard-listener.git"
+  },
+  "keywords": [
+    "clipboard"
+  ],
+  "author": "Huakun Shen",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/HuakunShen/general-clipboard-listener/issues"
+  },
+  "homepage": "https://github.com/HuakunShen/general-clipboard-listener#readme",
+  "dependencies": {
+    "events": "^3.3.0",
+    "execa": "^6.1.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.3.1",
+    "@types/jest": "^29.2.4",
+    "@types/node": "^18.11.7",
+    "jest": "^29.3.1",
+    "ts-jest": "^29.0.3",
+    "ts-node": "^10.9.1",
+    "tsup": "^6.3.0",
+    "typescript": "^4.8.4"
+  },
+  "files": [
+    "dist",
+    "go-clipboard",
+    "README.md"
+  ]
+}