@wirecat/bitrix24-cli 0.3.0 → 0.5.0

package/dist/crm/source.js

@@ -0,0 +1,122 @@
+import { CliError, isCliError } from "@wirecat/cli-base";
+import { DEAL } from "./deal.js";
+import { loadFields, metadataOf } from "./fields.js";
+import { LEAD } from "./lead.js";
+import { ORGANIZATION } from "./organization.js";
+import { PERSON } from "./person.js";
+import { bitrixPipelines } from "./pipelines.js";
+import { contacts, customFields, fullName, id, portalTime, text } from "./values.js";
+/**
+ * Re-read before the last cursor: rows the portal saved while the round ran, and this computer's clock running ahead
+ * of the portal's. A row read twice is only saved twice.
+ */
+const OVERLAP_MS = 10 * 60_000;
+const PAGE = 500;
+const TYPES = {
+    deal: DEAL,
+    lead: LEAD,
+    person: PERSON,
+    organization: ORGANIZATION,
+};
+const toPerson = (raw) => ({
+    externalId: id(raw.id) ?? "",
+    name: fullName(raw.name, raw.secondName, raw.lastName),
+    email: contacts(raw.email)[0]?.value ?? null,
+    phone: contacts(raw.phone)[0]?.value ?? null,
+});
+const toOrganization = (raw, metadata) => ({
+    externalId: id(raw.id) ?? "",
+    name: text(raw.title) ?? "",
+    url: text(raw.url),
+    ...(metadata ? { metadata } : {}),
+});
+const rowsOf = (result) => {
+    const items = result?.items;
+    return Array.isArray(items) ? items : [];
+};
+/** `<last id>@<when the round started>`: keyset paging by id, so a row changed mid-round never shifts the rest. */
+const pageOf = (page, now) => {
+    const [after, started] = (page ?? "").split("@");
+    return { after: Number(after) || 0, started: Number(started) || now };
+};
+/**
+ * The portal's CRM for core's sync: REST 3.0 lists by id with `updatedTime` for changes, since a webhook gets no
+ * event feed, and a list of every id to find deletions.
+ */
+export const bitrixCrmSource = (portal, now = Date.now) => {
+    const loaded = new Map();
+    const fields = (kind) => {
+        let found = loaded.get(kind);
+        if (!found) {
+            // A webhook without the rights to read field definitions still syncs its records, with no definitions. Any
+            // other failure fails the sync rather than mark every stored definition deleted over a passing fault.
+            found = loadFields(portal(), TYPES[kind].type).catch((error) => {
+                if (isCliError(error) && error.code === "permission_error")
+                    return [];
+                throw error;
+            });
+            loaded.set(kind, found);
+        }
+        return found;
+    };
+    // core's CrmPerson has no metadata, so a contact's values are not read; its definitions still are, for `fields list`.
+    const custom = async (kind) => (kind === "person" ? [] : await fields(kind));
+    const mapped = (kind, raw, defined) => {
+        const values = customFields(raw);
+        const metadata = Object.keys(values).length ? metadataOf(values, defined) : undefined;
+        if (kind === "person")
+            return toPerson(raw);
+        if (kind === "organization")
+            return toOrganization(raw, metadata);
+        return TYPES[kind].map(raw, metadata);
+    };
+    const list = (kind, select, filter) => portal().call(`crm.${TYPES[kind].type}.list`, {
+        select,
+        filter,
+        order: { id: "ASC" },
+        pagination: { limit: PAGE, offset: 0 },
+    });
+    return {
+        provider: "bitrix24",
+        traits: { kinds: ["organization", "person", "deal", "lead"], removedInChanges: false },
+        pipelines: (kind) => bitrixPipelines(portal(), kind),
+        async changes(kind, cursor, page) {
+            const since = cursor === null ? null : Date.parse(cursor);
+            if (since !== null && Number.isNaN(since))
+                return { reset: true };
+            const { after, started } = pageOf(page, now());
+            const defined = await custom(kind);
+            const filter = [
+                ...(after ? [["id", ">", after]] : []),
+                ...(since === null ? [] : [["updatedTime", ">=", portalTime(since - OVERLAP_MS)]]),
+            ];
+            const rows = rowsOf((await list(kind, [...TYPES[kind].select, ...defined.map(({ code }) => code)], filter)).result);
+            const items = rows.map((raw) => mapped(kind, raw, defined));
+            const last = id(rows.at(-1)?.id);
+            // An empty page ends the round, not a short one: a portal that caps pages below PAGE still lists every row.
+            if (last !== null)
+                return { items, nextPage: `${last}@${started}` };
+            return { items, cursor: new Date(started).toISOString() };
+        },
+        async ids(kind, page) {
+            const after = Number(page) || 0;
+            const rows = rowsOf((await list(kind, ["id"], after ? [["id", ">", after]] : [])).result);
+            const ids = rows.map((raw) => id(raw.id)).filter((one) => one !== null);
+            const last = ids.at(-1);
+            return last === undefined ? { ids } : { ids, nextPage: last };
+        },
+        async item(kind, externalId) {
+            const defined = await custom(kind);
+            const answer = await portal().call(`crm.${TYPES[kind].type}.get`, {
+                id: Number(externalId),
+                select: [...TYPES[kind].select, ...defined.map(({ code }) => code)],
+            });
+            const raw = answer.result?.item;
+            if (!raw)
+                throw new CliError("not_found", `the portal has no ${kind} ${externalId}`);
+            return mapped(kind, raw, defined);
+        },
+        fields,
+    };
+};
+//# sourceMappingURL=source.js.map

package/dist/crm/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/crm/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAIxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAiB,UAAU,EAAY,IAAI,EAAE,MAAM,aAAa,CAAA;AAE7G;;;GAGG;AACH,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,CAAA;AAC9B,MAAM,IAAI,GAAG,GAAG,CAAA;AAEhB,MAAM,KAAK,GAAuC;IAChD,IAAI,EAAE,IAAyB;IAC/B,IAAI,EAAE,IAAyB;IAC/B,MAAM,EAAE,MAA2B;IACnC,YAAY,EAAE,YAAiC;CAChD,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,GAAQ,EAAa,EAAE,CAAC,CAAC;IACzC,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;IAC5B,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC;IACtD,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;IAC5C,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;CAC7C,CAAC,CAAA;AAEF,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAE,QAAmB,EAAmB,EAAE,CAAC,CAAC;IAC1E,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;IAC5B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;IAC3B,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAClC,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,CAAC,MAAe,EAAS,EAAE;IACxC,MAAM,KAAK,GAAI,MAA8B,EAAE,KAAK,CAAA;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAC,EAAE,CAAA;AACrD,CAAC,CAAA;AAED,mHAAmH;AACnH,MAAM,MAAM,GAAG,CAAC,IAAwB,EAAE,GAAW,EAAE,EAAE;IACvD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CAAA;AACvE,CAAC,CAAA;AASD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAA6B,EAAE,GAAG,GAAiB,IAAI,CAAC,GAAG,EAAmB,EAAE;IAC9G,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAA;IACtD,MAAM,MAAM,GAAG,CAAC,IAAa,EAAE,EAAE;QAC/B,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,2GAA2G;YAC3G,sGAAsG;YACtG,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtE,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB;oBAAE,OAAO,EAAE,CAAA;gBACrE,MAAM,KAAK,CAAA;YACb,CAAC,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,sHAAsH;IACtH,MAAM,MAAM,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACrF,MAAM,MAAM,GAAG,CAAC,IAAa,EAAE,GAAQ,EAAE,OAA4B,EAAW,EAAE;QAChF,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACrF,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC3C,IAAI,IAAI,KAAK,cAAc;YAAE,OAAO,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QACjE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACvC,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,MAAyB,EAAE,MAAiB,EAAE,EAAE,CAC3E,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,EAAE;QAC5C,MAAM;QACN,MAAM;QACN,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;QACpB,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;KACvC,CAAC,CAAA;IAEJ,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE;QACtF,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC;QACpD,KAAK,CAAC,OAAO,CAAoB,IAAO,EAAE,MAAqB,EAAE,IAAa;YAC5E,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACzD,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAA+B,CAAA;YAC9F,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;YAClC,MAAM,MAAM,GAAG;gBACb,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;aACnF,CAAA;YACD,MAAM,IAAI,GAAG,MAAM,CACjB,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAC/F,CAAA;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAoB,CAAA;YAC9E,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAChC,4GAA4G;YAC5G,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,IAAI,OAAO,EAAE,EAAE,CAAA;YACnE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAA;QAC3D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI;YAClB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YACzF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;YACtF,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YACvB,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC/D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU;YACzB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;YAClC,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,EAAE;gBAChE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC;gBACtB,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;aACpE,CAAC,CAAA;YACF,MAAM,GAAG,GAAI,MAAM,CAAC,MAAyB,EAAE,IAAI,CAAA;YACnD,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,qBAAqB,IAAI,IAAI,UAAU,EAAE,CAAC,CAAA;YACpF,OAAO,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAY,CAAA;QAC9C,CAAC;QACD,MAAM;KACP,CAAA;AACH,CAAC,CAAA"}

package/dist/crm/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/crm/user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAqB,KAAK,GAAG,EAAa,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,WAAW,CAAA;AAE7C,8DAA8D;AAC9D,eAAO,MAAM,UAAU;;;;;;;aAOrB,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA;AAEnD,eAAO,MAAM,WAAW;aACtB,IAAI;iBAAI,KAAK,EAAE,aAAa;iBAAE,IAAI,EAAE,MAAM;;aAC1C,MAAM;iBAAI,KAAK,EAAE,QAAQ;iBAAE,IAAI,EAAE,MAAM;;CAC/B,CAAA;AAEV,eAAO,MAAM,cAAc,QAAS,GAAG,KAAG,IAOxC,CAAA;AAWF,eAAO,MAAM,SAAS,WAAkB,eAAe,cAAc,SAAS,SAAS,EAAE,UAAU,MAAM;;;;;;;;;;EAWxG,CAAA;AAED,eAAO,MAAM,OAAO,WAAkB,eAAe,aAAa,MAAM,KAAG,OAAO,CAAC,IAAI,CAKtF,CAAA"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/crm/user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAgC,KAAK,GAAG,EAAa,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,WAAW,CAAA;AAE7C,8DAA8D;AAC9D,eAAO,MAAM,UAAU;;;;;;;aAOrB,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA;AAEnD,eAAO,MAAM,WAAW;aACtB,IAAI;iBAAI,KAAK,EAAE,aAAa;iBAAE,IAAI,EAAE,MAAM;;aAC1C,MAAM;iBAAI,KAAK,EAAE,QAAQ;iBAAE,IAAI,EAAE,MAAM;;CAC/B,CAAA;AAEV,eAAO,MAAM,cAAc,QAAS,GAAG,KAAG,IAOxC,CAAA;AAWF,eAAO,MAAM,SAAS,WAAkB,eAAe,cAAc,SAAS,SAAS,EAAE,UAAU,MAAM;;;;;;;;;;EAWxG,CAAA;AAED,eAAO,MAAM,OAAO,WAAkB,eAAe,aAAa,MAAM,KAAG,OAAO,CAAC,IAAI,CAKtF,CAAA"}

package/dist/crm/user.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
 import { rest2Filter } from "./conditions.js";
-import { fullName, id, ids, text, yes } from "./values.js";
+import { fullName, id, ids, numericId, text, yes } from "./values.js";
 import { walk } from "./walk.js";
 /** An employee of the portal: who a record is assigned to. */
 export const userSchema = v.strictObject({
@@ -45,7 +45,7 @@ export const listUsers = async (portal, conditions, window) => {
     return { items: items.map(fromBitrixUser), has_more };
 };
 export const getUser = async (portal, reference) => {
-    const answer = await portal.call("user.get", { FILTER: { ID: Number(reference) } });
+    const answer = await portal.call("user.get", { FILTER: { ID: numericId(reference, "users show") } });
     const found = Array.isArray(answer.result) ? answer.result[0] : undefined;
     if (!found)
         throw new CliError("not_found", `there is no user ${reference}`);

package/dist/crm/user.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/crm/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAkB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAY,IAAI,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAe,IAAI,EAAE,MAAM,WAAW,CAAA;AAE7C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5C,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;CACjC,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAQ,EAAE,CAAC,CAAC;IACjD,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;IACpB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC;IACvC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACtB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC;IACjC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;IACvB,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC;CACvC,CAAC,CAAA;AAEF,oHAAoH;AACpH,MAAM,UAAU,GAAG,CAAC,UAAgC,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IACtC,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IAC/E,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,MAAuB,EAAE,UAAgC,EAAE,MAAc,EAAE,EAAE;IAC3G,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACjE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE;YAC3C,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC;YAC9B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK;YACZ,KAAK;SACN,CAAC,CAAA;QACF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,MAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAA;IAChH,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAA;AACvD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAuB,EAAE,SAAiB,EAAiB,EAAE;IACzF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAA;IACnF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,MAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACpF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,oBAAoB,SAAS,EAAE,CAAC,CAAA;IAC5E,OAAO,cAAc,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC,CAAA"}
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/crm/user.ts"],"names":[],"mappings":"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"}

package/dist/crm/values.d.ts

@@ -1,16 +1,26 @@
+import type { StageOutcome } from "@wirecat/cli-core";
 import * as v from "valibot";
 export type Raw = Record<string, unknown>;
-export declare const OUTCOMES: readonly ["open", "won", "lost"];
-export type Outcome = (typeof OUTCOMES)[number];
 /** Bitrix24's stage semantics: `S` success, `F` failure, anything else still in progress (apidocs crm.status.fields). */
-export declare const outcomeOf: (semantics: unknown) => Outcome;
-export declare const semanticsOf: (outcome: string) => string;
+export declare const outcomeOf: (semantics: unknown) => StageOutcome;
 export declare const text: (value: unknown) => string | null;
 export declare const id: (value: unknown) => string | null;
+/** `Number("anna")` is NaN, which goes out as null: Bitrix24 may then read the call as having no id at all. */
+export declare const numericId: (value: string, what: string) => number;
 export declare const ids: (value: unknown) => string[];
 export declare const number: (value: unknown) => number | null;
 /** Bitrix24 answers with the portal's offset; every answer here is UTC (WC-OUT-13). */
 export declare const time: (value: unknown) => string | null;
+/** Epoch milliseconds, as core's CRM copy keeps times. */
+export declare const epoch: (value: unknown) => number | null;
+/**
+ * Money as a decimal string in its currency, both or neither. Bitrix24 gives every deal a currency and `0` for no
+ * amount, so `0` is no amount.
+ */
+export declare const amountOf: (value: unknown, currency: unknown) => {
+    amount: string | null;
+    currency: string | null;
+};
 export declare const yes: (value: unknown) => boolean;
 export declare const fullName: (...parts: unknown[]) => string | null;
 export interface Contact {
@@ -19,6 +29,8 @@ export interface Contact {
 }
 /** REST 3.0 `phone` and `email`: `[{ valueTypeId, value }]`. */
 export declare const contacts: (value: unknown) => Contact[];
+/** A portal's own field, not its read-only `_data` twin. */
+export declare const isCustom: (name: string) => boolean;
 /**
  * The portal's own fields that hold a value, as it names them: their meaning is the portal owner's, so they stay
  * unmapped. `false` and `0` stay, since a yes/no field saying no is an answer.
@@ -29,10 +41,19 @@ export declare const contactSchema: v.StrictObjectSchema<{
     readonly value: v.StringSchema<undefined>;
 }, undefined>;
 export declare const nullableTime: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
-/** A custom field's value with its title on the portal; `label` is null when the portal did not give one. */
+/**
+ * A custom field's value with its title on the portal; `label` is null when the portal did not give one. A list
+ * field's value is its option's label, and `option_id` the option's id (both arrays for a multiple field).
+ */
 export declare const metadataSchema: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StrictObjectSchema<{
     readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly value: v.UnknownSchema;
+    readonly option_id: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>], undefined>, undefined>;
 }, undefined>, undefined>, undefined>;
 export type Metadata = NonNullable<v.InferOutput<typeof metadataSchema>>;
+/**
+ * A filter's time as REST 3.0 takes it, whole seconds with an offset: a live portal refused a filter with
+ * `toISOString()`'s milliseconds and `Z` (REQUESTVALIDATIONEXCEPTION, 2026-11-07).
+ */
+export declare const portalTime: (ms: number) => string;
 //# sourceMappingURL=values.d.ts.map

package/dist/crm/values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/crm/values.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,eAAO,MAAM,QAAQ,YAAI,MAAM,EAAE,KAAK,EAAE,MAAM,CAAU,CAAA;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,yHAAyH;AACzH,eAAO,MAAM,SAAS,cAAe,OAAO,KAAG,OACkB,CAAA;AACjE,eAAO,MAAM,WAAW,YAAa,MAAM,KAAG,MAAoE,CAAA;AAElH,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,MAAM,GAAG,IAI9C,CAAA;AAED,eAAO,MAAM,EAAE,UAAW,OAAO,KAAG,MAAM,GAAG,IAG5C,CAAA;AAED,eAAO,MAAM,GAAG,UAAW,OAAO,KAAG,MAAM,EAC6C,CAAA;AAExF,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IAIhD,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,MAAM,GAAG,IAK9C,CAAA;AAED,eAAO,MAAM,GAAG,UAAW,OAAO,KAAG,OAA0E,CAAA;AAE/G,eAAO,MAAM,QAAQ,aAAc,OAAO,EAAE,KAAG,MAAM,GAAG,IAIlC,CAAA;AAEtB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,gEAAgE;AAChE,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,OAAO,EAMzC,CAAA;AAMR;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,GAAG,GAAG,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAGvE,CAAA;AAEH,eAAO,MAAM,aAAa;;;aAAsE,CAAA;AAChG,eAAO,MAAM,YAAY,uNAAsB,CAAA;AAC/C,6GAA6G;AAC7G,eAAO,MAAM,cAAc;;;qCAE1B,CAAA;AACD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC,CAAA"}
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/crm/values.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,yHAAyH;AACzH,eAAO,MAAM,SAAS,cAAe,OAAO,KAAG,YACkB,CAAA;AAEjE,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,MAAM,GAAG,IAI9C,CAAA;AAED,eAAO,MAAM,EAAE,UAAW,OAAO,KAAG,MAAM,GAAG,IAG5C,CAAA;AAED,+GAA+G;AAC/G,eAAO,MAAM,SAAS,UAAW,MAAM,QAAQ,MAAM,KAAG,MAIvD,CAAA;AAED,eAAO,MAAM,GAAG,UAAW,OAAO,KAAG,MAAM,EAC6C,CAAA;AAExF,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IAIhD,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,MAAM,GAAG,IAK9C,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,KAAK,UAAW,OAAO,KAAG,MAAM,GAAG,IAG/C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAW,OAAO,YAAY,OAAO,KAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAK5G,CAAA;AAED,eAAO,MAAM,GAAG,UAAW,OAAO,KAAG,OAA0E,CAAA;AAE/G,eAAO,MAAM,QAAQ,aAAc,OAAO,EAAE,KAAG,MAAM,GAAG,IAIlC,CAAA;AAEtB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,gEAAgE;AAChE,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,OAAO,EAMzC,CAAA;AAIR,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,SAAU,MAAM,YAAiD,CAAA;AAItF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,GAAG,GAAG,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAC8B,CAAA;AAExG,eAAO,MAAM,aAAa;;;aAAsE,CAAA;AAChG,eAAO,MAAM,YAAY,uNAAsB,CAAA;AAC/C;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;qCAS1B,CAAA;AACD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,UAAU,OAAQ,MAAM,WAC4C,CAAA"}

package/dist/crm/values.js

@@ -1,9 +1,8 @@
+import { CliError } from "@wirecat/cli-base";
 import { isoTime } from "@wirecat/cli-base/standards";
 import * as v from "valibot";
-export const OUTCOMES = ["open", "won", "lost"];
 /** Bitrix24's stage semantics: `S` success, `F` failure, anything else still in progress (apidocs crm.status.fields). */
 export const outcomeOf = (semantics) => semantics === "S" ? "won" : semantics === "F" ? "lost" : "open";
-export const semanticsOf = (outcome) => (outcome === "won" ? "S" : outcome === "lost" ? "F" : "P");
 export const text = (value) => {
     if (typeof value !== "string" && typeof value !== "number")
         return null;
@@ -14,6 +13,12 @@ export const id = (value) => {
     const found = text(value);
     return found === null || found === "0" ? null : found;
 };
+/** `Number("anna")` is NaN, which goes out as null: Bitrix24 may then read the call as having no id at all. */
+export const numericId = (value, what) => {
+    if (!/^(0|[1-9][0-9]*)$/.test(value))
+        throw new CliError("validation_error", `${what} takes a number, such as 7`, { reason: "id.invalid", sent: false });
+    return Number(value);
+};
 export const ids = (value) => Array.isArray(value) ? value.map(id).filter((one) => one !== null) : [];
 export const number = (value) => {
     if (value === null || value === undefined || value === "")
@@ -29,6 +34,22 @@ export const time = (value) => {
     const parsed = new Date(found);
     return Number.isNaN(parsed.getTime()) ? null : parsed.toISOString();
 };
+/** Epoch milliseconds, as core's CRM copy keeps times. */
+export const epoch = (value) => {
+    const found = time(value);
+    return found === null ? null : Date.parse(found);
+};
+/**
+ * Money as a decimal string in its currency, both or neither. Bitrix24 gives every deal a currency and `0` for no
+ * amount, so `0` is no amount.
+ */
+export const amountOf = (value, currency) => {
+    const found = number(value);
+    const code = text(currency)?.toUpperCase() ?? null;
+    if (found === null || found <= 0 || code === null)
+        return { amount: null, currency: null };
+    return { amount: found.toFixed(6).replace(/\.?0+$/, ""), currency: code };
+};
 export const yes = (value) => value === true || value === "Y" || value === "1" || value === 1;
 export const fullName = (...parts) => parts
     .map(text)
@@ -42,14 +63,28 @@ export const contacts = (value) => Array.isArray(value)
     })
     : [];
 const CUSTOM = /^(UF_CRM_|ufCrm)/;
+/** A portal's own field, not its read-only `_data` twin. */
+export const isCustom = (name) => CUSTOM.test(name) && !name.endsWith("_data");
 const empty = (value) => value === null || value === "" || (Array.isArray(value) && value.length === 0);
 /**
  * The portal's own fields that hold a value, as it names them: their meaning is the portal owner's, so they stay
  * unmapped. `false` and `0` stay, since a yes/no field saying no is an answer.
  */
-export const customFields = (raw) => Object.fromEntries(Object.entries(raw ?? {}).filter(([key, value]) => CUSTOM.test(key) && !key.endsWith("_data") && !empty(value)));
+export const customFields = (raw) => Object.fromEntries(Object.entries(raw ?? {}).filter(([key, value]) => isCustom(key) && !empty(value)));
 export const contactSchema = v.strictObject({ type: v.nullable(v.string()), value: v.string() });
 export const nullableTime = v.nullable(isoTime);
-/** A custom field's value with its title on the portal; `label` is null when the portal did not give one. */
-export const metadataSchema = v.optional(v.record(v.string(), v.strictObject({ label: v.nullable(v.string()), value: v.unknown() })));
+/**
+ * A custom field's value with its title on the portal; `label` is null when the portal did not give one. A list
+ * field's value is its option's label, and `option_id` the option's id (both arrays for a multiple field).
+ */
+export const metadataSchema = v.optional(v.record(v.string(), v.strictObject({
+    label: v.nullable(v.string()),
+    value: v.unknown(),
+    option_id: v.optional(v.union([v.string(), v.array(v.string())])),
+})));
+/**
+ * A filter's time as REST 3.0 takes it, whole seconds with an offset: a live portal refused a filter with
+ * `toISOString()`'s milliseconds and `Z` (REQUESTVALIDATIONEXCEPTION, 2026-11-07).
+ */
+export const portalTime = (ms) => new Date(Math.floor(ms / 1000) * 1000).toISOString().replace(".000Z", "+00:00");
 //# sourceMappingURL=values.js.map

package/dist/crm/values.js.map

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

package/dist/crm/writer.d.ts

@@ -0,0 +1,9 @@
+import { type CrmWriter } from "@wirecat/cli-core/crm";
+import type { BitrixTransport } from "../bitrix/transport.js";
+import type { BitrixCrmSource } from "./source.js";
+/**
+ * Core's write port over REST 3.0. Each write is sent once with its operation id as the `Idempotency-Key` (the
+ * transport never retries a write), then the record is read back whole, as core's store wants it.
+ */
+export declare const bitrixCrmWriter: (portal: () => BitrixTransport, source: BitrixCrmSource) => CrmWriter;
+//# sourceMappingURL=writer.d.ts.map

package/dist/crm/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/crm/writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwC,KAAK,SAAS,EAAwB,MAAM,uBAAuB,CAAA;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAK7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAYlD;;;GAGG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,eAAe,UAAU,eAAe,KAAG,SAkGxF,CAAA"}

package/dist/crm/writer.js

@@ -0,0 +1,119 @@
+import { CliError, isCliError } from "@wirecat/cli-base";
+import { fieldNamed, optionOf } from "@wirecat/cli-core/crm";
+import { foldCode } from "../body.js";
+import { BITRIX_WRITES } from "./capabilities.js";
+import { LEAD_PIPELINE } from "./lead.js";
+import { REST3_FIELDS } from "./rest3-fields.js";
+import { id, numericId } from "./values.js";
+/** A lead's REST 2 stage is `STATUS_ID`. */
+const STANDARD = {
+    deal: new Set(REST3_FIELDS.deal.map(foldCode)),
+    lead: new Set([...REST3_FIELDS.lead, "statusId"].map(foldCode)),
+};
+const refused = (message, param) => new CliError("validation_error", message, { reason: "deal.field", sent: false, ...(param ? { param } : {}) });
+/**
+ * Core's write port over REST 3.0. Each write is sent once with its operation id as the `Idempotency-Key` (the
+ * transport never retries a write), then the record is read back whole, as core's store wants it.
+ */
+export const bitrixCrmWriter = (portal, source) => {
+    /** Every check comes before the first request: a custom code that is a standard field would get round its key. */
+    const fieldsOf = async (kind, given) => {
+        const custom = Object.entries(given.custom ?? {});
+        for (const [code] of custom)
+            if (STANDARD[kind].has(foldCode(code)))
+                throw refused(`${code} is one of Bitrix24's own fields; set it with its own option, not --field`, "--field");
+        if (given.people !== undefined)
+            throw refused("b24 does not set the contacts on a record yet");
+        if (given.owner === null)
+            throw refused("a Bitrix24 record is always assigned to an employee", "--owner");
+        if (kind === "lead" && given.closeDate !== undefined)
+            throw refused("Bitrix24 leads have no close date", "--close-date");
+        if (kind === "lead" && given.pipeline !== undefined && given.pipeline !== LEAD_PIPELINE.externalId)
+            throw refused("Bitrix24 leads have one pipeline", "--pipeline");
+        const fields = {};
+        if (given.title !== undefined)
+            fields.title = given.title;
+        if (kind === "deal" && given.pipeline !== undefined)
+            fields.categoryId = numericId(given.pipeline, "--pipeline");
+        if (given.stage !== undefined)
+            fields.stageId = given.stage;
+        if (given.amount !== undefined)
+            fields.opportunity = given.amount === null ? 0 : Number(given.amount);
+        if (given.currency != null)
+            fields.currencyId = given.currency;
+        if (given.closeDate !== undefined)
+            fields.closeTime = given.closeDate;
+        if (given.organization !== undefined)
+            fields.companyId = given.organization === null ? 0 : numericId(given.organization, "--organization");
+        if (given.owner != null)
+            fields.assignedById = numericId(given.owner, "--owner");
+        if (custom.length === 0)
+            return fields;
+        // Core resolves by the stored definitions, but a store not synced since they were added passes names as typed:
+        // they are checked here against the portal's, or `Number("Website")` would clear a list field.
+        const defined = await source.fields(kind);
+        for (const [name, value] of custom) {
+            const field = fieldNamed(defined, name);
+            const typed = (one) => (field.options ? Number(optionOf(field, one)) : one);
+            if (value === null)
+                fields[field.code] = field.multiple ? [] : null;
+            else
+                fields[field.code] = Array.isArray(value) ? value.map(typed) : typed(value);
+        }
+        return fields;
+    };
+    const keyed = (options) => ({ idempotencyKey: options.operationId });
+    /** The write went through: a failed read-back must never read as a failed write, or the owner repeats it. */
+    const readBack = async (kind, externalId, options) => {
+        try {
+            return await source.item(kind, externalId);
+        }
+        catch (error) {
+            throw new CliError("invalid_response", `Bitrix24 made the change to ${kind} ${externalId}, but reading it back failed` +
+                `${isCliError(error) ? ` (${error.code})` : ""}; run sync to store it — do not write it again`, { operation_id: options.operationId, external_id: externalId, sent: true });
+        }
+    };
+    const update = async (kind, externalId, fields, options) => {
+        await portal().call(`crm.${kind}.update`, { id: Number(externalId), fields }, keyed(options));
+        return readBack(kind, externalId, options);
+    };
+    return {
+        provider: "bitrix24",
+        capabilities: BITRIX_WRITES,
+        async create(kind, draft, options) {
+            const fields = await fieldsOf(kind, draft);
+            const answer = await portal().call(`crm.${kind}.add`, { fields }, keyed(options));
+            const externalId = id(answer.result?.id);
+            if (externalId === null)
+                throw new CliError("invalid_response", `Bitrix24 answered the new ${kind} without its id; run sync before writing again`, { operation_id: options.operationId, sent: true });
+            return readBack(kind, externalId, options);
+        },
+        async update(kind, externalId, patch, options) {
+            const fields = await fieldsOf(kind, patch);
+            if (Object.keys(fields).length === 0)
+                throw refused("nothing to change: name a field");
+            return update(kind, externalId, fields, options);
+        },
+        move: (kind, externalId, stage, options) => update(kind, externalId, { stageId: stage }, options),
+        async close(kind, externalId, outcome, options) {
+            if (options.reason !== undefined)
+                throw refused("Bitrix24 keeps no reason with a won or lost record; leave out --reason", "--reason");
+            const current = await source.item(kind, externalId);
+            const pipeline = (await source.pipelines(kind)).find((one) => one.externalId === current.pipeline);
+            // A pipeline may have several lost stages: the first one in its order is the one a close goes to.
+            const [stage] = (pipeline?.stages ?? [])
+                .filter((one) => one.outcome === outcome)
+                .sort((a, b) => a.position - b.position);
+            if (!stage)
+                throw new CliError("validation_error", `${pipeline?.name ?? "its pipeline"} has no ${outcome} stage`, {
+                    reason: "deal.stage",
+                    sent: false,
+                });
+            return update(kind, externalId, { stageId: stage.externalId }, options);
+        },
+        async remove(kind, externalId, options) {
+            await portal().call(`crm.${kind}.delete`, { id: Number(externalId) }, keyed(options));
+        },
+    };
+};
+//# sourceMappingURL=writer.js.map

package/dist/crm/writer.js.map

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

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EAKhB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAqBxC,eAAO,MAAM,UAAU,QAAO,iBAoB5B,CAAA;AAEF,eAAO,MAAM,aAAa,aAAc,cAAc,KAAG,OAAqD,CAAA;AAE9G,eAAO,MAAM,GAAG,SAAU,MAAM,EAAE,YAAY,UAAU,KAAG,OAAO,CAAC,MAAM,CAA2C,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EAKhB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoDxC,eAAO,MAAM,UAAU,QAAO,iBAqC5B,CAAA;AAEF,eAAO,MAAM,aAAa,aAAc,cAAc,KAAG,OAAqD,CAAA;AAE9G,eAAO,MAAM,GAAG,SAAU,MAAM,EAAE,YAAY,UAAU,KAAG,OAAO,CAAC,MAAM,CAA2C,CAAA"}

package/dist/program.js

@@ -1,33 +1,81 @@
 import { join } from "node:path";
 import { resolvePaths } from "@wirecat/cli-base";
-import { commandsCommand, configCommand, createProgram as createSharedProgram, outputFor, run as runShared, runsCommand, skillCommand, upgradeCommand, } from "@wirecat/cli-core/cli";
+import { appDoctorCommand, appMcpCommand, commandsCommand, configCommand, createProgram as createSharedProgram, environmentOf, outputFor, run as runShared, runsCommand, skillCommand, upgradeCommand, } from "@wirecat/cli-core/cli";
 import { appUpdate } from "@wirecat/cli-core/update";
 import { apiCommand } from "./commands/api.js";
 import { crmCommands } from "./commands/crm.js";
+import { crmSharedCommands } from "./commands/crm-shared.js";
 import { addWrites } from "./commands/crm-writes.js";
-import { doctorCommand } from "./commands/doctor.js";
-import { mcpCommand } from "./commands/mcp.js";
 import { sessionCommand } from "./commands/session.js";
 import { configuration } from "./config.js";
 import { IDENTITY, PACKAGE, SKILL } from "./identity.js";
+import { tokens } from "./token.js";
 const update = appUpdate({
     packageName: PACKAGE,
     command: IDENTITY.command,
     version: IDENTITY.version,
     entry: import.meta.url,
     statePath: (env) => join(resolvePaths({ appName: IDENTITY.appName, prefix: IDENTITY.envPrefix, env }).state, "update-check.json"),
+    // biome-ignore lint/plugin/no-own-settings: the update check runs before any command exists to give baseContext
     enabled: (env) => configuration.resolveSettings({}, { env, needsProfile: false }).updateCheck,
     offVariables: [`${IDENTITY.envPrefix}_NO_UPDATE_CHECK`],
 });
+const mcpCommand = () => {
+    // cli-core asks `signedIn` with no keyring; the run's own one, a test's `memoryKeyring()`, is taken here, as gcal does.
+    let keyring;
+    const mcp = appMcpCommand(IDENTITY, configuration, {
+        name: "Bitrix24",
+        untrusted: [
+            "deal and lead titles",
+            "pipeline and stage names",
+            "names of contacts, companies and employees",
+            "custom field values",
+            "phone numbers, e-mail addresses and links",
+            "whatever api call returns",
+            "the messages, notes and events search all finds",
+        ],
+        permissionExample: "deals.delete=deny",
+        skill: SKILL,
+        signedIn: (profile, env) => {
+            try {
+                return tokens(env, keyring).read(profile) !== undefined;
+            }
+            catch {
+                // A keyring that cannot be read fails the server's tools as well.
+                return false;
+            }
+        },
+    });
+    return mcp.hook("preAction", (_mcp, action) => {
+        keyring = environmentOf(action).keyring;
+    });
+};
 export const definition = () => ({
     app: IDENTITY,
-    configuration: { resolveSettings: configuration.resolveSettings },
+    // The whole object: cli-core refuses a command by its key only when it gets the permission table too.
+    configuration,
+    firstScreen: {
+        pitch: "a Bitrix24 portal's CRM in a local store, for scripts and agents, with a permission on every write.",
+        can: [
+            {
+                command: "sync",
+                does: "copy the portal's deals, leads, contacts and companies; the next sync takes the changes",
+            },
+            { command: "deals list status:open", does: "open deals with stage, amount and owner, from the store, offline" },
+            { command: 'search all "kitchen"', does: "stored deals and leads beside your other WireCat tools' data" },
+            { command: "deals move <ref> <stage>", does: "move a deal; deals.move=ask stops robots that write to clients" },
+            { command: "api call <method> --dry-run", does: "any REST method, with every permission it checks" },
+            { command: "mcp serve --permission deals=deny", does: "the CRM in any agent, with the levels you set" },
+        ],
+        start: `${IDENTITY.command} work session start`,
+    },
     commands: () => [
         commandsCommand(IDENTITY),
         sessionCommand(),
+        ...crmSharedCommands(),
         ...crmCommands().map(addWrites),
         apiCommand(),
-        doctorCommand(),
+        appDoctorCommand(IDENTITY, configuration, { packageName: PACKAGE }),
         skillCommand(IDENTITY, SKILL),
         mcpCommand(),
         upgradeCommand(IDENTITY, PACKAGE, (command) => ({

package/dist/program.js.map

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

package/dist/reasons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../src/reasons.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,OAAO;;;;;;GAAoG,CAAA;AAExH,4DAA4D;AAC5D,eAAO,MAAM,OAAO,UAAa,CAAA"}
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../src/reasons.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,OAAO;;;;;;GAAoG,CAAA;AAExH,4DAA4D;AAC5D,eAAO,MAAM,OAAO,UAAsB,CAAA"}