docs-combiner 0.2.2 → 1.0.0

package/dist/server/driveProxy.js

@@ -0,0 +1,220 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxyDriveList = proxyDriveList;
+exports.proxyDriveMetadata = proxyDriveMetadata;
+exports.proxyDriveDownload = proxyDriveDownload;
+exports.proxyDriveCreateFolder = proxyDriveCreateFolder;
+exports.proxyDriveMultipartUpload = proxyDriveMultipartUpload;
+exports.proxyDriveMediaUpdate = proxyDriveMediaUpdate;
+exports.proxyDriveDelete = proxyDriveDelete;
+exports.proxyDrivePermission = proxyDrivePermission;
+const driveApi_1 = require("../integrations/driveApi");
+const httpTimeout_1 = require("../integrations/httpTimeout");
+const googleAuth_1 = require("./googleAuth");
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function badRequest(message) {
+    const err = new Error(message);
+    err.status = 400;
+    return err;
+}
+function responseJsonOrText(response) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const text = yield response.text();
+        if (!text.trim())
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch (_a) {
+            return { text };
+        }
+    });
+}
+function normalizeBool(value) {
+    return value === true || value === 'true';
+}
+function normalizePart(raw) {
+    if (!isPlainObject(raw))
+        throw badRequest('Invalid multipart part.');
+    const name = typeof raw.name === 'string' ? raw.name.trim() : '';
+    if (!name)
+        throw badRequest('Multipart part name is required.');
+    return {
+        name,
+        filename: typeof raw.filename === 'string' && raw.filename.trim() ? raw.filename.trim() : undefined,
+        contentType: typeof raw.contentType === 'string' && raw.contentType.trim() ? raw.contentType.trim() : undefined,
+        text: typeof raw.text === 'string' ? raw.text : undefined,
+        base64: typeof raw.base64 === 'string' ? raw.base64 : undefined,
+    };
+}
+function buildFormData(parts) {
+    var _a;
+    const form = new FormData();
+    for (const part of parts) {
+        const bytes = part.base64 !== undefined
+            ? Buffer.from(part.base64, 'base64')
+            : Buffer.from((_a = part.text) !== null && _a !== void 0 ? _a : '', 'utf8');
+        const blob = new Blob([bytes], { type: part.contentType || 'application/octet-stream' });
+        if (part.filename)
+            form.append(part.name, blob, part.filename);
+        else
+            form.append(part.name, blob);
+    }
+    return form;
+}
+function proxyDriveList(store, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isPlainObject(body))
+            throw badRequest('JSON object payload is required.');
+        const q = typeof body.q === 'string' ? body.q : '';
+        const fields = typeof body.fields === 'string' ? body.fields : '';
+        if (!q || !fields)
+            throw badRequest('q and fields are required.');
+        const supportsAllDrives = normalizeBool(body.supportsAllDrives);
+        const pageSize = Number(body.pageSize);
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveListFiles)(token, q, fields, {
+                supportsAllDrives,
+                pageSize: Number.isFinite(pageSize) && pageSize > 0 ? pageSize : undefined,
+            });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDriveMetadata(store, fileId, query) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cleanFileId = fileId.trim();
+        const fields = typeof query.fields === 'string' ? query.fields : '';
+        if (!cleanFileId || !fields)
+            throw badRequest('fileId and fields are required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveGetFileMetadata)(token, cleanFileId, fields, {
+                supportsAllDrives: normalizeBool(query.supportsAllDrives),
+            });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDriveDownload(store, fileId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cleanFileId = fileId.trim();
+        if (!cleanFileId)
+            throw badRequest('fileId is required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveDownloadFile)(token, cleanFileId);
+            const arrayBuffer = yield response.arrayBuffer();
+            return {
+                status: response.status,
+                value: {
+                    contentType: response.headers.get('content-type') || 'application/octet-stream',
+                    base64: Buffer.from(arrayBuffer).toString('base64'),
+                },
+            };
+        }));
+    });
+}
+function proxyDriveCreateFolder(store, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isPlainObject(body))
+            throw badRequest('JSON object payload is required.');
+        const folderName = typeof body.folderName === 'string' ? body.folderName.trim() : '';
+        const parentFolderId = typeof body.parentFolderId === 'string' ? body.parentFolderId.trim() : '';
+        if (!folderName || !parentFolderId)
+            throw badRequest('folderName and parentFolderId are required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveCreateFolderRequest)(token, folderName, parentFolderId);
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDriveMultipartUpload(store, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isPlainObject(body))
+            throw badRequest('JSON object payload is required.');
+        const parts = Array.isArray(body.parts) ? body.parts.map(normalizePart) : [];
+        if (parts.length === 0)
+            throw badRequest('parts array is required.');
+        const existingFileId = typeof body.existingFileId === 'string' && body.existingFileId.trim()
+            ? body.existingFileId.trim()
+            : '';
+        const supportsAllDrives = normalizeBool(body.supportsAllDrives);
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const suffix = supportsAllDrives ? '&supportsAllDrives=true' : '';
+            const url = existingFileId
+                ? `${driveApi_1.DRIVE_UPLOAD_FILES_URL}/${encodeURIComponent(existingFileId)}?uploadType=multipart${suffix}`
+                : `${driveApi_1.DRIVE_UPLOAD_FILES_URL}?uploadType=multipart${suffix}`;
+            const response = yield (0, httpTimeout_1.fetchWithTimeout)(url, {
+                method: existingFileId ? 'PATCH' : 'POST',
+                headers: { Authorization: `Bearer ${token}` },
+                body: buildFormData(parts),
+            }, { timeoutMs: httpTimeout_1.UPLOAD_NETWORK_TIMEOUT_MS });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDriveMediaUpdate(store, fileId, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isPlainObject(body))
+            throw badRequest('JSON object payload is required.');
+        const cleanFileId = fileId.trim();
+        const contentType = typeof body.contentType === 'string' && body.contentType.trim()
+            ? body.contentType.trim()
+            : 'application/octet-stream';
+        const fields = typeof body.fields === 'string' && body.fields.trim() ? body.fields.trim() : '';
+        const bytes = typeof body.base64 === 'string'
+            ? Buffer.from(body.base64, 'base64')
+            : Buffer.from(typeof body.text === 'string' ? body.text : '', 'utf8');
+        if (!cleanFileId)
+            throw badRequest('fileId is required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const fieldsSuffix = fields ? `&fields=${encodeURIComponent(fields)}` : '';
+            const response = yield (0, httpTimeout_1.fetchWithTimeout)(`${driveApi_1.DRIVE_UPLOAD_FILES_URL}/${encodeURIComponent(cleanFileId)}?uploadType=media${fieldsSuffix}`, {
+                method: 'PATCH',
+                headers: { Authorization: `Bearer ${token}`, 'Content-Type': contentType },
+                body: bytes,
+            }, { timeoutMs: httpTimeout_1.UPLOAD_NETWORK_TIMEOUT_MS });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDriveDelete(store, fileId, query) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cleanFileId = fileId.trim();
+        if (!cleanFileId)
+            throw badRequest('fileId is required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveDeleteFileRequest)(token, cleanFileId, {
+                supportsAllDrives: normalizeBool(query.supportsAllDrives),
+            });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}
+function proxyDrivePermission(store, fileId, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isPlainObject(body))
+            throw badRequest('JSON object payload is required.');
+        const cleanFileId = fileId.trim();
+        const role = typeof body.role === 'string' ? body.role.trim() : '';
+        const type = typeof body.type === 'string' ? body.type.trim() : '';
+        if (!cleanFileId || !role || !type)
+            throw badRequest('fileId, role and type are required.');
+        return (0, googleAuth_1.withGoogleAccessTokenRetry)(store, (token) => __awaiter(this, void 0, void 0, function* () {
+            const response = yield (0, driveApi_1.driveCreatePermissionRequest)(token, cleanFileId, { role, type }, {
+                supportsAllDrives: normalizeBool(body.supportsAllDrives),
+            });
+            return { status: response.status, value: yield responseJsonOrText(response) };
+        }));
+    });
+}

package/dist/server/flexcardMeta.js

@@ -0,0 +1,29 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFlexCardBalance = getFlexCardBalance;
+const flexcardBalance_1 = require("../flexcardBalance");
+function badRequest(message) {
+    const err = new Error(message);
+    err.status = 400;
+    return err;
+}
+function getFlexCardBalance(store) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const config = yield store.readConfig();
+        const apiKey = (_a = config.flexcardApiKey) === null || _a === void 0 ? void 0 : _a.trim();
+        if (!apiKey)
+            throw badRequest('flexcardApiKey is not configured on the server.');
+        const usdTotal = yield (0, flexcardBalance_1.fetchFlexCardFinanceAccountsUsdTotal)(apiKey);
+        return { ok: true, usdTotal };
+    });
+}

package/dist/server/googleAuth.js

@@ -0,0 +1,84 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshServerGoogleAccessToken = refreshServerGoogleAccessToken;
+exports.getServerGoogleAccessToken = getServerGoogleAccessToken;
+exports.withGoogleAccessTokenRetry = withGoogleAccessTokenRetry;
+const driveApi_1 = require("../integrations/driveApi");
+function refreshServerGoogleAccessToken(store) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        const config = yield store.readConfig();
+        const clientId = (_a = config.clientId) === null || _a === void 0 ? void 0 : _a.trim();
+        const clientSecret = (_b = config.clientSecret) === null || _b === void 0 ? void 0 : _b.trim();
+        const refreshToken = (_c = config.refreshToken) === null || _c === void 0 ? void 0 : _c.trim();
+        if (!clientId || !clientSecret || !refreshToken)
+            return null;
+        const response = yield (0, driveApi_1.googleOAuthTokenRequest)({
+            client_id: clientId,
+            client_secret: clientSecret,
+            refresh_token: refreshToken,
+            grant_type: 'refresh_token',
+        });
+        if (!response.ok) {
+            yield store.patchSecrets({ accessToken: '' });
+            return null;
+        }
+        const data = yield response.json();
+        const accessToken = typeof (data === null || data === void 0 ? void 0 : data.access_token) === 'string' ? data.access_token : '';
+        if (!accessToken) {
+            yield store.patchSecrets({ accessToken: '' });
+            return null;
+        }
+        yield store.patchSecrets({
+            accessToken,
+            refreshToken: typeof (data === null || data === void 0 ? void 0 : data.refresh_token) === 'string' && data.refresh_token ? data.refresh_token : refreshToken,
+        });
+        return accessToken;
+    });
+}
+function getServerGoogleAccessToken(store) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const config = yield store.readConfig();
+        const accessToken = (_a = config.accessToken) === null || _a === void 0 ? void 0 : _a.trim();
+        if (accessToken)
+            return accessToken;
+        return refreshServerGoogleAccessToken(store);
+    });
+}
+function withGoogleAccessTokenRetry(store, fn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const token = yield getServerGoogleAccessToken(store);
+        if (!token) {
+            const err = new Error('Google OAuth secrets are not configured on the server.');
+            err.status = 400;
+            throw err;
+        }
+        let first;
+        try {
+            first = yield fn(token);
+        }
+        catch (err) {
+            if ((err === null || err === void 0 ? void 0 : err.status) !== 401)
+                throw err;
+            first = { status: 401, value: undefined };
+        }
+        if (first.status !== 401) {
+            return first;
+        }
+        const refreshed = yield refreshServerGoogleAccessToken(store);
+        if (!refreshed) {
+            throw new Error('Google access token expired and refresh failed. Run Google login and sync secrets to the VPS.');
+        }
+        return fn(refreshed);
+    });
+}

package/dist/server/imageAssets.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultServerImageAssetStore = exports.ServerImageAssetStore = void 0;
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_MAX_ASSETS = 5000;
+const DEFAULT_MAX_BYTES = 1024 * 1024 * 1024;
+function randomAssetId() {
+    return `asset_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 12)}`;
+}
+class ServerImageAssetStore {
+    constructor(options = {}) {
+        var _a, _b, _c, _d, _e;
+        this.assets = new Map();
+        this.totalBytes = 0;
+        this.ttlMs = (_a = options.ttlMs) !== null && _a !== void 0 ? _a : DEFAULT_TTL_MS;
+        this.maxAssets = (_b = options.maxAssets) !== null && _b !== void 0 ? _b : DEFAULT_MAX_ASSETS;
+        this.maxBytes = (_c = options.maxBytes) !== null && _c !== void 0 ? _c : DEFAULT_MAX_BYTES;
+        this.now = (_d = options.now) !== null && _d !== void 0 ? _d : (() => new Date());
+        this.idFactory = (_e = options.idFactory) !== null && _e !== void 0 ? _e : randomAssetId;
+    }
+    put(imageDataUrl, metadata = {}) {
+        this.cleanupExpired();
+        const now = this.now();
+        const bytes = Buffer.byteLength(imageDataUrl, 'utf8');
+        const asset = {
+            id: this.idFactory(),
+            imageDataUrl,
+            bytes,
+            createdAt: now.toISOString(),
+            lastAccessedAt: now.toISOString(),
+            expiresAt: new Date(now.getTime() + this.ttlMs).toISOString(),
+            metadata,
+        };
+        this.delete(asset.id);
+        this.assets.set(asset.id, asset);
+        this.totalBytes += bytes;
+        this.enforceLimits();
+        return asset;
+    }
+    get(assetId) {
+        this.cleanupExpired();
+        const asset = this.assets.get(assetId);
+        if (!asset)
+            return null;
+        const now = this.now();
+        asset.lastAccessedAt = now.toISOString();
+        asset.expiresAt = new Date(now.getTime() + this.ttlMs).toISOString();
+        return Object.assign(Object.assign({}, asset), { metadata: Object.assign({}, asset.metadata) });
+    }
+    delete(assetId) {
+        const asset = this.assets.get(assetId);
+        if (!asset)
+            return false;
+        this.assets.delete(assetId);
+        this.totalBytes -= asset.bytes;
+        return true;
+    }
+    stats() {
+        this.cleanupExpired();
+        return {
+            count: this.assets.size,
+            bytes: this.totalBytes,
+            maxAssets: this.maxAssets,
+            maxBytes: this.maxBytes,
+            ttlMs: this.ttlMs,
+        };
+    }
+    cleanupExpired() {
+        const nowMs = this.now().getTime();
+        for (const [assetId, asset] of this.assets.entries()) {
+            if (new Date(asset.expiresAt).getTime() <= nowMs) {
+                this.assets.delete(assetId);
+                this.totalBytes -= asset.bytes;
+            }
+        }
+    }
+    enforceLimits() {
+        while (this.assets.size > this.maxAssets || this.totalBytes > this.maxBytes) {
+            const oldest = [...this.assets.values()].sort((a, b) => a.lastAccessedAt.localeCompare(b.lastAccessedAt) || a.createdAt.localeCompare(b.createdAt))[0];
+            if (!oldest)
+                return;
+            this.delete(oldest.id);
+        }
+    }
+}
+exports.ServerImageAssetStore = ServerImageAssetStore;
+exports.defaultServerImageAssetStore = new ServerImageAssetStore();