@whatcha/cli 0.0.0-stage → 0.3.0

package/dist/http-client.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchWhatchaClient = void 0;
+const errors_1 = require("./errors");
+function isErrorEnvelope(json) {
+    return typeof json === "object" && json !== null && "error" in json;
+}
+/**
+ * Real implementation, over Node 22's built-in fetch. `authHeader` is asked
+ * fresh on every call rather than captured once, so a token refreshed
+ * mid-command (see auth/session.ts) is picked up without rebuilding the
+ * client.
+ */
+class FetchWhatchaClient {
+    baseUrl;
+    authHeader;
+    constructor(baseUrl, authHeader) {
+        this.baseUrl = baseUrl;
+        this.authHeader = authHeader;
+    }
+    get(path, query) {
+        return this.send("GET", path + this.queryString(query), undefined);
+    }
+    post(path, body) {
+        return this.send("POST", path, body);
+    }
+    put(path, body) {
+        return this.send("PUT", path, body);
+    }
+    patch(path, body) {
+        return this.send("PATCH", path, body);
+    }
+    delete(path) {
+        return this.send("DELETE", path, undefined);
+    }
+    async getPage(path, query) {
+        const qs = this.queryString(query);
+        const env = await this.sendRaw("GET", path + qs, undefined);
+        return { items: env.data, nextCursor: env.pagination.nextCursor, hasNext: env.pagination.hasNext };
+    }
+    async putBytes(url, headers, bytes) {
+        let res;
+        try {
+            res = await fetch(url, { method: "PUT", headers, body: bytes });
+        }
+        catch (err) {
+            throw new errors_1.ApiError(0, "NETWORK_ERROR", `Could not upload to ${new URL(url).host}: ${err.message}`);
+        }
+        if (!res.ok) {
+            await res.text().catch(() => undefined);
+            throw new errors_1.ApiError(res.status, "UPLOAD_FAILED", `Uploading the file failed with status ${res.status}.`);
+        }
+    }
+    queryString(query) {
+        if (!query)
+            return "";
+        const entries = Object.entries(query).filter((e) => e[1] !== undefined);
+        if (entries.length === 0)
+            return "";
+        return "?" + entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
+    }
+    async send(method, path, body) {
+        const env = await this.sendRaw(method, path, body);
+        return env === undefined ? undefined : env.data;
+    }
+    /** Parses the response and returns the whole JSON body, unwrapped from neither `data` nor `pagination` -- callers decide the shape. */
+    async sendRaw(method, path, body) {
+        const headers = { Accept: "application/json" };
+        if (body !== undefined)
+            headers["Content-Type"] = "application/json";
+        const auth = await this.authHeader();
+        if (auth)
+            headers.Authorization = auth;
+        let res;
+        try {
+            res = await fetch(this.baseUrl + path, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            // DNS failure, connection refused, TLS error -- never seen a status
+            // code at all. Wrapped so commands can print one clear line instead
+            // of a raw TypeError("fetch failed").
+            throw new errors_1.ApiError(0, "NETWORK_ERROR", `Could not reach ${this.baseUrl}: ${err.message}`);
+        }
+        if (res.status === 204)
+            return undefined;
+        const text = await res.text();
+        const json = text ? JSON.parse(text) : undefined;
+        if (!res.ok) {
+            if (isErrorEnvelope(json)) {
+                throw new errors_1.ApiError(res.status, json.error.code, json.error.message, json.error.details);
+            }
+            throw new errors_1.ApiError(res.status, "HTTP_ERROR", `${method} ${path} failed with status ${res.status}`);
+        }
+        return json;
+    }
+}
+exports.FetchWhatchaClient = FetchWhatchaClient;
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+(0, cli_1.run)(process.argv.slice(2))
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((err) => {
+    // run() catches everything it knows how to report -- reaching here
+    // means something threw before or outside that try/catch (a bug), so
+    // this is the last resort, not the normal error path.
+    process.stderr.write(`whatcha: unexpected error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,+BAA4B;AAE5B,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,mEAAmE;IACnE,qEAAqE;IACrE,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/lib/append-entry.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TAGS = exports.MAX_TAG_LENGTH = exports.MAX_TITLE_LENGTH = void 0;
+exports.normalizeTags = normalizeTags;
+exports.mergeHeader = mergeHeader;
+exports.writeEntry = writeEntry;
+const errors_1 = require("../errors");
+/** The API's own limits (entries-content.ts `contentSchema`). */
+exports.MAX_TITLE_LENGTH = 200;
+exports.MAX_TAG_LENGTH = 64;
+exports.MAX_TAGS = 32;
+function existingEntryIdFrom(err) {
+    if (err.status !== 409 || err.code !== "VERSION_CONFLICT")
+        return null;
+    const details = err.details;
+    return typeof details?.existingEntryId === "string" ? details.existingEntryId : null;
+}
+function headerOf(entry) {
+    return {
+        title: entry.title,
+        mood: entry.mood,
+        location: entry.location,
+        // Only sent back when the API sent them: an older server that does not
+        // know the fields must not be handed keys it would drop or refuse.
+        ...(entry.locationLat !== undefined ? { locationLat: entry.locationLat } : {}),
+        ...(entry.locationLng !== undefined ? { locationLng: entry.locationLng } : {}),
+        tags: entry.tags,
+        coverMediaAssetId: entry.coverMediaAssetId,
+    };
+}
+/** Tags trimmed, empties dropped, exact duplicates removed -- the app's own rule (entry editor's _addTag). */
+function normalizeTags(tags) {
+    const out = [];
+    for (const raw of tags) {
+        const tag = raw.trim();
+        if (tag && !out.includes(tag))
+            out.push(tag);
+    }
+    return out;
+}
+/**
+ * The header an append saves: the entry's own, with `meta` merged in under
+ * the append rule. Exported for the tests.
+ */
+function mergeHeader(header, meta) {
+    const wanted = meta.title?.trim();
+    const hasTitle = Boolean(header.title && header.title.trim());
+    const title = hasTitle ? header.title : wanted ? wanted : header.title;
+    const tags = normalizeTags([...(header.tags ?? []), ...(meta.tags ?? [])]);
+    // Kept as the entry had them when nothing new was asked for -- a merge
+    // that only re-normalised somebody else's tags would still be a change.
+    const finalTags = meta.tags && meta.tags.length > 0 ? tags : header.tags;
+    if (finalTags.length > exports.MAX_TAGS) {
+        throw new errors_1.CliUsageError(`This entry would end up with ${finalTags.length} tags; the limit is ${exports.MAX_TAGS}. Nothing was written.`);
+    }
+    return {
+        header: { ...header, title, tags: finalTags },
+        titleKept: Boolean(wanted && hasTitle && header.title.trim() !== wanted),
+    };
+}
+/**
+ * What the stored body should read as after appending `text`, mirroring the
+ * API's own `appendedBody` (apps/api/src/modules/diaries/entries/
+ * entries-content.ts, merged to master in #1424): existing text, trimmed,
+ * then a blank line, then the new text -- or just the new text if there was
+ * none yet.
+ */
+function expectedAppendedBody(existingBody, text) {
+    const trimmed = existingBody.trimEnd();
+    return trimmed ? `${trimmed}\n\n${text}` : text;
+}
+/**
+ * The one thing this whole command exists to get right: add `text` to
+ * `diaryId`'s entry for `occurredAt`'s day without ever touching what
+ * somebody else already wrote there.
+ *
+ * Three paths, in order:
+ *
+ * 1. No entry exists yet for that day -- `POST /entries` creates it with
+ *    exactly `text` as its body. Nothing to append to, nothing at risk.
+ * 2. An entry exists (`POST` answers 409 with `details.existingEntryId`).
+ *    Read it (`GET /entries/{id}`) to get its current header fields --
+ *    title/mood/location/tags/cover are full-replace-on-save same as the
+ *    body (entries-content.ts's `contentToItems`), so sending `content`
+ *    without them would silently wipe whatever the other person set, even
+ *    though `appendBody` protects the body itself. Then `PATCH` with
+ *    `appendBody: true` and only the *new* text as `content.body` -- the
+ *    server appends it to whatever is currently stored, in the same
+ *    transaction that checks `expectedHeadCommitId`, so this is safe even
+ *    against a write that lands between our GET and our PATCH.
+ * 3. The PATCH in (2) answers 422 VALIDATION_ERROR citing `appendBody` as
+ *    an unrecognized key (ApiError#isUnrecognizedAppendBodyFlag) -- the
+ *    server does not have the #1422 fix. Build the appended body ourselves
+ *    from the text we just read in (2) and PATCH again without the flag,
+ *    still carrying `expectedHeadCommitId` so a concurrent write is caught
+ *    as a conflict rather than silently overwritten. This is the read
+ *    that "fall back to read-then-append" refers to; note it is the *same*
+ *    read as (2), not a second one -- appendBody is tried first precisely
+ *    so the common case does not pay for a read it does not need.
+ *
+ * Either way, nothing is ever PATCHed as a plain replacement of a body this
+ * function did not just read.
+ */
+async function writeEntry(client, diaryId, occurredAt, text, meta = {}) {
+    const title = meta.title?.trim() || undefined;
+    const tags = normalizeTags(meta.tags ?? []);
+    try {
+        const created = await client.post("/entries", {
+            diaryId,
+            occurredAt: occurredAt.toISOString(),
+            content: { body: text, ...(title ? { title } : {}), ...(tags.length > 0 ? { tags } : {}) },
+        });
+        return {
+            entryId: created.id,
+            headCommitId: created.headCommitId,
+            mode: "created",
+            verified: null,
+            title: title ?? null,
+            tags,
+            titleKept: false,
+        };
+    }
+    catch (err) {
+        if (!(err instanceof errors_1.ApiError))
+            throw err;
+        const existingEntryId = existingEntryIdFrom(err);
+        if (!existingEntryId)
+            throw err;
+        return appendToExisting(client, existingEntryId, text, { title, tags });
+    }
+}
+async function appendToExisting(client, entryId, text, meta) {
+    const existing = await client.get(`/entries/${entryId}`);
+    const { header, titleKept } = mergeHeader(headerOf(existing), meta);
+    const after = { title: header.title, tags: header.tags, titleKept };
+    try {
+        const saved = await client.patch(`/entries/${entryId}`, {
+            content: { body: text, ...header },
+            appendBody: true,
+            expectedHeadCommitId: existing.headCommitId,
+        });
+        const verified = await verifyAppend(client, entryId, existing.body, text);
+        return { entryId, headCommitId: saved.headCommitId, mode: "appended", verified, ...after };
+    }
+    catch (err) {
+        if (!(err instanceof errors_1.ApiError))
+            throw err;
+        if (err.status === 409)
+            throw concurrentWriteError(err);
+        if (!err.isUnrecognizedAppendBodyFlag())
+            throw err;
+        // Fallback: this server does not know appendBody. Merge client-side
+        // from the body we already read, and send the merged body as a plain
+        // replacement -- which is safe precisely because we just read what it
+        // is replacing.
+        const mergedBody = expectedAppendedBody(existing.body, text);
+        const saved = await client
+            .patch(`/entries/${entryId}`, {
+            content: { body: mergedBody, ...header },
+            expectedHeadCommitId: existing.headCommitId,
+        })
+            .catch((fallbackErr) => {
+            if (fallbackErr instanceof errors_1.ApiError && fallbackErr.status === 409)
+                throw concurrentWriteError(fallbackErr);
+            throw fallbackErr;
+        });
+        const verified = await verifyAppend(client, entryId, existing.body, text);
+        return { entryId, headCommitId: saved.headCommitId, mode: "appended-fallback", verified, ...after };
+    }
+}
+function concurrentWriteError(err) {
+    return new errors_1.CliUsageError("Someone else saved to this entry while whatcha was writing to it. Nothing was overwritten -- " +
+        `run \`whatcha write\` again to retry. (${err.message})`);
+}
+/**
+ * Defense in depth against the exact failure #1422 was about, for the one
+ * case none of the above can rule out: a server old enough that it neither
+ * knows `appendBody` NOR rejects the unrecognized key (STRICT_REQUEST_BODIES
+ * off, which is the API's own default -- apps/api/src/config/index.ts). Such
+ * a server answers 200 having silently replaced the body instead of
+ * appending, and there is no error to catch.
+ *
+ * So: read the entry back and check the stored body actually starts with
+ * what was there before. This cannot repair a loss it finds -- the PATCH
+ * already committed -- but it turns a silent data loss into a loud one, and
+ * `whatcha write --json` surfaces `verified: false` so an agent calling
+ * this does not mistake a corrupted write for a clean one.
+ */
+async function verifyAppend(client, entryId, bodyBeforeWrite, text) {
+    const after = await client.get(`/entries/${entryId}`);
+    return after.body === expectedAppendedBody(bodyBeforeWrite, text);
+}
+//# sourceMappingURL=append-entry.js.map

package/dist/lib/append-entry.js.map

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

package/dist/lib/diary-resolve.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDiary = resolveDiary;
+exports.listAllDiaries = listAllDiaries;
+const errors_1 = require("../errors");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * `<diary>` on the command line -- a diary id, or a name to look up against
+ * `GET /diaries` (list, not search: the API also offers `?q=` substring
+ * search, but that is for the app's search box, not for turning a name a
+ * person typed back into exactly the diary they meant, so this matches by
+ * exact name, case-insensitively, and refuses to guess when more than one
+ * diary shares a name).
+ */
+async function resolveDiary(client, nameOrId) {
+    if (UUID_RE.test(nameOrId)) {
+        try {
+            return await client.get(`/diaries/${nameOrId}`);
+        }
+        catch (err) {
+            if (err instanceof errors_1.ApiError && err.status === 404) {
+                throw new errors_1.CliUsageError(`No diary with id ${nameOrId} (or it is not visible to you).`);
+            }
+            throw err;
+        }
+    }
+    const all = await listAllDiaries(client);
+    const matches = all.filter((d) => d.name.toLowerCase() === nameOrId.toLowerCase());
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        const ids = matches.map((d) => `  ${d.id}  ${d.name} (${d.groupName})`).join("\n");
+        throw new errors_1.CliUsageError(`"${nameOrId}" matches more than one diary -- use the id instead:\n${ids}`);
+    }
+    const known = all.map((d) => d.name).join(", ") || "(none)";
+    throw new errors_1.CliUsageError(`No diary named "${nameOrId}". Diaries you can see: ${known}`);
+}
+async function listAllDiaries(client) {
+    const all = [];
+    let cursor;
+    for (;;) {
+        const page = await client.getPage("/diaries", { limit: "50", cursor });
+        all.push(...page.items);
+        if (!page.hasNext || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    return all;
+}
+//# sourceMappingURL=diary-resolve.js.map

package/dist/lib/diary-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-resolve.js","sourceRoot":"","sources":["../../src/lib/diary-resolve.ts"],"names":[],"mappings":";;AAcA,oCAqBC;AAED,wCAUC;AA/CD,sCAAoD;AAIpD,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF;;;;;;;GAOG;AACI,KAAK,UAAU,YAAY,CAAC,MAAqB,EAAE,QAAgB;IACxE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAQ,YAAY,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,iBAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClD,MAAM,IAAI,sBAAa,CAAC,oBAAoB,QAAQ,iCAAiC,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnF,MAAM,IAAI,sBAAa,CAAC,IAAI,QAAQ,yDAAyD,GAAG,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAC5D,MAAM,IAAI,sBAAa,CAAC,mBAAmB,QAAQ,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,MAAqB;IACxD,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,IAAI,MAA0B,CAAC;IAC/B,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAQ,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM;QAC7C,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/entry-date.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidDate = assertValidDate;
+exports.assertValidTime = assertValidTime;
+exports.dateKeyInTimeZone = dateKeyInTimeZone;
+exports.timeKeyInTimeZone = timeKeyInTimeZone;
+exports.zonedTimeToUtc = zonedTimeToUtc;
+exports.resolveOccurredAt = resolveOccurredAt;
+const errors_1 = require("../errors");
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const TIME_RE = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function assertValidDate(date) {
+    if (!DATE_RE.test(date))
+        throw new errors_1.CliUsageError(`--date must be YYYY-MM-DD, got "${date}".`);
+    // DATE_RE only checks the shape; Date.UTC quietly rolls "2026-02-30" into
+    // March, so check the round-trip too rather than writing to the wrong day.
+    const [y, m, d] = date.split("-").map(Number);
+    const roundTrip = new Date(Date.UTC(y, m - 1, d));
+    if (roundTrip.getUTCFullYear() !== y || roundTrip.getUTCMonth() !== m - 1 || roundTrip.getUTCDate() !== d) {
+        throw new errors_1.CliUsageError(`--date "${date}" is not a real calendar date.`);
+    }
+}
+function assertValidTime(time) {
+    if (!TIME_RE.test(time))
+        throw new errors_1.CliUsageError(`--time must be HH:MM (24h), got "${time}".`);
+}
+/** "YYYY-MM-DD" for `date`, as read in `timeZone` -- what day the diary's own §11.4 uniqueness check would see. */
+function dateKeyInTimeZone(date, timeZone) {
+    // en-CA formats as YYYY-MM-DD, which is also the wire format --
+    // avoids hand-assembling the string from getters that don't accept a tz.
+    return new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(date);
+}
+/** "HH:MM" for `date`, as read in `timeZone`. Used to default --time to "now" without a second copy of the format string. */
+function timeKeyInTimeZone(date, timeZone) {
+    return new Intl.DateTimeFormat("en-GB", {
+        timeZone,
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    }).format(date);
+}
+/**
+ * The inverse of the two functions above: the UTC instant that reads as
+ * `dateStr` `timeStr` when displayed in `timeZone`.
+ *
+ * There is no built-in for this (Intl only goes UTC -> zoned, never back),
+ * so this uses the standard trick: read `dateStr timeStr` as if it were
+ * already UTC, ask what that UTC instant looks like in `timeZone`, and shift
+ * by the difference. Good to the minute, which is all `--time` offers;
+ * degrades right at a DST transition (an hour that either repeats or does
+ * not exist), which is an acceptable rough edge for a diary entry's
+ * timestamp and not worth a timezone-database dependency for.
+ */
+function zonedTimeToUtc(dateStr, timeStr, timeZone) {
+    const asIfUtc = new Date(`${dateStr}T${timeStr}:00.000Z`);
+    const diff = asIfUtc.getTime() - wallClockAsUtcMs(asIfUtc, timeZone);
+    return new Date(asIfUtc.getTime() + diff);
+}
+/**
+ * The wall-clock reading of `instant` in `timeZone`, re-read as if it were
+ * UTC. Assembled from formatToParts and Date.UTC rather than by parsing a
+ * toLocaleString() back through `new Date()` -- that parse happens in the
+ * MACHINE's timezone, which shifted every --date/--time by the machine's
+ * own UTC offset on anything not set to UTC.
+ */
+function wallClockAsUtcMs(instant, timeZone) {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hourCycle: "h23",
+    }).formatToParts(instant);
+    const get = (type) => Number(parts.find((p) => p.type === type)?.value);
+    return Date.UTC(get("year"), get("month") - 1, get("day"), get("hour"), get("minute"), get("second"));
+}
+/**
+ * Resolves `--date`/`--time` into the `occurredAt` instant to send the API,
+ * defaulting both to "now" in the diary's own timezone -- not the machine's,
+ * since §11.4's one-entry-per-day check is computed in the diary's timezone
+ * (entries-create-service.ts) and a mismatch is exactly the kind of thing
+ * that would land a `--date 2026-09-25` entry on the 24th or 26th instead.
+ */
+function resolveOccurredAt(opts, timeZone, now = new Date()) {
+    if (opts.date)
+        assertValidDate(opts.date);
+    if (opts.time)
+        assertValidTime(opts.time);
+    const date = opts.date ?? dateKeyInTimeZone(now, timeZone);
+    const time = opts.time ?? timeKeyInTimeZone(now, timeZone);
+    return zonedTimeToUtc(date, time, timeZone);
+}
+//# sourceMappingURL=entry-date.js.map

package/dist/lib/entry-date.js.map

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

package/dist/lib/entry-find.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findEntryOnDate = findEntryOnDate;
+const entry_date_1 = require("./entry-date");
+const PAGE_LIMIT = 50;
+/** Ten pages is 500 entries -- generous for "find the one entry on this diary-day" without paging forever through years of history for a typo'd date. */
+const MAX_PAGES = 10;
+/**
+ * `GET /entries` has no `?date=`, only cursor pagination newest-first
+ * (entries-query-service.ts's `listEntriesPage`, `orderBy: occurred_at
+ * desc`). Since there is at most one entry per diary-day (§11.4), walking
+ * that list until an entry's day (in the diary's own timezone) matches or
+ * we pass it is exact, not a heuristic -- it just is not O(1). Returns null
+ * if the diary has no entry on that day, or if it is farther back than
+ * MAX_PAGES cover.
+ */
+async function findEntryOnDate(client, diaryId, timeZone, dateKey) {
+    let cursor;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        const result = await client.getPage("/entries", {
+            diaryId,
+            limit: String(PAGE_LIMIT),
+            cursor,
+        });
+        for (const entry of result.items) {
+            const entryDateKey = (0, entry_date_1.dateKeyInTimeZone)(new Date(entry.occurredAt), timeZone);
+            if (entryDateKey === dateKey)
+                return entry;
+            // Newest-first: once we're past the target day, it is not coming back.
+            if (entryDateKey < dateKey)
+                return null;
+        }
+        if (!result.hasNext || !result.nextCursor)
+            return null;
+        cursor = result.nextCursor;
+    }
+    return null;
+}
+//# sourceMappingURL=entry-find.js.map

package/dist/lib/entry-find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-find.js","sourceRoot":"","sources":["../../src/lib/entry-find.ts"],"names":[],"mappings":";;AAiBA,0CAuBC;AAtCD,6CAAiD;AAEjD,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,yJAAyJ;AACzJ,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;;;;;;;GAQG;AACI,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,OAAe,EACf,QAAgB,EAChB,OAAe;IAEf,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAgB,UAAU,EAAE;YAC7D,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;YACzB,MAAM;SACP,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,IAAA,8BAAiB,EAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC7E,IAAI,YAAY,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC3C,uEAAuE;YACvE,IAAI,YAAY,GAAG,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}