@ouro.bot/cli 0.1.0-alpha.816 → 0.1.0-alpha.818

package/dist/heart/daemon/sanctuary-telegram-authority-gateway.js

@@ -0,0 +1,585 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSanctuaryTelegramAuthorityGateway = void 0;
+exports.sanctuaryTelegramAuthorityStatePath = sanctuaryTelegramAuthorityStatePath;
+exports.sanctuaryAuthorityPublicKeyDigest = sanctuaryAuthorityPublicKeyDigest;
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const runtime_1 = require("../../nerves/runtime");
+const session_transaction_1 = require("../../mind/session-transaction");
+const sanctuary_authority_codec_1 = require("./sanctuary-authority-codec");
+const SCHEMA_VERSION = 1;
+const OBSERVATION_DOMAIN = "ouro.sanctuary.telegram-observation.v1";
+const RAW_UPDATE_DIGEST = /^tgu_[A-Za-z0-9_-]{43}$/u;
+const DECIMAL_ID = /^[1-9][0-9]*$/u;
+const NONCE = /^[A-Za-z0-9_-]{43}$/u;
+const ADMISSION_ID = /^[a-f0-9]{20}$/u;
+const MAX_AUTHORIZED_CHATS = 64;
+const AUTHORIZED_CHAT_IDLE_MS = 365 * 24 * 60 * 60 * 1_000;
+function sanctuaryTelegramAuthorityStatePath(agentRoot) {
+    return path.join(agentRoot, "authority", "telegram-state.json");
+}
+function sanctuaryAuthorityPublicKeyDigest(key) {
+    const bytes = (0, node_crypto_1.createPublicKey)(key).export({ type: "spki", format: "der" });
+    return `sha256:${(0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex")}`;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function exactKeys(value, keys) {
+    const actual = Object.keys(value).sort();
+    const expected = [...keys].sort();
+    return actual.length === expected.length && actual.every((key, index) => key === expected[index]);
+}
+function validTime(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        return new Date(value).toISOString() === value;
+    }
+    catch {
+        return false;
+    }
+}
+function rawUpdateDigest(update) {
+    return `tgu_${(0, node_crypto_1.createHash)("sha256")
+        .update(`ouroboros.telegram.update.v1\0${JSON.stringify(update)}`, "utf8")
+        .digest("base64url")}`;
+}
+function residentUpdate(update) {
+    const callback = update.callback_query;
+    if (!callback?.data?.startsWith("ouh:") || !callback.message)
+        return structuredClone(update);
+    return {
+        update_id: update.update_id,
+        callback_query: {
+            id: callback.id,
+            from: { id: callback.from.id },
+            message: { message_id: callback.message.message_id, chat: { id: callback.message.chat.id } },
+            data: "root-host-callback",
+        },
+    };
+}
+function validUpdate(value) {
+    return isObject(value) && Number.isSafeInteger(value.update_id) && value.update_id >= 0;
+}
+function updateCoordinates(update) {
+    const callback = update.callback_query;
+    if (callback
+        && Number.isSafeInteger(callback.from?.id)
+        && callback.message
+        && Number.isSafeInteger(callback.message.message_id)
+        && Number.isSafeInteger(callback.message.chat?.id)
+        && typeof callback.id === "string"
+        && callback.id.length > 0) {
+        return {
+            updateClass: "callback",
+            userId: String(callback.from.id),
+            chatId: String(callback.message.chat.id),
+            messageId: String(callback.message.message_id),
+            callbackQueryId: callback.id,
+        };
+    }
+    const message = update.message;
+    if (message
+        && message.chat?.type === "private"
+        && message.from
+        && Number.isSafeInteger(message.from.id)
+        && Number.isSafeInteger(message.chat.id)
+        && Number.isSafeInteger(message.message_id)) {
+        return {
+            updateClass: "message",
+            userId: String(message.from.id),
+            chatId: String(message.chat.id),
+            messageId: String(message.message_id),
+            callbackQueryId: null,
+        };
+    }
+    return null;
+}
+function initialState() {
+    return { schemaVersion: SCHEMA_VERSION, cursor: 0, records: {}, authorizedChats: {} };
+}
+function validateObservation(value) {
+    if (!isObject(value)
+        || !exactKeys(value, ["schemaVersion", "domain", "keyId", "payload", "signature"])
+        || value.schemaVersion !== 1
+        || value.domain !== OBSERVATION_DOMAIN
+        || typeof value.keyId !== "string"
+        || value.keyId.length === 0
+        || typeof value.signature !== "string"
+        || !isObject(value.payload)) {
+        throw new Error("Sanctuary Telegram authority observation is malformed");
+    }
+}
+function validateRecord(value, updateId) {
+    if (!isObject(value)
+        || !exactKeys(value, ["updateId", "rawUpdateDigest", "rawUpdate", "disposition", "settlement", "observation", ...(Object.hasOwn(value, "deliveryUpdate") ? ["deliveryUpdate"] : [])])
+        || value.updateId !== updateId
+        || typeof value.rawUpdateDigest !== "string"
+        || !RAW_UPDATE_DIGEST.test(value.rawUpdateDigest)
+        || !isObject(value.rawUpdate)
+        || value.rawUpdate.update_id !== updateId) {
+        throw new Error(`Sanctuary Telegram authority record ${updateId} is malformed`);
+    }
+    if (value.disposition === "ignored") {
+        if (value.settlement !== "ignored" || value.observation !== null) {
+            throw new Error(`Sanctuary Telegram authority ignored record ${updateId} is ambiguous`);
+        }
+        return;
+    }
+    if (value.disposition !== "dispatch"
+        || !["pending", "completed", "indeterminate"].includes(String(value.settlement))) {
+        throw new Error(`Sanctuary Telegram authority record ${updateId} has invalid settlement`);
+    }
+    validateObservation(value.observation);
+    if (Object.hasOwn(value, "deliveryUpdate") && JSON.stringify(value.deliveryUpdate) !== JSON.stringify(residentUpdate(value.rawUpdate))) {
+        throw new Error("Sanctuary Telegram authority delivery projection changed");
+    }
+}
+function validateState(value) {
+    if (!isObject(value)
+        || !exactKeys(value, ["schemaVersion", "cursor", "records", "authorizedChats"])
+        || value.schemaVersion !== SCHEMA_VERSION
+        || !Number.isSafeInteger(value.cursor)
+        || value.cursor < 0
+        || !isObject(value.records)
+        || !isObject(value.authorizedChats)) {
+        throw new Error("Sanctuary Telegram authority state is malformed");
+    }
+    for (const [key, record] of Object.entries(value.records)) {
+        if (!/^(?:0|[1-9][0-9]*)$/u.test(key)) {
+            throw new Error("Sanctuary Telegram authority state has an invalid update key");
+        }
+        validateRecord(record, Number(key));
+    }
+    if (Object.keys(value.authorizedChats).length > MAX_AUTHORIZED_CHATS) {
+        throw new Error("Sanctuary Telegram authority chat registry exceeds its limit");
+    }
+    for (const [key, entry] of Object.entries(value.authorizedChats)) {
+        if (!isObject(entry)
+            || !exactKeys(entry, ["admissionId", "updateId", "userId", "chatId", "admittedAt", "lastObservedAt"])
+            || key !== `${entry.userId}:${entry.chatId}`
+            || !ADMISSION_ID.test(String(entry.admissionId))
+            || !Number.isSafeInteger(entry.updateId)
+            || entry.updateId < 0
+            || !DECIMAL_ID.test(String(entry.userId))
+            || !DECIMAL_ID.test(String(entry.chatId))
+            || !validTime(entry.admittedAt)
+            || !validTime(entry.lastObservedAt)) {
+            throw new Error("Sanctuary Telegram authority chat registry is malformed");
+        }
+    }
+}
+function transactionState(transaction) {
+    if (transaction.value === null) {
+        if (transaction.bytes)
+            throw new Error("Sanctuary Telegram authority state is malformed");
+        return initialState();
+    }
+    validateState(transaction.value);
+    return transaction.value;
+}
+class FileSanctuaryTelegramAuthorityGateway {
+    #statePath;
+    #options;
+    constructor(agentRoot, options) {
+        if (typeof agentRoot !== "string" || agentRoot.length === 0) {
+            throw new Error("Sanctuary Telegram authority root is invalid");
+        }
+        for (const [label, value] of [
+            ["bot id", options.botId],
+            ["owner user id", options.ownerUserId],
+            ["owner chat id", options.ownerChatId],
+        ]) {
+            if (!DECIMAL_ID.test(value))
+                throw new Error(`Sanctuary Telegram authority ${label} is invalid`);
+        }
+        if (!options.targetHost
+            || !options.keyId
+            || options.publicKeyDigest !== sanctuaryAuthorityPublicKeyDigest(options.privateKey)) {
+            throw new Error("Sanctuary Telegram authority issuer configuration is invalid");
+        }
+        this.#statePath = sanctuaryTelegramAuthorityStatePath(agentRoot);
+        this.#options = {
+            ...options,
+            now: options.now ?? (() => new Date().toISOString()),
+            nonce: options.nonce ?? (() => (0, node_crypto_1.randomBytes)(32).toString("base64url")),
+        };
+    }
+    initializeCursor(cursor) {
+        if (!Number.isSafeInteger(cursor) || cursor < 0)
+            throw new Error("Sanctuary Telegram migration cursor is invalid");
+        (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            if (Object.keys(state.records).length !== 0 || (transaction.value !== null && state.cursor !== cursor))
+                throw new Error("Sanctuary Telegram migration cursor is already owned");
+            if (transaction.value !== null)
+                return;
+            state.cursor = cursor;
+            this.#write(state, transaction.revision, lease);
+        });
+    }
+    cursorSnapshot() {
+        return this.#read((state) => {
+            const records = Object.values(state.records).sort((a, b) => a.updateId - b.updateId);
+            const progress = { cursor: state.cursor, records: records.map(({ updateId, rawUpdateDigest, settlement }) => ({ updateId, rawUpdateDigest, settlement })) };
+            return (0, sanctuary_authority_codec_1.signAuthorityPayload)({
+                domain: "ouro.sanctuary.telegram-cursor.v1",
+                keyId: this.#options.keyId,
+                privateKey: this.#options.privateKey,
+                payload: {
+                    ...this.identity(),
+                    cursor: state.cursor,
+                    pendingUpdateIds: records.filter((record) => record.settlement === "pending").map((record) => record.updateId),
+                    progressDigest: (0, sanctuary_authority_codec_1.authorityArtifactDigest)("ouro.sanctuary.telegram-progress.v1", progress),
+                    observedAt: this.#now(),
+                },
+            });
+        }, true);
+    }
+    capture(updates) {
+        if (!Array.isArray(updates))
+            throw new Error("Sanctuary Telegram authority updates must be an array");
+        (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            let changed = false;
+            for (const update of updates) {
+                if (!validUpdate(update)) {
+                    throw new Error("Sanctuary Telegram authority update is invalid");
+                }
+                const updateId = update.update_id;
+                const digest = rawUpdateDigest(update);
+                const existing = state.records[String(updateId)];
+                if (existing) {
+                    if (existing.rawUpdateDigest !== digest) {
+                        throw new Error(`Sanctuary Telegram authority duplicate update ${updateId} changed`);
+                    }
+                    continue;
+                }
+                if (updateId < state.cursor) {
+                    throw new Error(`Sanctuary Telegram authority update ${updateId} is stale`);
+                }
+                const coordinates = updateCoordinates(update);
+                if (!coordinates) {
+                    state.records[String(updateId)] = {
+                        updateId,
+                        rawUpdateDigest: digest,
+                        rawUpdate: structuredClone(update),
+                        disposition: "ignored",
+                        settlement: "ignored",
+                        observation: null,
+                    };
+                    changed = true;
+                    continue;
+                }
+                const observedAt = this.#options.now();
+                if (!validTime(observedAt))
+                    throw new Error("Sanctuary Telegram authority clock is invalid");
+                this.#pruneAuthorizedChats(state, observedAt);
+                const admitted = state.authorizedChats[`${coordinates.userId}:${coordinates.chatId}`];
+                if (admitted)
+                    admitted.lastObservedAt = observedAt;
+                const nonce = this.#options.nonce();
+                if (!NONCE.test(nonce))
+                    throw new Error("Sanctuary Telegram authority nonce is invalid");
+                if (Object.values(state.records).some((record) => record.observation?.payload.nonce === nonce)) {
+                    throw new Error("Sanctuary Telegram authority nonce is already used");
+                }
+                const payload = {
+                    targetHost: this.#options.targetHost,
+                    botId: this.#options.botId,
+                    updateId,
+                    ...coordinates,
+                    ownerEligible: coordinates.userId === this.#options.ownerUserId
+                        && coordinates.chatId === this.#options.ownerChatId,
+                    rawUpdateDigest: digest,
+                    ...(rawUpdateDigest(residentUpdate(update)) !== digest ? { deliveryUpdateDigest: rawUpdateDigest(residentUpdate(update)) } : {}),
+                    observedAt,
+                    settlement: "pending",
+                    nonce,
+                    publicKeyDigest: this.#options.publicKeyDigest,
+                };
+                state.records[String(updateId)] = {
+                    updateId,
+                    rawUpdateDigest: digest,
+                    rawUpdate: structuredClone(update),
+                    disposition: "dispatch",
+                    settlement: "pending",
+                    observation: (0, sanctuary_authority_codec_1.signAuthorityPayload)({
+                        domain: OBSERVATION_DOMAIN,
+                        keyId: this.#options.keyId,
+                        payload,
+                        privateKey: this.#options.privateKey,
+                    }),
+                    ...(rawUpdateDigest(residentUpdate(update)) !== digest ? { deliveryUpdate: residentUpdate(update) } : {}),
+                };
+                changed = true;
+            }
+            this.#advanceCursor(state);
+            if (changed)
+                this.#write(state, transaction.revision, lease);
+            (0, runtime_1.emitNervesEvent)({ component: "daemon", event: "daemon.sanctuary_telegram_capture_settled", message: "Sanctuary Telegram ingress capture settled", meta: { changed } });
+        });
+    }
+    poll() {
+        return this.#read((state) => {
+            const record = Object.values(state.records)
+                .filter((candidate) => candidate.disposition === "dispatch"
+                && candidate.settlement === "pending"
+                && candidate.updateId >= state.cursor)
+                .sort((left, right) => left.updateId - right.updateId)[0];
+            return record?.observation ?? null;
+        });
+    }
+    settle(settlement) {
+        if (!isObject(settlement)
+            || !exactKeys(settlement, ["updateId", "observationDigest", "outcome"])
+            || !Number.isSafeInteger(settlement.updateId)
+            || settlement.updateId < 0
+            || typeof settlement.observationDigest !== "string"
+            || !/^sha256:[a-f0-9]{64}$/u.test(settlement.observationDigest)
+            || !["completed", "indeterminate"].includes(String(settlement.outcome))) {
+            throw new Error("Sanctuary Telegram authority settlement is malformed");
+        }
+        (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            const record = state.records[String(settlement.updateId)];
+            if (!record || record.disposition !== "dispatch") {
+                throw new Error(`Sanctuary Telegram authority update ${settlement.updateId} is missing`);
+            }
+            if (record.settlement !== "pending") {
+                throw new Error(`Sanctuary Telegram authority update ${settlement.updateId} is already settled`);
+            }
+            const digest = (0, sanctuary_authority_codec_1.authorityArtifactDigest)(record.observation.domain, record.observation.payload);
+            if (digest !== settlement.observationDigest) {
+                throw new Error(`Sanctuary Telegram authority observation digest changed for ${settlement.updateId}`);
+            }
+            record.settlement = settlement.outcome;
+            this.#advanceCursor(state);
+            this.#write(state, transaction.revision, lease);
+        });
+    }
+    cursor() {
+        return this.#read((state) => state.cursor);
+    }
+    identity() {
+        return {
+            targetHost: this.#options.targetHost,
+            botId: this.#options.botId,
+            ownerUserId: this.#options.ownerUserId,
+            ownerChatId: this.#options.ownerChatId,
+            keyId: this.#options.keyId,
+            publicKeyDigest: this.#options.publicKeyDigest,
+        };
+    }
+    ownsCallbackQuery(callbackQueryId) {
+        if (typeof callbackQueryId !== "string" || callbackQueryId.length === 0)
+            return false;
+        return this.#read((state) => Object.values(state.records).some((record) => record.disposition === "dispatch"
+            && record.rawUpdate.callback_query?.id === callbackQueryId));
+    }
+    ownsFileId(fileId) {
+        if (typeof fileId !== "string" || fileId.length === 0)
+            return false;
+        return this.#read((state) => Object.values(state.records).some((record) => {
+            if (record.disposition !== "dispatch")
+                return false;
+            const message = record.rawUpdate.message;
+            return message?.document?.file_id === fileId
+                || message?.audio?.file_id === fileId
+                || message?.video?.file_id === fileId
+                || message?.voice?.file_id === fileId
+                || message?.animation?.file_id === fileId
+                || message?.sticker?.file_id === fileId
+                || message?.photo?.some((photo) => photo.file_id === fileId) === true;
+        }));
+    }
+    ownsCurrentObservation(input) {
+        if (!Number.isSafeInteger(input.updateId)
+            || input.updateId < 0
+            || !/^sha256:[a-f0-9]{64}$/u.test(input.observationDigest)
+            || !DECIMAL_ID.test(input.chatId))
+            return false;
+        return this.#read((state) => {
+            const record = state.records[String(input.updateId)];
+            return Boolean(record
+                && record.disposition === "dispatch"
+                && record.settlement === "pending"
+                && record.observation.payload.chatId === input.chatId
+                && (0, sanctuary_authority_codec_1.authorityArtifactDigest)(record.observation.domain, record.observation.payload) === input.observationDigest);
+        });
+    }
+    ownerObservation(input) {
+        if (!Number.isSafeInteger(input.updateId)
+            || input.updateId < 0
+            || !/^sha256:[a-f0-9]{64}$/u.test(input.observationDigest))
+            return null;
+        return this.#read((state) => {
+            const record = state.records[String(input.updateId)];
+            if (!record
+                || record.disposition !== "dispatch"
+                || record.settlement !== "pending"
+                || !record.observation.payload.ownerEligible
+                || (0, sanctuary_authority_codec_1.authorityArtifactDigest)(record.observation.domain, record.observation.payload) !== input.observationDigest)
+                return null;
+            return record.observation;
+        });
+    }
+    admitChat(input) {
+        if (!ADMISSION_ID.test(input.admissionId)
+            || !Number.isSafeInteger(input.updateId)
+            || input.updateId < 0
+            || !DECIMAL_ID.test(input.userId)
+            || !DECIMAL_ID.test(input.chatId)) {
+            throw new Error("Sanctuary Telegram authority chat admission is malformed");
+        }
+        (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            const record = state.records[String(input.updateId)];
+            if (!record
+                || record.disposition !== "dispatch"
+                || record.observation.payload.userId !== input.userId
+                || record.observation.payload.chatId !== input.chatId
+                || record.observation.payload.ownerEligible) {
+                throw new Error("Sanctuary Telegram authority chat admission is not root-observed");
+            }
+            const now = this.#now();
+            this.#pruneAuthorizedChats(state, now);
+            if (Date.parse(record.observation.payload.observedAt) <= Date.parse(now) - AUTHORIZED_CHAT_IDLE_MS) {
+                throw new Error("Sanctuary Telegram authority chat observation expired");
+            }
+            const key = `${input.userId}:${input.chatId}`;
+            const existing = state.authorizedChats[key];
+            if (existing) {
+                if (input.updateId <= existing.updateId && (existing.admissionId !== input.admissionId || existing.updateId !== input.updateId)) {
+                    throw new Error("Sanctuary Telegram authority chat admission changed");
+                }
+                return;
+            }
+            if (Object.keys(state.authorizedChats).length >= MAX_AUTHORIZED_CHATS) {
+                throw new Error("Sanctuary Telegram authority chat registry limit reached");
+            }
+            state.authorizedChats[key] = {
+                ...input,
+                admittedAt: now,
+                lastObservedAt: record.observation.payload.observedAt,
+            };
+            this.#write(state, transaction.revision, lease);
+        });
+    }
+    revokeChat(input) {
+        if (!DECIMAL_ID.test(input.userId) || !DECIMAL_ID.test(input.chatId)) {
+            throw new Error("Sanctuary Telegram authority chat revocation is malformed");
+        }
+        (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            const key = `${input.userId}:${input.chatId}`;
+            if (!state.authorizedChats[key])
+                return;
+            delete state.authorizedChats[key];
+            this.#write(state, transaction.revision, lease);
+        });
+    }
+    isAuthorizedChat(chatId) {
+        if (!DECIMAL_ID.test(chatId))
+            return false;
+        if (chatId === this.#options.ownerChatId)
+            return true;
+        return (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            const state = transactionState(transaction);
+            const now = this.#now();
+            const changed = this.#pruneAuthorizedChats(state, now);
+            const entry = Object.values(state.authorizedChats).find((candidate) => candidate.chatId === chatId);
+            if (changed)
+                this.#write(state, transaction.revision, lease);
+            return Boolean(entry);
+        });
+    }
+    record(updateId) {
+        if (!Number.isSafeInteger(updateId) || updateId < 0) {
+            throw new Error("Sanctuary Telegram authority update id is invalid");
+        }
+        return this.#read((state) => state.records[String(updateId)] ?? null);
+    }
+    #advanceCursor(state) {
+        const records = Object.values(state.records)
+            .filter((record) => record.updateId >= state.cursor)
+            .sort((left, right) => left.updateId - right.updateId);
+        for (const record of records) {
+            if (record.disposition === "dispatch" && record.settlement === "pending")
+                break;
+            state.cursor = record.updateId + 1;
+        }
+    }
+    #now() {
+        const now = this.#options.now();
+        if (!validTime(now))
+            throw new Error("Sanctuary Telegram authority clock is invalid");
+        return now;
+    }
+    #pruneAuthorizedChats(state, now) {
+        let changed = false;
+        const cutoff = Date.parse(now) - AUTHORIZED_CHAT_IDLE_MS;
+        for (const [key, entry] of Object.entries(state.authorizedChats)) {
+            if (Date.parse(entry.lastObservedAt) <= cutoff) {
+                delete state.authorizedChats[key];
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    #read(read, requirePersisted = false) {
+        return (0, session_transaction_1.withImmediateSessionTurnLease)(this.#statePath, (lease) => {
+            const transaction = (0, session_transaction_1.readSessionTransaction)(this.#statePath, lease);
+            if (requirePersisted && transaction.value === null)
+                throw new Error("Sanctuary Telegram authority cursor state is absent");
+            return read(transactionState(transaction));
+        });
+    }
+    #write(state, expectedRevision, lease) {
+        fs.chmodSync(path.dirname(this.#statePath), 0o700);
+        (0, session_transaction_1.writeSessionTransaction)(this.#statePath, state, { lease, expectedRevision });
+    }
+}
+exports.FileSanctuaryTelegramAuthorityGateway = FileSanctuaryTelegramAuthorityGateway;