gws-axi 0.10.2 → 0.12.0

package/dist/src/commands/drive/mkdir.d.ts

@@ -0,0 +1,7 @@
+export declare const MKDIR_HELP = "usage: gws-axi drive mkdir <name> [flags]\nargs[1]:\n  <name>               REQUIRED \u2014 the folder name\nflags[2]:\n  --parent <folder-id> Parent folder ID (default: My Drive root)\n  --account <email>    REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi drive mkdir \"Q2 Reports\"\n  gws-axi drive mkdir Invoices --parent 1AbC...\nnotes:\n  Drive allows duplicate folder names \u2014 re-running creates ANOTHER folder.\n  Capture the returned id to nest uploads with `drive upload --parent <id>`.\noutput:\n  An `action: created` line plus a `folder{...}` object with id, name,\n  parents, and web_view_link.\n";
+export interface ParsedFlags {
+    name: string | undefined;
+    parent: string | undefined;
+}
+export declare function parseFlags(args: string[]): ParsedFlags;
+export declare function driveMkdirCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/drive/mkdir.js

@@ -0,0 +1,101 @@
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+export const MKDIR_HELP = `usage: gws-axi drive mkdir <name> [flags]
+args[1]:
+  <name>               REQUIRED — the folder name
+flags[2]:
+  --parent <folder-id> Parent folder ID (default: My Drive root)
+  --account <email>    REQUIRED when 2+ accounts are authenticated
+examples:
+  gws-axi drive mkdir "Q2 Reports"
+  gws-axi drive mkdir Invoices --parent 1AbC...
+notes:
+  Drive allows duplicate folder names — re-running creates ANOTHER folder.
+  Capture the returned id to nest uploads with \`drive upload --parent <id>\`.
+output:
+  An \`action: created\` line plus a \`folder{...}\` object with id, name,
+  parents, and web_view_link.
+`;
+const FOLDER_MIME = "application/vnd.google-apps.folder";
+const MKDIR_FIELDS = "id,name,parents,webViewLink";
+export function parseFlags(args) {
+    const flags = { name: undefined, parent: undefined };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--parent":
+                flags.parent = next;
+                i++;
+                break;
+            default:
+                if (!arg.startsWith("--") && flags.name === undefined) {
+                    flags.name = arg;
+                }
+                break;
+        }
+    }
+    return flags;
+}
+export async function driveMkdirCommand(account, args) {
+    const flags = parseFlags(args);
+    if (!flags.name) {
+        throw new AxiError("Missing folder name", "VALIDATION_ERROR", [
+            "Usage: gws-axi drive mkdir <name> [--parent <folder-id>]",
+        ]);
+    }
+    const api = await driveClient(account);
+    const requestBody = {
+        name: flags.name,
+        mimeType: FOLDER_MIME,
+    };
+    if (flags.parent)
+        requestBody.parents = [flags.parent];
+    let folder;
+    try {
+        const res = await api.files.create({
+            requestBody,
+            fields: MKDIR_FIELDS,
+            supportsAllDrives: true,
+        });
+        folder = res.data;
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: "drive.files.create",
+        });
+        if (translated.code === "NOT_FOUND") {
+            throw new AxiError(`Parent folder '${flags.parent}' not found (or ${account} can't write to it)`, "FILE_NOT_FOUND", [
+                "Verify the --parent ID is correct (from a Drive URL or `drive ls` / `drive search`)",
+                `Confirm ${account} has edit access`,
+            ]);
+        }
+        throw translated;
+    }
+    const id = folder.id ?? "";
+    const details = {
+        id,
+        name: folder.name ?? flags.name,
+        parents: folder.parents?.length ? folder.parents.join(", ") : "",
+    };
+    if (folder.webViewLink)
+        details.web_view_link = folder.webViewLink;
+    const blocks = [];
+    blocks.push(renderObject({ action: "created", account }));
+    blocks.push(renderObject({ folder: details }));
+    const suggestions = [
+        `Run \`gws-axi drive upload <file> --parent ${id}\` to put a file in this folder`,
+        `Run \`gws-axi drive ls ${id}\` to list its contents`,
+        `Run \`gws-axi drive get ${id}\` for full metadata`,
+        `Run \`gws-axi drive permissions ${id}\` to see / change who has access`,
+        `Re-running creates another folder (Drive allows duplicate names) — capture this id to reuse it`,
+    ];
+    if (folder.webViewLink) {
+        suggestions.push(`Open in browser: ${folder.webViewLink}`);
+    }
+    blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=mkdir.js.map

package/dist/src/commands/drive/mkdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../../src/commands/drive/mkdir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;CAezB,CAAC;AAEF,MAAM,WAAW,GAAG,oCAAoC,CAAC;AACzD,MAAM,YAAY,GAAG,6BAA6B,CAAC;AAOnD,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,UAAU;gBACb,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;gBACpB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR;gBACE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBACtD,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;gBACnB,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,IAAc;IAEd,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,kBAAkB,EAAE;YAC5D,0DAA0D;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,WAAW,GAAyB;QACxC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,WAAW;KACtB,CAAC;IACF,IAAI,KAAK,CAAC,MAAM;QAAE,WAAW,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvD,IAAI,MAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;YACjC,WAAW;YACX,MAAM,EAAE,YAAY;YACpB,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,EAAE;YAC3C,OAAO;YACP,SAAS,EAAE,oBAAoB;SAChC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACpC,MAAM,IAAI,QAAQ,CAChB,kBAAkB,KAAK,CAAC,MAAM,mBAAmB,OAAO,qBAAqB,EAC7E,gBAAgB,EAChB;gBACE,qFAAqF;gBACrF,WAAW,OAAO,kBAAkB;aACrC,CACF,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3B,MAAM,OAAO,GAA4B;QACvC,EAAE;QACF,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;KACjE,CAAC;IACF,IAAI,MAAM,CAAC,WAAW;QAAE,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC;IAEnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAE/C,MAAM,WAAW,GAAa;QAC5B,8CAA8C,EAAE,iCAAiC;QACjF,0BAA0B,EAAE,yBAAyB;QACrD,2BAA2B,EAAE,sBAAsB;QACnD,mCAAmC,EAAE,mCAAmC;QACxE,gGAAgG;KACjG,CAAC;IACF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACrC,OAAO,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/commands/drive/mkdir.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/commands/drive/mkdir.test.js

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import { AxiError } from "axi-sdk-js";
+import { parseFlags, driveMkdirCommand } from "./mkdir.js";
+describe("drive mkdir parseFlags", () => {
+    it("parses a bare name with no parent", () => {
+        const f = parseFlags(["Reports"]);
+        expect(f.name).toBe("Reports");
+        expect(f.parent).toBeUndefined();
+    });
+    it("parses a quoted multi-word name and --parent", () => {
+        const f = parseFlags(["Q2 Reports", "--parent", "1AbC"]);
+        expect(f.name).toBe("Q2 Reports");
+        expect(f.parent).toBe("1AbC");
+    });
+    it("takes the first positional as the name, ignoring later ones", () => {
+        const f = parseFlags(["first", "second"]);
+        expect(f.name).toBe("first");
+    });
+    it("leaves name undefined when only flags are given", () => {
+        const f = parseFlags(["--parent", "1AbC"]);
+        expect(f.name).toBeUndefined();
+        expect(f.parent).toBe("1AbC");
+    });
+});
+describe("drive mkdir command validation", () => {
+    it("throws VALIDATION_ERROR when the name is missing", async () => {
+        await expect(driveMkdirCommand("a@b.com", ["--parent", "1AbC"])).rejects.toMatchObject({ code: "VALIDATION_ERROR" });
+    });
+    it("rejects with an AxiError (not a raw throw) on missing name", async () => {
+        try {
+            await driveMkdirCommand("a@b.com", []);
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AxiError);
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+//# sourceMappingURL=mkdir.test.js.map

package/dist/src/commands/drive/mkdir.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkdir.test.js","sourceRoot":"","sources":["../../../../src/commands/drive/mkdir.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CACpF,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAE,GAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/drive/upload.d.ts

@@ -0,0 +1,17 @@
+export declare const UPLOAD_HELP = "usage: gws-axi drive upload <local-path> [flags]\nargs[1]:\n  <local-path>         REQUIRED \u2014 path to a readable local file to upload\nflags[5]:\n  --parent <folder-id> Destination folder ID (default: My Drive root).\n                       Cannot be combined with --update.\n  --name <name>        Name to give the file in Drive (default: the local\n                       file's basename). With --update, renames the target.\n  --mime <type>        Override the source content type (default: detected\n                       from the file extension; unknown \u2192 application/octet-stream)\n  --convert            Convert to the matching native Google format on upload\n                       (.docx\u2192Doc, .xlsx/.csv\u2192Sheet, .pptx\u2192Slides). Cannot be\n                       combined with --update.\n  --update <file-id>   Replace an existing file's content (new revision)\n                       instead of creating a new file.\n  --account <email>    REQUIRED when 2+ accounts are authenticated\nexamples:\n  gws-axi drive upload ./report.pdf\n  gws-axi drive upload ./report.pdf --parent 1AbC... --name \"Q2 Report.pdf\"\n  gws-axi drive upload ./notes.docx --convert\n  gws-axi drive upload ./report.pdf --update 1XyZ...\nnotes:\n  Without --update, every upload creates a NEW Drive file \u2014 re-running makes\n  another copy (Drive allows duplicate names). Use --update <id> to replace an\n  existing file's content in place.\noutput:\n  An `action: created` (or `updated`) line plus a `file{...}` object with\n  id, name, mime_type, size_bytes, parents, and web_view_link.\n";
+export interface ParsedFlags {
+    localPath: string | undefined;
+    parent: string | undefined;
+    name: string | undefined;
+    mime: string | undefined;
+    convert: boolean;
+    update: string | undefined;
+}
+export declare function parseFlags(args: string[]): ParsedFlags;
+/**
+ * Validate the local path is present and the flag combination is legal,
+ * before any FS/network work. Pure — throws `AxiError` on the same cases the
+ * spec enumerates, so it's unit-testable without touching disk or Google.
+ */
+export declare function validateFlags(flags: ParsedFlags): void;
+export declare function driveUploadCommand(account: string, args: string[]): Promise<string>;

package/dist/src/commands/drive/upload.js

@@ -0,0 +1,217 @@
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { AxiError } from "axi-sdk-js";
+import { driveClient, translateGoogleError } from "../../google/client.js";
+import { joinBlocks, renderHelp, renderObject } from "../../output/index.js";
+import { detectMimeType, googleConversionTarget, } from "../../util/mime-types.js";
+export const UPLOAD_HELP = `usage: gws-axi drive upload <local-path> [flags]
+args[1]:
+  <local-path>         REQUIRED — path to a readable local file to upload
+flags[5]:
+  --parent <folder-id> Destination folder ID (default: My Drive root).
+                       Cannot be combined with --update.
+  --name <name>        Name to give the file in Drive (default: the local
+                       file's basename). With --update, renames the target.
+  --mime <type>        Override the source content type (default: detected
+                       from the file extension; unknown → application/octet-stream)
+  --convert            Convert to the matching native Google format on upload
+                       (.docx→Doc, .xlsx/.csv→Sheet, .pptx→Slides). Cannot be
+                       combined with --update.
+  --update <file-id>   Replace an existing file's content (new revision)
+                       instead of creating a new file.
+  --account <email>    REQUIRED when 2+ accounts are authenticated
+examples:
+  gws-axi drive upload ./report.pdf
+  gws-axi drive upload ./report.pdf --parent 1AbC... --name "Q2 Report.pdf"
+  gws-axi drive upload ./notes.docx --convert
+  gws-axi drive upload ./report.pdf --update 1XyZ...
+notes:
+  Without --update, every upload creates a NEW Drive file — re-running makes
+  another copy (Drive allows duplicate names). Use --update <id> to replace an
+  existing file's content in place.
+output:
+  An \`action: created\` (or \`updated\`) line plus a \`file{...}\` object with
+  id, name, mime_type, size_bytes, parents, and web_view_link.
+`;
+export function parseFlags(args) {
+    const flags = {
+        localPath: undefined,
+        parent: undefined,
+        name: undefined,
+        mime: undefined,
+        convert: false,
+        update: undefined,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--parent":
+                flags.parent = next;
+                i++;
+                break;
+            case "--name":
+                flags.name = next;
+                i++;
+                break;
+            case "--mime":
+                flags.mime = next;
+                i++;
+                break;
+            case "--convert":
+                flags.convert = true;
+                break;
+            case "--update":
+                flags.update = next;
+                i++;
+                break;
+            default:
+                if (!arg.startsWith("--") && flags.localPath === undefined) {
+                    flags.localPath = arg;
+                }
+                break;
+        }
+    }
+    return flags;
+}
+const UPLOAD_FIELDS = "id,name,mimeType,size,parents,webViewLink";
+/**
+ * Validate the local path is present and the flag combination is legal,
+ * before any FS/network work. Pure — throws `AxiError` on the same cases the
+ * spec enumerates, so it's unit-testable without touching disk or Google.
+ */
+export function validateFlags(flags) {
+    if (!flags.localPath) {
+        throw new AxiError("Missing local file path", "VALIDATION_ERROR", [
+            "Usage: gws-axi drive upload <local-path> [flags]",
+        ]);
+    }
+    if (flags.update && flags.parent) {
+        throw new AxiError("--parent cannot be combined with --update", "VALIDATION_ERROR", [
+            "--update replaces a file's content in place; moving folders is not supported here",
+            "Drop --parent, or upload as a new file (omit --update) to place it in a folder",
+        ]);
+    }
+    if (flags.update && flags.convert) {
+        throw new AxiError("--convert cannot be combined with --update", "VALIDATION_ERROR", [
+            "Converting a file's type in place is not supported",
+            "Drop --convert to replace content as-is, or upload a new file (omit --update) with --convert",
+        ]);
+    }
+}
+export async function driveUploadCommand(account, args) {
+    const flags = parseFlags(args);
+    validateFlags(flags);
+    const absolutePath = resolve(process.cwd(), flags.localPath);
+    let fileStat;
+    try {
+        fileStat = await stat(absolutePath);
+    }
+    catch {
+        throw new AxiError(`Local file not found: ${flags.localPath}`, "LOCAL_FILE_NOT_FOUND", ["Check the path; it must be a readable file on this machine"]);
+    }
+    if (fileStat.isDirectory()) {
+        throw new AxiError(`Local path is a directory, not a file: ${flags.localPath}`, "LOCAL_PATH_NOT_FILE", ["Upload a single file; recursive directory upload is not supported"]);
+    }
+    const name = flags.name ?? basename(absolutePath);
+    const sourceMime = flags.mime ?? detectMimeType(absolutePath);
+    let targetMime;
+    if (flags.convert) {
+        const target = googleConversionTarget(sourceMime);
+        if (!target) {
+            throw new AxiError(`Cannot convert ${sourceMime} to a native Google format`, "UNSUPPORTED_CONVERSION", [
+                "Supported: word-processing/text → Doc, spreadsheets/CSV → Sheet, presentations → Slides",
+                "Drop --convert to upload the file as-is",
+            ]);
+        }
+        targetMime = target;
+    }
+    const api = await driveClient(account);
+    const media = {
+        mimeType: sourceMime,
+        body: createReadStream(absolutePath),
+    };
+    let file;
+    const updating = Boolean(flags.update);
+    try {
+        if (flags.update) {
+            const res = await api.files.update({
+                fileId: flags.update,
+                requestBody: flags.name ? { name } : {},
+                media,
+                fields: UPLOAD_FIELDS,
+                supportsAllDrives: true,
+            });
+            file = res.data;
+        }
+        else {
+            const requestBody = { name };
+            if (flags.parent)
+                requestBody.parents = [flags.parent];
+            if (targetMime)
+                requestBody.mimeType = targetMime;
+            const res = await api.files.create({
+                requestBody,
+                media,
+                fields: UPLOAD_FIELDS,
+                supportsAllDrives: true,
+            });
+            file = res.data;
+        }
+    }
+    catch (err) {
+        const translated = translateGoogleError(err, {
+            account,
+            operation: updating ? "drive.files.update" : "drive.files.create",
+        });
+        if (translated.code === "NOT_FOUND") {
+            // For --update, the missing item is the target file; for create it's the
+            // --parent folder. Re-wrap with an access-check suggestion (cf. drive get).
+            const missing = updating
+                ? `File '${flags.update}' not found (or ${account} can't write to it)`
+                : `Parent folder '${flags.parent}' not found (or ${account} can't write to it)`;
+            throw new AxiError(missing, "FILE_NOT_FOUND", [
+                "Verify the ID is correct (from a Drive URL or `drive search` / `drive ls`)",
+                `Confirm ${account} has edit access`,
+            ]);
+        }
+        throw translated;
+    }
+    const details = {
+        id: file.id ?? "",
+        name: file.name ?? name,
+        mime_type: file.mimeType ?? "",
+    };
+    if (file.size)
+        details.size_bytes = parseInt(file.size, 10);
+    details.parents = file.parents?.length ? file.parents.join(", ") : "";
+    if (file.webViewLink)
+        details.web_view_link = file.webViewLink;
+    const blocks = [];
+    blocks.push(renderObject({ action: updating ? "updated" : "created", account }));
+    blocks.push(renderObject({ file: details }));
+    const suggestions = [];
+    const id = file.id ?? "";
+    const isNativeDoc = file.mimeType === "application/vnd.google-apps.document";
+    if (isNativeDoc) {
+        suggestions.push(`Run \`gws-axi docs read ${id}\` to read it as markdown`);
+    }
+    else if ((file.mimeType ?? "").startsWith("application/vnd.google-apps.")) {
+        suggestions.push(`Native Google file — run \`gws-axi docs download ${id} --as <mime>\` to export it`);
+    }
+    else {
+        suggestions.push(`Run \`gws-axi docs download ${id} --out <path>\` to fetch the bytes back`);
+    }
+    suggestions.push(`Run \`gws-axi drive get ${id}\` for full metadata`);
+    suggestions.push(`Run \`gws-axi drive permissions ${id}\` to see / change who has access`);
+    if (!updating) {
+        suggestions.push(`Re-running creates another copy — pass \`--update ${id}\` to replace this file's content instead`);
+    }
+    if (file.webViewLink) {
+        suggestions.push(`Open in browser: ${file.webViewLink}`);
+    }
+    blocks.push(renderHelp(suggestions));
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=upload.js.map

package/dist/src/commands/drive/upload.js.map

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

package/dist/src/commands/drive/upload.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/commands/drive/upload.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { AxiError } from "axi-sdk-js";
+import { parseFlags, validateFlags } from "./upload.js";
+describe("drive upload parseFlags", () => {
+    it("parses a bare local path with defaults", () => {
+        const f = parseFlags(["./report.pdf"]);
+        expect(f.localPath).toBe("./report.pdf");
+        expect(f.parent).toBeUndefined();
+        expect(f.name).toBeUndefined();
+        expect(f.mime).toBeUndefined();
+        expect(f.convert).toBe(false);
+        expect(f.update).toBeUndefined();
+    });
+    it("parses all flags", () => {
+        const f = parseFlags([
+            "./report.pdf",
+            "--parent",
+            "1AbC",
+            "--name",
+            "Q2 Report.pdf",
+            "--mime",
+            "application/pdf",
+            "--convert",
+        ]);
+        expect(f.localPath).toBe("./report.pdf");
+        expect(f.parent).toBe("1AbC");
+        expect(f.name).toBe("Q2 Report.pdf");
+        expect(f.mime).toBe("application/pdf");
+        expect(f.convert).toBe(true);
+    });
+    it("parses --update with a file id", () => {
+        const f = parseFlags(["./report.pdf", "--update", "1XyZ"]);
+        expect(f.update).toBe("1XyZ");
+    });
+    it("takes the first positional as the local path, ignoring later ones", () => {
+        const f = parseFlags(["./a.pdf", "./b.pdf"]);
+        expect(f.localPath).toBe("./a.pdf");
+    });
+});
+describe("drive upload validateFlags", () => {
+    const base = {
+        localPath: "./report.pdf",
+        parent: undefined,
+        name: undefined,
+        mime: undefined,
+        convert: false,
+        update: undefined,
+    };
+    it("accepts a valid create invocation", () => {
+        expect(() => validateFlags({ ...base, parent: "1AbC" })).not.toThrow();
+    });
+    it("accepts a valid update invocation", () => {
+        expect(() => validateFlags({ ...base, update: "1XyZ" })).not.toThrow();
+    });
+    it("throws VALIDATION_ERROR when the local path is missing", () => {
+        try {
+            validateFlags({ ...base, localPath: undefined });
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AxiError);
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+    it("rejects --parent combined with --update", () => {
+        try {
+            validateFlags({ ...base, parent: "1AbC", update: "1XyZ" });
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AxiError);
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+    it("rejects --convert combined with --update", () => {
+        try {
+            validateFlags({ ...base, convert: true, update: "1XyZ" });
+            throw new Error("should have thrown");
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(AxiError);
+            expect(err.code).toBe("VALIDATION_ERROR");
+        }
+    });
+});
+//# sourceMappingURL=upload.test.js.map

package/dist/src/commands/drive/upload.test.js.map

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

package/dist/src/commands/drive.js

@@ -7,6 +7,8 @@ import { drivePermissionsCommand, PERMISSIONS_HELP, } from "./drive/permissions.
 import { driveActivityCommand, ACTIVITY_HELP } from "./drive/activity.js";
 import { driveRevisionsCommand, REVISIONS_HELP, } from "./drive/revisions.js";
 import { driveSearchCommand, SEARCH_HELP } from "./drive/search.js";
+import { driveUploadCommand, UPLOAD_HELP } from "./drive/upload.js";
+import { driveMkdirCommand, MKDIR_HELP } from "./drive/mkdir.js";
 // Drive `download` shares the docs/download.ts implementation — same code
 // path handles native Google file export + uploaded-file media fetch.
 const DOWNLOAD_HELP = `usage: gws-axi drive download <file-id> [flags]
@@ -45,9 +47,6 @@ status: planned for v1 writes — not yet implemented
 const DELETE_HELP = `usage: gws-axi drive delete <file-id> [flags]
 status: planned for v1 writes — not yet implemented
 `;
-const MKDIR_HELP = `usage: gws-axi drive mkdir --name <name> --parent <folder-id> [flags]
-status: planned for v1 writes — not yet implemented
-`;
 const SUBCOMMANDS = [
     { name: "search", mutation: false, help: SEARCH_HELP, handler: driveSearchCommand },
     { name: "get", mutation: false, help: GET_HELP, handler: driveGetCommand },
@@ -77,12 +76,23 @@ const SUBCOMMANDS = [
         help: ACTIVITY_HELP,
         handler: driveActivityCommand,
     },
+    {
+        name: "upload",
+        mutation: true,
+        help: UPLOAD_HELP,
+        handler: driveUploadCommand,
+    },
     { name: "create", mutation: true, help: CREATE_HELP },
     { name: "copy", mutation: true, help: COPY_HELP },
     { name: "move", mutation: true, help: MOVE_HELP },
     { name: "rename", mutation: true, help: RENAME_HELP },
     { name: "delete", mutation: true, help: DELETE_HELP },
-    { name: "mkdir", mutation: true, help: MKDIR_HELP },
+    {
+        name: "mkdir",
+        mutation: true,
+        help: MKDIR_HELP,
+        handler: driveMkdirCommand,
+    },
 ];
 const SUB_BY_NAME = Object.fromEntries(SUBCOMMANDS.map((s) => [s.name, s]));
 function parseAccountFlag(args) {
@@ -109,20 +119,24 @@ writes[${writes.length}]:
 notes:
   Writes require --account <email> when 2+ accounts are authenticated.
   Reads use the default account when --account is not provided.
-  Write subcommands are scaffolded for the next slice; they throw
-  NOT_IMPLEMENTED after account resolution runs.
+  upload and mkdir are live; the remaining write subcommands are scaffolded
+  for the next slice and throw NOT_IMPLEMENTED after account resolution runs.
 subcommand help:
   gws-axi drive ls --help            for folder listing (incl. --recursive)
   gws-axi drive get --help           for full file metadata
   gws-axi drive search --help        for full-text search
   gws-axi drive permissions --help   for access / sharing
   gws-axi drive download --help      for fetching bytes (alias of docs download)
+  gws-axi drive upload --help        for uploading a local file (incl. --convert)
+  gws-axi drive mkdir --help         for creating a folder
 examples:
   gws-axi drive ls
   gws-axi drive ls <folder-id> --recursive
   gws-axi drive search --query "project plan"
   gws-axi drive get <file-id>
   gws-axi drive permissions <file-id>
+  gws-axi drive upload ./report.pdf --account you@example.com
+  gws-axi drive mkdir "Q2 Reports" --account you@example.com
 `;
 export async function driveCommand(args) {
     if (args.length === 0 || (args.length === 1 && args[0] === "--help")) {

package/dist/src/commands/drive.js.map

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

package/dist/src/util/mime-types.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_MIME_TYPE = "application/octet-stream";
+/**
+ * Detect a MIME type from a file path's extension. Case-insensitive; returns
+ * `application/octet-stream` for unknown or absent extensions.
+ */
+export declare function detectMimeType(path: string): string;
+export declare function googleConversionTarget(sourceMime: string): string | null;

package/dist/src/util/mime-types.js

@@ -0,0 +1,95 @@
+import { extname } from "node:path";
+/**
+ * Minimal extension → MIME table for `drive upload`. Node has no built-in
+ * MIME lookup, and pulling in a full database is overkill: this covers the
+ * office/document/text/image/archive types an agent actually uploads. Unknown
+ * extensions fall back to `application/octet-stream` (a safe generic binary
+ * type Drive accepts), so detection never throws — it only ever under-labels.
+ */
+const EXTENSION_MIME = {
+    // Office (OOXML)
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    // Office (legacy)
+    doc: "application/msword",
+    xls: "application/vnd.ms-excel",
+    ppt: "application/vnd.ms-powerpoint",
+    // Text & delimited
+    txt: "text/plain",
+    md: "text/markdown",
+    markdown: "text/markdown",
+    csv: "text/csv",
+    tsv: "text/tab-separated-values",
+    rtf: "application/rtf",
+    html: "text/html",
+    htm: "text/html",
+    json: "application/json",
+    xml: "application/xml",
+    yaml: "application/yaml",
+    yml: "application/yaml",
+    // Documents
+    pdf: "application/pdf",
+    // Images
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    bmp: "image/bmp",
+    tif: "image/tiff",
+    tiff: "image/tiff",
+    heic: "image/heic",
+    // Audio / video
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    // Archives
+    zip: "application/zip",
+    gz: "application/gzip",
+    tar: "application/x-tar",
+};
+export const DEFAULT_MIME_TYPE = "application/octet-stream";
+/**
+ * Detect a MIME type from a file path's extension. Case-insensitive; returns
+ * `application/octet-stream` for unknown or absent extensions.
+ */
+export function detectMimeType(path) {
+    const ext = extname(path).replace(/^\./, "").toLowerCase();
+    if (!ext)
+        return DEFAULT_MIME_TYPE;
+    return EXTENSION_MIME[ext] ?? DEFAULT_MIME_TYPE;
+}
+const GOOGLE_DOC = "application/vnd.google-apps.document";
+const GOOGLE_SHEET = "application/vnd.google-apps.spreadsheet";
+const GOOGLE_SLIDES = "application/vnd.google-apps.presentation";
+/**
+ * Map a source MIME type to the native Google Workspace target Drive can
+ * convert it into on upload (the `--convert` flag). Returns `null` when the
+ * source has no sensible native target — the caller surfaces
+ * `UNSUPPORTED_CONVERSION`.
+ */
+const CONVERSION_TARGETS = {
+    // → Google Doc
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": GOOGLE_DOC,
+    "application/msword": GOOGLE_DOC,
+    "application/rtf": GOOGLE_DOC,
+    "text/rtf": GOOGLE_DOC,
+    "text/plain": GOOGLE_DOC,
+    "text/markdown": GOOGLE_DOC,
+    "text/html": GOOGLE_DOC,
+    // → Google Sheet
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": GOOGLE_SHEET,
+    "application/vnd.ms-excel": GOOGLE_SHEET,
+    "text/csv": GOOGLE_SHEET,
+    "text/tab-separated-values": GOOGLE_SHEET,
+    // → Google Slides
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation": GOOGLE_SLIDES,
+    "application/vnd.ms-powerpoint": GOOGLE_SLIDES,
+};
+export function googleConversionTarget(sourceMime) {
+    return CONVERSION_TARGETS[sourceMime.toLowerCase()] ?? null;
+}
+//# sourceMappingURL=mime-types.js.map

package/dist/src/util/mime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.js","sourceRoot":"","sources":["../../../src/util/mime-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,cAAc,GAA2B;IAC7C,iBAAiB;IACjB,IAAI,EAAE,yEAAyE;IAC/E,IAAI,EAAE,mEAAmE;IACzE,IAAI,EAAE,2EAA2E;IACjF,kBAAkB;IAClB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,+BAA+B;IACpC,mBAAmB;IACnB,GAAG,EAAE,YAAY;IACjB,EAAE,EAAE,eAAe;IACnB,QAAQ,EAAE,eAAe;IACzB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,2BAA2B;IAChC,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,kBAAkB;IACvB,YAAY;IACZ,GAAG,EAAE,iBAAiB;IACtB,SAAS;IACT,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,gBAAgB;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,iBAAiB;IACtB,WAAW;IACX,GAAG,EAAE,iBAAiB;IACtB,EAAE,EAAE,kBAAkB;IACtB,GAAG,EAAE,mBAAmB;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,iBAAiB,CAAC;IACnC,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,GAAG,sCAAsC,CAAC;AAC1D,MAAM,YAAY,GAAG,yCAAyC,CAAC;AAC/D,MAAM,aAAa,GAAG,0CAA0C,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,kBAAkB,GAA2B;IACjD,eAAe;IACf,yEAAyE,EACvE,UAAU;IACZ,oBAAoB,EAAE,UAAU;IAChC,iBAAiB,EAAE,UAAU;IAC7B,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,eAAe,EAAE,UAAU;IAC3B,WAAW,EAAE,UAAU;IACvB,iBAAiB;IACjB,mEAAmE,EACjE,YAAY;IACd,0BAA0B,EAAE,YAAY;IACxC,UAAU,EAAE,YAAY;IACxB,2BAA2B,EAAE,YAAY;IACzC,kBAAkB;IAClB,2EAA2E,EACzE,aAAa;IACf,+BAA+B,EAAE,aAAa;CAC/C,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,kBAAkB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC"}

package/dist/src/util/mime-types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/util/mime-types.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { DEFAULT_MIME_TYPE, detectMimeType, googleConversionTarget, } from "./mime-types.js";
+describe("detectMimeType", () => {
+    it("maps common office and document extensions", () => {
+        expect(detectMimeType("report.docx")).toBe("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
+        expect(detectMimeType("data.xlsx")).toBe("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+        expect(detectMimeType("deck.pptx")).toBe("application/vnd.openxmlformats-officedocument.presentationml.presentation");
+        expect(detectMimeType("notes.pdf")).toBe("application/pdf");
+        expect(detectMimeType("rows.csv")).toBe("text/csv");
+    });
+    it("is case-insensitive on the extension", () => {
+        expect(detectMimeType("PHOTO.JPG")).toBe("image/jpeg");
+        expect(detectMimeType("Report.DOCX")).toBe("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
+    });
+    it("resolves full and relative paths by their extension", () => {
+        expect(detectMimeType("/home/me/pics/cat.png")).toBe("image/png");
+        expect(detectMimeType("./sub/dir/file.md")).toBe("text/markdown");
+    });
+    it("falls back to octet-stream for unknown or absent extensions", () => {
+        expect(detectMimeType("mystery.xyz")).toBe(DEFAULT_MIME_TYPE);
+        expect(detectMimeType("Makefile")).toBe(DEFAULT_MIME_TYPE);
+        expect(detectMimeType("archive.")).toBe(DEFAULT_MIME_TYPE);
+    });
+});
+describe("googleConversionTarget", () => {
+    it("maps word-processing and text sources to Google Doc", () => {
+        expect(googleConversionTarget("application/vnd.openxmlformats-officedocument.wordprocessingml.document")).toBe("application/vnd.google-apps.document");
+        expect(googleConversionTarget("text/plain")).toBe("application/vnd.google-apps.document");
+        expect(googleConversionTarget("text/markdown")).toBe("application/vnd.google-apps.document");
+    });
+    it("maps spreadsheet and delimited sources to Google Sheet", () => {
+        expect(googleConversionTarget("text/csv")).toBe("application/vnd.google-apps.spreadsheet");
+        expect(googleConversionTarget("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")).toBe("application/vnd.google-apps.spreadsheet");
+    });
+    it("maps presentation sources to Google Slides", () => {
+        expect(googleConversionTarget("application/vnd.ms-powerpoint")).toBe("application/vnd.google-apps.presentation");
+    });
+    it("is case-insensitive on the source mime", () => {
+        expect(googleConversionTarget("TEXT/CSV")).toBe("application/vnd.google-apps.spreadsheet");
+    });
+    it("returns null for unsupported source types", () => {
+        expect(googleConversionTarget("application/pdf")).toBeNull();
+        expect(googleConversionTarget("image/png")).toBeNull();
+        expect(googleConversionTarget("application/zip")).toBeNull();
+    });
+});
+//# sourceMappingURL=mime-types.test.js.map

package/dist/src/util/mime-types.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gws-axi",
-  "version": "0.10.2",
+  "version": "0.12.0",
   "description": "AXI-compliant Google Workspace CLI — token-efficient TOON output, agent-guided auth setup, unified interface for Gmail, Calendar, Docs, Drive, Slides",
   "type": "module",
   "repository": {