@noartem/xews 1.0.0 → 1.1.0

package/README.md

@@ -4,6 +4,8 @@
 
 It is useful when you already have EWS access and want a simple way to upload, list, download, and clear files through Exchange without opening a mail client.
 
+It can also synchronize one local folder through a dedicated draft-based channel. Sync sends changes as compressed batch attachments and removes each package after it is applied.
+
 ## Install
 
 Install from a local checkout:
@@ -58,6 +60,7 @@ Typical file transfer flow:
 xews upload --file ./archive.zip
 xews ls
 xews download
+xews sync --dir ./data --channel team-a
 ```
 
 Show help:
@@ -97,6 +100,18 @@ Clear all attachments from the first draft:
 xews clear
 ```
 
+Synchronize one local folder through a dedicated draft subject:
+
+```bash
+xews sync --dir ./tmp/a --channel local-test
+```
+
+Run a single sync cycle and exit:
+
+```bash
+xews sync --dir ./tmp/a --channel local-test --once
+```
+
 ## Commands
 
 - `init`: create `~/.config/xews/auth.json` if needed and open it in your default editor
@@ -104,6 +119,7 @@ xews clear
 - `download`: download all file attachments from the first draft into the current directory
 - `list` / `ls`: show attachment names and sizes from the first draft
 - `clear`: remove all attachments from the first draft
+- `sync`: synchronize one folder through a dedicated draft channel like `xews-sync:<channel>`
 
 ## Publish
 

package/index.js

@@ -18,9 +18,12 @@ import {
   FileAttachment,
   DeleteMode,
   MessageBody,
+  SearchFilter,
+  ItemSchema,
 } from "ews-javascript-api";
 
 import { Cli, z } from "incur";
+import { runSync } from "./sync.js";
 
 const CLI_VERSION = "1.0.0";
 const CONFIG_PATH = path.join(os.homedir(), ".config", "xews", "auth.json");
@@ -129,6 +132,36 @@ async function getFirstDraft(service) {
   return draft;
 }
 
+async function getDraftBySubject(service, subject) {
+  const filter = new SearchFilter.IsEqualTo(ItemSchema.Subject, subject);
+  const res = await service.FindItems(
+    WellKnownFolderName.Drafts,
+    filter,
+    new ItemView(1),
+  );
+
+  if (res.Items.length === 0) return null;
+
+  const draft = res.Items[0];
+  await draft.Load(new PropertySet(BasePropertySet.FirstClassProperties));
+  return draft;
+}
+
+async function getOrCreateDraftBySubject(service, subject) {
+  const draft = await getDraftBySubject(service, subject);
+
+  if (draft) return draft;
+
+  const created = new EmailMessage(service);
+  created.Subject = subject;
+  created.Body = new MessageBody(`Generated for ${subject}`);
+
+  await created.Save(WellKnownFolderName.Drafts);
+  await created.Load(new PropertySet(BasePropertySet.FirstClassProperties));
+
+  return created;
+}
+
 /* ================= ENTRY ================= */
 
 const cli = Cli.create("xews", {
@@ -274,4 +307,38 @@ cli.command("clear", {
   },
 });
 
+cli.command("sync", {
+  description: "Synchronize one folder through an EWS draft channel",
+  options: z.object({
+    dir: z.string().describe("Folder to synchronize"),
+    channel: z
+      .string()
+      .default("default")
+      .describe("Sync channel name stored in a dedicated draft subject"),
+    interval: z
+      .number()
+      .int()
+      .positive()
+      .default(2000)
+      .describe("Polling interval in milliseconds"),
+    once: z.boolean().default(false).describe("Run one sync cycle and exit"),
+  }),
+  alias: {
+    dir: "d",
+    channel: "c",
+  },
+  async run(c) {
+    const service = createService();
+
+    await runSync({
+      service,
+      rootDir: c.options.dir,
+      channel: c.options.channel,
+      intervalMs: c.options.interval,
+      once: c.options.once,
+      getOrCreateDraftBySubject,
+    });
+  },
+});
+
 await cli.serve();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noartem/xews",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI for transferring files through Exchange drafts over EWS",
   "main": "index.js",
   "scripts": {