twinny 0.0.0-dev.260525150705

package/dist/launchd/plist.js.map

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

package/dist/lock/index.d.ts

@@ -0,0 +1,20 @@
+import type { CheckOptions, LockOptions } from "proper-lockfile";
+import type { RuntimePaths } from "../types.js";
+export interface TwinnyLockMetadata {
+    pid: number;
+    acquiredAt: number;
+}
+export interface TwinnyRuntimeLock {
+    lockFile: string;
+    metadata: TwinnyLockMetadata;
+    release: () => Promise<void>;
+}
+export interface AcquireTwinnyLockOptions extends Pick<LockOptions, "stale" | "update" | "retries" | "onCompromised"> {
+}
+export interface CheckTwinnyLockOptions extends Pick<CheckOptions, "stale"> {
+}
+export declare function getTwinnyLockFile(twinnyHome: string): string;
+export declare function acquireTwinnyLock(target: string | Pick<RuntimePaths, "lockFile">, options?: AcquireTwinnyLockOptions): Promise<TwinnyRuntimeLock>;
+export declare function isTwinnyLockHeld(target: string | Pick<RuntimePaths, "lockFile">, options?: CheckTwinnyLockOptions): Promise<boolean>;
+export declare function readTwinnyLockMetadata(target: string | Pick<RuntimePaths, "lockFile">, options?: CheckTwinnyLockOptions): Promise<TwinnyLockMetadata | undefined>;
+export declare function readTwinnyLockPid(target: string | Pick<RuntimePaths, "lockFile">, options?: CheckTwinnyLockOptions): Promise<number | undefined>;

package/dist/lock/index.js

@@ -0,0 +1,74 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import * as properLockfile from "proper-lockfile";
+export function getTwinnyLockFile(twinnyHome) {
+    return path.join(twinnyHome, "runtime", "twinny.lock");
+}
+export async function acquireTwinnyLock(target, options = {}) {
+    const lockFile = resolveLockFile(target);
+    await fs.mkdir(path.dirname(lockFile), { recursive: true });
+    await fs.appendFile(lockFile, "");
+    const releaseProperLock = await properLockfile.lock(lockFile, {
+        ...options,
+        realpath: false
+    });
+    const metadata = { pid: process.pid, acquiredAt: Date.now() };
+    let released = false;
+    await fs.writeFile(lockFile, `${JSON.stringify(metadata)}\n`, "utf8");
+    return {
+        lockFile,
+        metadata,
+        release: async () => {
+            if (released) {
+                return;
+            }
+            released = true;
+            await fs.writeFile(lockFile, "", "utf8");
+            await releaseProperLock();
+        }
+    };
+}
+export async function isTwinnyLockHeld(target, options = {}) {
+    const lockFile = resolveLockFile(target);
+    try {
+        return await properLockfile.check(lockFile, {
+            ...options,
+            realpath: false
+        });
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function readTwinnyLockMetadata(target, options = {}) {
+    const lockFile = resolveLockFile(target);
+    const held = await isTwinnyLockHeld({ lockFile }, options);
+    if (!held) {
+        return undefined;
+    }
+    const raw = await fs.readFile(lockFile, "utf8");
+    if (raw.trim() === "") {
+        return undefined;
+    }
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.pid !== "number" || typeof parsed.acquiredAt !== "number") {
+        return undefined;
+    }
+    return {
+        pid: parsed.pid,
+        acquiredAt: parsed.acquiredAt
+    };
+}
+export async function readTwinnyLockPid(target, options = {}) {
+    return (await readTwinnyLockMetadata(target, options))?.pid;
+}
+function resolveLockFile(target) {
+    if (typeof target === "string") {
+        return getTwinnyLockFile(target);
+    }
+    return target.lockFile;
+}
+//# sourceMappingURL=index.js.map

package/dist/lock/index.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCli } from "./cli/commands.js";
+import { toErrorMessage } from "./errors.js";
+try {
+    await runCli(process.argv);
+}
+catch (error) {
+    console.error(toErrorMessage(error));
+    process.exitCode = 1;
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,IAAI,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,12 @@
+export interface TextRange {
+    start: number;
+    end: number;
+}
+export interface MarkdownLine {
+    text: string;
+    start: number;
+    end: number;
+}
+export declare function markdownLines(markdown: string): MarkdownLine[];
+export declare function markdownCodeRanges(markdown: string): TextRange[];
+export declare function isPositionInTextRanges(position: number, ranges: TextRange[]): boolean;

package/dist/markdown.js

@@ -0,0 +1,149 @@
+export function markdownLines(markdown) {
+    const lines = [];
+    const lineEndPattern = /\r?\n/g;
+    let cursor = 0;
+    for (const match of markdown.matchAll(lineEndPattern)) {
+        const index = match.index ?? 0;
+        const lineEnd = index + match[0].length;
+        lines.push({ text: markdown.slice(cursor, index), start: cursor, end: lineEnd });
+        cursor = lineEnd;
+    }
+    if (cursor < markdown.length) {
+        lines.push({ text: markdown.slice(cursor), start: cursor, end: markdown.length });
+    }
+    return lines;
+}
+export function markdownCodeRanges(markdown) {
+    const blockRanges = markdownCodeBlockRanges(markdown);
+    const inlineRanges = markdownInlineCodeRanges(markdown, blockRanges);
+    return mergeTextRanges([...blockRanges, ...inlineRanges]);
+}
+export function isPositionInTextRanges(position, ranges) {
+    for (const range of ranges) {
+        if (position < range.start) {
+            return false;
+        }
+        if (position < range.end) {
+            return true;
+        }
+    }
+    return false;
+}
+function markdownCodeBlockRanges(markdown) {
+    const ranges = [];
+    let fence;
+    for (const line of markdownLines(markdown)) {
+        if (fence) {
+            if (isClosingFence(line.text, fence)) {
+                ranges.push({ start: fence.start, end: line.end });
+                fence = undefined;
+            }
+            continue;
+        }
+        const openingFence = openingMarkdownFence(line.text);
+        if (openingFence) {
+            fence = { ...openingFence, start: line.start };
+            continue;
+        }
+        if (isIndentedCodeLine(line.text)) {
+            ranges.push({ start: line.start, end: line.end });
+        }
+    }
+    if (fence) {
+        ranges.push({ start: fence.start, end: markdown.length });
+    }
+    return mergeTextRanges(ranges);
+}
+function markdownInlineCodeRanges(markdown, blockRanges) {
+    const ranges = [];
+    let index = 0;
+    while (index < markdown.length) {
+        const blockRange = rangeContainingOrAfter(index, blockRanges);
+        if (blockRange && index >= blockRange.start) {
+            index = blockRange.end;
+            continue;
+        }
+        if (markdown[index] !== "`") {
+            index += 1;
+            continue;
+        }
+        const length = countBackticks(markdown, index);
+        const close = findClosingBacktickRun(markdown, index + length, length, blockRanges);
+        if (close === -1) {
+            index += length;
+            continue;
+        }
+        const end = close + length;
+        ranges.push({ start: index, end });
+        index = end;
+    }
+    return ranges;
+}
+function openingMarkdownFence(line) {
+    const match = /^ {0,3}(`{3,}|~{3,})/.exec(line);
+    if (!match) {
+        return undefined;
+    }
+    const sequence = match[1];
+    return {
+        char: sequence[0],
+        length: sequence.length
+    };
+}
+function isClosingFence(line, fence) {
+    const match = /^ {0,3}(`+|~+)[ \t]*$/.exec(line);
+    if (!match) {
+        return false;
+    }
+    const sequence = match[1];
+    return sequence[0] === fence.char && sequence.length >= fence.length;
+}
+function isIndentedCodeLine(line) {
+    return line.trim().length > 0 && /^(?: {4,}|\t)/.test(line);
+}
+function findClosingBacktickRun(markdown, start, length, blockRanges) {
+    let index = start;
+    while (index < markdown.length) {
+        const blockRange = rangeContainingOrAfter(index, blockRanges);
+        if (blockRange && index >= blockRange.start) {
+            index = blockRange.end;
+            continue;
+        }
+        if (markdown[index] !== "`") {
+            index += 1;
+            continue;
+        }
+        const runLength = countBackticks(markdown, index);
+        if (runLength === length) {
+            return index;
+        }
+        index += runLength;
+    }
+    return -1;
+}
+function countBackticks(markdown, start) {
+    let index = start;
+    while (markdown[index] === "`") {
+        index += 1;
+    }
+    return index - start;
+}
+function rangeContainingOrAfter(position, ranges) {
+    return ranges.find((range) => position < range.end);
+}
+function mergeTextRanges(ranges) {
+    const sorted = ranges
+        .filter((range) => range.end > range.start)
+        .sort((left, right) => left.start - right.start || left.end - right.end);
+    const merged = [];
+    for (const range of sorted) {
+        const previous = merged.at(-1);
+        if (previous && range.start <= previous.end) {
+            previous.end = Math.max(previous.end, range.end);
+            continue;
+        }
+        merged.push({ ...range });
+    }
+    return merged;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/observability/health.d.ts

@@ -0,0 +1,25 @@
+import fs from "node:fs/promises";
+import { type SecretStore } from "../config/index.js";
+import { LarkBotDirectory, LarkOpenApiClient, TenantAccessTokenManager } from "../lark/index.js";
+import type { HealthSnapshot, TwinnyConfig } from "../types.js";
+export declare function runDoctorCommand(): Promise<void>;
+export declare function runDoctorChecks(): Promise<HealthSnapshot>;
+export declare function checkCaffeinateBinary(options?: {
+    command?: string;
+    platform?: NodeJS.Platform;
+    access?: typeof fs.access;
+}): Promise<string>;
+export declare function checkLarkBotOpenId(config: Pick<TwinnyConfig, "auth">, appSecret: string, options?: {
+    tokenManager?: TenantAccessTokenManager;
+    openApiClient?: LarkOpenApiClient;
+    botDirectory?: Pick<LarkBotDirectory, "getBotOpenId">;
+}): Promise<string>;
+export declare function checkLarkRequiredScopes(config: Pick<TwinnyConfig, "auth">, appSecret: string, options?: {
+    tokenManager?: TenantAccessTokenManager;
+    openApiClient?: Pick<LarkOpenApiClient, "request">;
+    requiredScopes?: readonly string[];
+}): Promise<string>;
+export declare function resolveDoctorLarkAppSecret(account: string, secretStore: SecretStore): Promise<{
+    value: string;
+    detail: "present";
+}>;

package/dist/observability/health.js

@@ -0,0 +1,187 @@
+import { constants as fsConstants } from "node:fs";
+import fs from "node:fs/promises";
+import { execa } from "execa";
+import { DEFAULT_CAFFEINATE_COMMAND } from "../app/caffeinate.js";
+import { formatStartupInitializationProbeDetail, runStartupInitializationProbe } from "../app/startup-probe.js";
+import { readConfigStatus, resolveLarkAppSecret, SecurityCliSecretStore } from "../config/index.js";
+import { LARK_REQUIRED_SCOPES, LarkBotDirectory, LarkOpenApiClient, resolveLarkEndpoints, TenantAccessTokenManager } from "../lark/index.js";
+import { isTwinnyLockHeld, readTwinnyLockMetadata } from "../lock/index.js";
+import { openRuntimeDatabase } from "../store/index.js";
+import { toErrorMessage } from "../errors.js";
+export async function runDoctorCommand() {
+    const snapshot = await runDoctorChecks();
+    for (const check of snapshot.checks) {
+        const marker = check.ok ? "OK" : "FAIL";
+        console.log(`${marker} ${check.name}${check.detail ? ` - ${check.detail}` : ""}`);
+    }
+    if (!snapshot.ok) {
+        process.exitCode = 1;
+    }
+}
+export async function runDoctorChecks() {
+    const checks = [];
+    const configStatus = await readConfigStatus();
+    checks.push({
+        name: "config",
+        ok: configStatus.complete,
+        detail: configStatus.complete ? configStatus.paths.configFile : configStatus.issues.join("; ")
+    });
+    if (!configStatus.config) {
+        return { ok: false, checks };
+    }
+    const config = configStatus.config;
+    const secretStore = new SecurityCliSecretStore();
+    let appSecret;
+    await checkAsync(checks, "lark app_secret", async () => {
+        const secret = await resolveDoctorLarkAppSecret(config.homeIdentity.keychainAccounts.larkAppSecret, secretStore);
+        appSecret = secret.value;
+        return secret.detail;
+    });
+    await checkAsync(checks, "codex binary", async () => {
+        const result = await execa(config.codex.binary, ["--version"], { reject: false });
+        if (result.exitCode !== 0) {
+            throw new Error(result.stderr || `exit ${result.exitCode}`);
+        }
+        return result.stdout.trim();
+    });
+    await checkAsync(checks, "caffeinate binary", async () => {
+        return checkCaffeinateBinary();
+    });
+    await checkAsync(checks, "sqlite", async () => {
+        const db = openRuntimeDatabase(configStatus.paths);
+        db.close();
+        return configStatus.paths.sqliteFile;
+    });
+    await checkAsync(checks, "startup initialization", async () => {
+        return formatStartupInitializationProbeDetail(await runStartupInitializationProbe({
+            config,
+            paths: configStatus.paths
+        }));
+    });
+    await checkAsync(checks, "singleton lock", async () => {
+        const held = await isTwinnyLockHeld(configStatus.paths);
+        if (!held) {
+            return "not running";
+        }
+        const metadata = await readTwinnyLockMetadata(configStatus.paths);
+        return metadata ? `held by pid ${metadata.pid}` : "held";
+    });
+    const resolvedAppSecret = appSecret;
+    if (resolvedAppSecret) {
+        await checkAsync(checks, "lark tenant token", async () => {
+            const manager = new TenantAccessTokenManager({
+                appId: config.auth.larkAppId,
+                appSecret: resolvedAppSecret,
+                baseUrl: resolveLarkEndpoints(config.auth.larkBrand).openApi
+            });
+            await manager.getTenantAccessToken();
+            return "reachable";
+        });
+        await checkAsync(checks, "lark bot open_id", async () => {
+            return checkLarkBotOpenId(config, resolvedAppSecret);
+        });
+        await checkAsync(checks, "lark required scopes", async () => {
+            return checkLarkRequiredScopes(config, resolvedAppSecret);
+        });
+    }
+    return {
+        ok: checks.every((check) => check.ok),
+        checks
+    };
+}
+export async function checkCaffeinateBinary(options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform !== "darwin") {
+        return `not required on ${platform}`;
+    }
+    const command = options.command ?? DEFAULT_CAFFEINATE_COMMAND;
+    await (options.access ?? fs.access)(command, fsConstants.X_OK);
+    return command;
+}
+export async function checkLarkBotOpenId(config, appSecret, options = {}) {
+    const botDirectory = options.botDirectory ?? (() => {
+        const tokenManager = options.tokenManager ?? new TenantAccessTokenManager({
+            appId: config.auth.larkAppId,
+            appSecret,
+            baseUrl: resolveLarkEndpoints(config.auth.larkBrand).openApi
+        });
+        const openApiClient = options.openApiClient ?? new LarkOpenApiClient({
+            tokenManager,
+            baseUrl: resolveLarkEndpoints(config.auth.larkBrand).openApi
+        });
+        return new LarkBotDirectory({ openApiClient });
+    })();
+    const botOpenId = await botDirectory.getBotOpenId();
+    if (!botOpenId) {
+        throw new Error("missing bot open_id");
+    }
+    return botOpenId;
+}
+export async function checkLarkRequiredScopes(config, appSecret, options = {}) {
+    const openApiClient = options.openApiClient ?? (() => {
+        const tokenManager = options.tokenManager ?? new TenantAccessTokenManager({
+            appId: config.auth.larkAppId,
+            appSecret,
+            baseUrl: resolveLarkEndpoints(config.auth.larkBrand).openApi
+        });
+        return new LarkOpenApiClient({
+            tokenManager,
+            baseUrl: resolveLarkEndpoints(config.auth.larkBrand).openApi
+        });
+    })();
+    const requiredScopes = options.requiredScopes ?? LARK_REQUIRED_SCOPES;
+    const grantedScopes = await getGrantedLarkScopes(openApiClient);
+    const missingScopes = requiredScopes.filter((scope) => !grantedScopes.has(scope));
+    if (missingScopes.length > 0) {
+        throw new Error(`missing: ${missingScopes.join(", ")}`);
+    }
+    return `${requiredScopes.length} required scopes granted`;
+}
+export async function resolveDoctorLarkAppSecret(account, secretStore) {
+    const value = await resolveLarkAppSecret(account, secretStore);
+    if (!value) {
+        throw new Error(`missing keychain:${account}`);
+    }
+    return {
+        value,
+        detail: "present"
+    };
+}
+async function checkAsync(checks, name, run) {
+    try {
+        const result = await run();
+        checks.push({
+            name,
+            ok: true,
+            detail: typeof result === "string" ? result : undefined
+        });
+        return result;
+    }
+    catch (error) {
+        checks.push({
+            name,
+            ok: false,
+            detail: toErrorMessage(error)
+        });
+        return undefined;
+    }
+}
+async function getGrantedLarkScopes(openApiClient) {
+    const raw = await openApiClient.request("/application/v6/scopes", { method: "GET" });
+    const scopes = asRecord(asRecord(raw).data).scopes;
+    if (!Array.isArray(scopes)) {
+        throw new Error("invalid Lark scope response");
+    }
+    const granted = new Set();
+    for (const item of scopes) {
+        const scope = asRecord(item);
+        if (typeof scope.scope_name === "string" && scope.grant_status === 1) {
+            granted.add(scope.scope_name);
+        }
+    }
+    return granted;
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+//# sourceMappingURL=health.js.map

package/dist/observability/health.js.map

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

package/dist/observability/logs.d.ts

@@ -0,0 +1,10 @@
+import pino, { type Logger } from "pino";
+import type { LarkSdkLogger } from "../lark/types.js";
+export interface LoggerOptions {
+    level?: string;
+    logFile?: string;
+    pretty?: boolean;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+export declare function createLarkSdkLogger(logger: Pick<Logger, "trace" | "debug" | "info" | "warn" | "error">): LarkSdkLogger;
+export declare const logger: pino.Logger;

package/dist/observability/logs.js

@@ -0,0 +1,34 @@
+import fs from "node:fs";
+import path from "node:path";
+import pino from "pino";
+export function createLogger(options = {}) {
+    const level = options.level ?? process.env.TWINNY_LOG_LEVEL ?? "info";
+    if (options.logFile) {
+        fs.mkdirSync(path.dirname(options.logFile), { recursive: true });
+        return pino({ level }, pino.destination({ dest: options.logFile, sync: false }));
+    }
+    if (options.pretty ?? process.stdout.isTTY) {
+        return pino({
+            level,
+            transport: {
+                target: "pino-pretty",
+                options: { colorize: true, translateTime: "SYS:standard" }
+            }
+        });
+    }
+    return pino({ level });
+}
+export function createLarkSdkLogger(logger) {
+    return {
+        trace: (...args) => logger.trace({ args: normalizeExternalLoggerArgs(args) }, "lark sdk trace"),
+        debug: (...args) => logger.debug({ args: normalizeExternalLoggerArgs(args) }, "lark sdk debug"),
+        info: (...args) => logger.info({ args: normalizeExternalLoggerArgs(args) }, "lark sdk info"),
+        warn: (...args) => logger.warn({ args: normalizeExternalLoggerArgs(args) }, "lark sdk warn"),
+        error: (...args) => logger.error({ args: normalizeExternalLoggerArgs(args) }, "lark sdk error")
+    };
+}
+function normalizeExternalLoggerArgs(args) {
+    return args.length === 1 ? args[0] : args;
+}
+export const logger = createLogger();
+//# sourceMappingURL=logs.js.map

package/dist/observability/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/observability/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAqB,MAAM,MAAM,CAAC;AASzC,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC;IACtE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;YACV,KAAK;YACL,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE;aAC3D;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAmE;IACrG,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC;QAC/F,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC;QAC/F,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC;QAC5F,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC;QAC5F,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC;KAChG,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAe;IAClD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/dist/observability/system-notifications.d.ts

@@ -0,0 +1,25 @@
+import { type LarkCardJson } from "../lark/cards.js";
+import type { LarkLogger } from "../lark/index.js";
+export interface SystemNotificationSender {
+    sendInteractiveCardToOpenId(openId: string, card: LarkCardJson, options?: {
+        signal?: AbortSignal;
+        uuid?: string;
+    }): Promise<unknown>;
+}
+export interface TwinnySystemNotifierOptions {
+    ownerOpenId: string;
+    sender: SystemNotificationSender;
+    logger?: LarkLogger;
+    timeoutMs?: number;
+}
+export declare class TwinnySystemNotifier {
+    private readonly ownerOpenId;
+    private readonly sender;
+    private readonly logger?;
+    private readonly timeoutMs;
+    constructor(options: TwinnySystemNotifierOptions);
+    notifyInitialized(options?: {
+        bannerImageKey?: string;
+    }): Promise<void>;
+    private sendCard;
+}

package/dist/observability/system-notifications.js

@@ -0,0 +1,33 @@
+import { toErrorMessage } from "../errors.js";
+import { renderTwinnyBannerCard } from "../lark/cards.js";
+import { TWINNY_VERSION } from "../version.js";
+const DEFAULT_NOTIFICATION_TIMEOUT_MS = 5_000;
+export class TwinnySystemNotifier {
+    ownerOpenId;
+    sender;
+    logger;
+    timeoutMs;
+    constructor(options) {
+        this.ownerOpenId = options.ownerOpenId;
+        this.sender = options.sender;
+        this.logger = options.logger;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_NOTIFICATION_TIMEOUT_MS;
+    }
+    async notifyInitialized(options = {}) {
+        await this.sendCard("initialized", renderTwinnyBannerCard({ bannerImageKey: options.bannerImageKey, twinnyVersion: TWINNY_VERSION }));
+    }
+    async sendCard(kind, card) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            await this.sender.sendInteractiveCardToOpenId(this.ownerOpenId, card, { signal: controller.signal });
+        }
+        catch (error) {
+            this.logger?.warn?.({ kind, error: toErrorMessage(error) }, "failed to send Twinny system notification");
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=system-notifications.js.map

package/dist/observability/system-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-notifications.js","sourceRoot":"","sources":["../../src/observability/system-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAqB,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,+BAA+B,GAAG,KAAK,CAAC;AAa9C,MAAM,OAAO,oBAAoB;IACd,WAAW,CAAS;IACpB,MAAM,CAA2B;IACjC,MAAM,CAAc;IACpB,SAAS,CAAS;IAEnC,YAAY,OAAoC;QAC9C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAAuC,EAAE;QAC/D,MAAM,IAAI,CAAC,QAAQ,CACjB,aAAa,EACb,sBAAsB,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAClG,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAAkB;QACrD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACvG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,2CAA2C,CAAC,CAAC;QAC3G,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}