@sireai/optimus 0.1.8 → 0.1.9

package/dist/integrations/feishu/feishu-auth-store.js

@@ -0,0 +1,113 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { resolveOptimusHomeDir } from "../../config/optimus-paths.js";
+export function resolveDefaultFeishuAuthPath() {
+    return join(resolveOptimusHomeDir(), "auth", "feishu.json");
+}
+export class FileFeishuAuthStore {
+    filePath;
+    constructor(filePath = resolveDefaultFeishuAuthPath()) {
+        this.filePath = filePath;
+    }
+    async read() {
+        try {
+            return normalizeAuthRecord(JSON.parse(await readFile(this.filePath, "utf8")));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    readSync() {
+        return readFeishuAuthRecordSync(this.filePath);
+    }
+    async write(record) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await writeFile(this.filePath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+        try {
+            chmodSync(this.filePath, 0o600);
+        }
+        catch {
+            // chmod is best-effort.
+        }
+    }
+    async clear() {
+        await rm(this.filePath, { force: true });
+    }
+}
+export function readFeishuAuthRecordSync(filePath = resolveDefaultFeishuAuthPath()) {
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return normalizeAuthRecord(JSON.parse(readFileSync(filePath, "utf8")));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeFeishuAuthRecordSync(record, filePath = resolveDefaultFeishuAuthPath()) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+    try {
+        chmodSync(filePath, 0o600);
+    }
+    catch {
+        // chmod is best-effort.
+    }
+}
+export function isFeishuAccessTokenExpired(record, nowMs = Date.now()) {
+    return nowMs >= record.expiresAtMs - 60_000;
+}
+export function isFeishuRefreshTokenExpired(record, nowMs = Date.now()) {
+    return nowMs >= record.refreshExpiresAtMs - 60_000;
+}
+function normalizeAuthRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const record = value;
+    const accessToken = readString(record, ["accessToken", "access_token"]);
+    const refreshToken = readString(record, ["refreshToken", "refresh_token"]);
+    const expiresAtMs = readTimestampMs(record, ["expiresAtMs", "expires_at"], "seconds");
+    const refreshExpiresAtMs = readTimestampMs(record, ["refreshExpiresAtMs", "refresh_expires_at"], "seconds");
+    if (!accessToken || !refreshToken || !Number.isFinite(expiresAtMs) || !Number.isFinite(refreshExpiresAtMs)) {
+        return undefined;
+    }
+    const openId = readString(record, ["openId", "open_id"]);
+    const tenantKey = readString(record, ["tenantKey", "tenant_key"]);
+    const userId = readString(record, ["userId", "user_id"]);
+    const baseUrl = readString(record, ["baseUrl", "base_url"]);
+    return {
+        accessToken,
+        refreshToken,
+        expiresAtMs,
+        refreshExpiresAtMs,
+        ...(openId ? { openId } : {}),
+        ...(tenantKey ? { tenantKey } : {}),
+        ...(userId ? { userId } : {}),
+        ...(baseUrl ? { baseUrl } : {})
+    };
+}
+function readString(record, keys) {
+    for (const key of keys) {
+        const raw = record[key];
+        if (typeof raw === "string" && raw.trim()) {
+            return raw.trim();
+        }
+    }
+    return undefined;
+}
+function readTimestampMs(record, keys, snakeCaseUnit) {
+    for (const key of keys) {
+        const raw = record[key];
+        const parsed = typeof raw === "number" ? raw : typeof raw === "string" ? Number(raw) : Number.NaN;
+        if (!Number.isFinite(parsed)) {
+            continue;
+        }
+        const shouldTreatAsSeconds = key.includes("_") && snakeCaseUnit === "seconds";
+        return shouldTreatAsSeconds ? parsed * 1000 : parsed;
+    }
+    return Number.NaN;
+}
+//# sourceMappingURL=feishu-auth-store.js.map

package/dist/integrations/feishu/feishu-auth-store.js.map

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

package/dist/integrations/feishu/feishu-client.d.ts

@@ -0,0 +1,52 @@
+import type { OptimusConfig } from "../../types.js";
+import { FeishuAuthService, type FeishuAuthServiceOptions } from "./feishu-auth-service.js";
+import { type FeishuTokenStore } from "./feishu-token-store.js";
+export declare class FeishuIntegrationError extends Error {
+    readonly diagnostics: {
+        category: "config_missing" | "auth_failed" | "request_failed";
+        status?: number;
+        code?: number;
+        detail?: string;
+    };
+    constructor(message: string, diagnostics: {
+        category: "config_missing" | "auth_failed" | "request_failed";
+        status?: number;
+        code?: number;
+        detail?: string;
+    });
+}
+export interface FeishuClientOptions {
+    config?: Pick<OptimusConfig, "delivery">;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: typeof globalThis.fetch;
+    tokenStore?: FeishuTokenStore;
+    authService?: Pick<FeishuAuthService, "getValidAccessToken" | "recoverExpiredAuth" | "readStatus">;
+    authServiceOptions?: Omit<FeishuAuthServiceOptions, "env" | "fetchImpl">;
+}
+export declare class FeishuClient {
+    private readonly env;
+    private readonly fetchImpl;
+    private readonly tokenStore;
+    private readonly authService;
+    private readonly baseUrl;
+    private readonly appId;
+    private readonly appSecret;
+    constructor(options?: FeishuClientOptions);
+    isConfigured(): boolean;
+    get<T>(path: string, query?: Record<string, string | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown, query?: Record<string, string | undefined>): Promise<T>;
+    patch<T>(path: string, body?: unknown, query?: Record<string, string | undefined>): Promise<T>;
+    private request;
+    private getTenantAccessToken;
+    private getAccessToken;
+    private buildUrl;
+    private readResponsePayload;
+    private payloadHasError;
+    private extractCode;
+    private isAuthExpired;
+    private readString;
+    private readNumber;
+    private readConfiguredValue;
+    private normalizeBaseUrl;
+    private compact;
+}

package/dist/integrations/feishu/feishu-client.js

@@ -0,0 +1,217 @@
+import { FeishuAuthService } from "./feishu-auth-service.js";
+import { FileFeishuTokenStore } from "./feishu-token-store.js";
+const DEFAULT_FEISHU_BASE_URL = "https://open.feishu.cn";
+const TENANT_TOKEN_SKEW_MS = 5 * 60 * 1000;
+export class FeishuIntegrationError extends Error {
+    diagnostics;
+    constructor(message, diagnostics) {
+        super(message);
+        this.diagnostics = diagnostics;
+        this.name = "FeishuIntegrationError";
+    }
+}
+export class FeishuClient {
+    env;
+    fetchImpl;
+    tokenStore;
+    authService;
+    baseUrl;
+    appId;
+    appSecret;
+    constructor(options = {}) {
+        this.env = options.env ?? process.env;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch?.bind(globalThis);
+        this.tokenStore = options.tokenStore ?? new FileFeishuTokenStore();
+        this.authService = options.authService ?? new FeishuAuthService({
+            env: this.env,
+            fetchImpl: this.fetchImpl,
+            ...(options.authServiceOptions ?? {})
+        });
+        const feishuConfig = options.config?.delivery.feishu;
+        this.baseUrl = this.normalizeBaseUrl(feishuConfig?.baseUrl ?? this.env.FEISHU_BASE_URL ?? DEFAULT_FEISHU_BASE_URL);
+        this.appId = this.readConfiguredValue(feishuConfig?.appId, this.env.FEISHU_APP_ID);
+        this.appSecret = this.readConfiguredValue(feishuConfig?.appSecret, this.env.FEISHU_APP_SECRET);
+    }
+    isConfigured() {
+        return this.authService.readStatus().authenticated || Boolean(this.appId && this.appSecret);
+    }
+    async get(path, query) {
+        return await this.request("GET", path, undefined, query);
+    }
+    async post(path, body, query) {
+        return await this.request("POST", path, body, query);
+    }
+    async patch(path, body, query) {
+        return await this.request("PATCH", path, body, query);
+    }
+    async request(method, path, body, query, retryAfterAuthRefresh = true) {
+        const token = await this.getAccessToken();
+        const response = await this.fetchImpl(this.buildUrl(path, query), {
+            method,
+            headers: {
+                authorization: `Bearer ${token}`,
+                "content-type": "application/json; charset=utf-8"
+            },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) })
+        });
+        const payload = await this.readResponsePayload(response);
+        if (response.ok && !this.payloadHasError(payload)) {
+            return payload;
+        }
+        const code = this.extractCode(payload);
+        if (retryAfterAuthRefresh && this.isAuthExpired(response.status, code, payload)) {
+            await this.tokenStore.clearTenantToken().catch(() => undefined);
+            await this.authService.recoverExpiredAuth?.("request_auth_expired").catch(() => undefined);
+            return await this.request(method, path, body, query, false);
+        }
+        throw new FeishuIntegrationError("Feishu API request failed.", {
+            category: response.status === 401 || response.status === 403 ? "auth_failed" : "request_failed",
+            status: response.status,
+            ...(code !== undefined ? { code } : {}),
+            detail: this.compact(JSON.stringify(payload))
+        });
+    }
+    async getTenantAccessToken() {
+        if (!this.fetchImpl) {
+            throw new FeishuIntegrationError("Feishu integration requires global fetch.", { category: "request_failed" });
+        }
+        if (!this.appId || !this.appSecret) {
+            throw new FeishuIntegrationError("Feishu auth is not ready. Run `optimus feishu auth login`.", {
+                category: "config_missing"
+            });
+        }
+        const cached = await this.tokenStore.readTenantToken();
+        if (cached?.tenantAccessToken && cached.expireAtMs > Date.now() + TENANT_TOKEN_SKEW_MS) {
+            return cached.tenantAccessToken;
+        }
+        const response = await this.fetchImpl(`${this.baseUrl}/open-apis/auth/v3/tenant_access_token/internal`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json; charset=utf-8"
+            },
+            body: JSON.stringify({
+                app_id: this.appId,
+                app_secret: this.appSecret
+            })
+        });
+        const payload = await this.readResponsePayload(response);
+        const token = this.readString(payload, ["tenant_access_token", "tenantAccessToken"]);
+        const expireSeconds = this.readNumber(payload, ["expire"]);
+        if (!response.ok || this.payloadHasError(payload) || !token) {
+            const code = this.extractCode(payload);
+            throw new FeishuIntegrationError("Feishu tenant token request failed.", {
+                category: "auth_failed",
+                status: response.status,
+                ...(code !== undefined ? { code } : {}),
+                detail: this.compact(JSON.stringify(payload))
+            });
+        }
+        await this.tokenStore.writeTenantToken({
+            tenantAccessToken: token,
+            expireAtMs: Date.now() + Math.max(60, expireSeconds ?? 7200) * 1000
+        }).catch(() => undefined);
+        return token;
+    }
+    async getAccessToken() {
+        try {
+            const authenticated = await this.authService.getValidAccessToken();
+            return authenticated.accessToken;
+        }
+        catch (error) {
+            if (this.appId && this.appSecret) {
+                return await this.getTenantAccessToken();
+            }
+            if (error instanceof Error) {
+                throw new FeishuIntegrationError(error.message, {
+                    category: /expired|failed/i.test(error.message) ? "auth_failed" : "config_missing"
+                });
+            }
+            throw error;
+        }
+    }
+    buildUrl(path, query) {
+        const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+        const url = new URL(`${this.baseUrl}${normalizedPath}`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value?.trim()) {
+                url.searchParams.set(key, value.trim());
+            }
+        }
+        return url.toString();
+    }
+    async readResponsePayload(response) {
+        const text = await response.text();
+        if (!text.trim()) {
+            return {};
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return { raw: text };
+        }
+    }
+    payloadHasError(payload) {
+        const code = this.extractCode(payload);
+        return code !== undefined && code !== 0;
+    }
+    extractCode(payload) {
+        if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+            return undefined;
+        }
+        const record = payload;
+        const raw = record.code ?? record.Code;
+        return typeof raw === "number" ? raw : typeof raw === "string" && raw.trim() ? Number(raw) : undefined;
+    }
+    isAuthExpired(status, code, payload) {
+        if (status === 401) {
+            return true;
+        }
+        const detail = JSON.stringify(payload).toLowerCase();
+        return [
+            99991663,
+            99991664,
+            99991668,
+            99991672,
+            99991673
+        ].includes(code ?? -1) || /token|auth|unauthorized|expired/.test(detail);
+    }
+    readString(value, keys) {
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            return undefined;
+        }
+        const record = value;
+        for (const key of keys) {
+            const raw = record[key];
+            if (typeof raw === "string" && raw.trim()) {
+                return raw.trim();
+            }
+        }
+        return undefined;
+    }
+    readNumber(value, keys) {
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            return undefined;
+        }
+        const record = value;
+        for (const key of keys) {
+            const raw = record[key];
+            const parsed = typeof raw === "number" ? raw : typeof raw === "string" ? Number(raw) : Number.NaN;
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
+    readConfiguredValue(configValue, envValue) {
+        const value = configValue?.trim() || envValue?.trim();
+        return value || undefined;
+    }
+    normalizeBaseUrl(value) {
+        return value.trim().replace(/\/+$/u, "");
+    }
+    compact(value) {
+        return value.replace(/\s+/gu, " ").trim().slice(0, 2000);
+    }
+}
+//# sourceMappingURL=feishu-client.js.map

package/dist/integrations/feishu/feishu-client.js.map

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

package/dist/integrations/feishu/feishu-doc-service.d.ts

@@ -0,0 +1,46 @@
+import type { OptimusConfig } from "../../types.js";
+import { FeishuClient, type FeishuClientOptions } from "./feishu-client.js";
+export interface FeishuWikiNodeRef {
+    nodeToken: string;
+    title: string;
+    spaceId?: string;
+    url?: string;
+}
+export interface FeishuCreatedDocument {
+    token: string;
+    url: string;
+    nodeToken?: string;
+    spaceId?: string;
+}
+export interface FeishuDocumentServiceOptions {
+    client?: Pick<FeishuClient, "get" | "post" | "patch" | "isConfigured">;
+    config?: Pick<OptimusConfig, "delivery">;
+    authServiceOptions?: FeishuClientOptions["authServiceOptions"];
+}
+export declare class FeishuDocumentService {
+    private readonly client;
+    constructor(options?: FeishuDocumentServiceOptions);
+    isConfigured(): boolean;
+    getWikiNode(nodeToken: string): Promise<FeishuWikiNodeRef | undefined>;
+    listWikiNodes(spaceId: string): Promise<FeishuWikiNodeRef[]>;
+    createMarkdownDocument(input: {
+        title: string;
+        markdownPath: string;
+        parentNodeToken?: string;
+    }): Promise<FeishuCreatedDocument>;
+    createEmptyDocument(title: string): Promise<FeishuCreatedDocument>;
+    private createDocument;
+    private appendMarkdown;
+    private convertMarkdown;
+    private updateTitleBestEffort;
+    private toBasicBlocks;
+    private toTextBlock;
+    private extractDocumentToken;
+    private extractDocumentUrl;
+    private extractWikiNodes;
+    private extractWikiNode;
+    private extractWikiNodeToken;
+    private extractWikiSpaceId;
+    private findArray;
+    private readString;
+}