@struktoai/mirage-core/dist/core/discord/paginate.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
export async function* afterIdPages(accessor, opts) {
    const { endpoint, baseParams = {}, lastIdFn, pageSize = 100, startAfter = '0', newestFirst = false, } = opts;
    let last = startAfter;
    for (;;) {
        const params = { ...baseParams, after: last, limit: pageSize };
        const data = (await accessor.transport.call('GET', endpoint, params));
        if (!Array.isArray(data) || data.length === 0)
            return;
        yield data;
        if (data.length < pageSize)
            return;
        // The cursor is the newest id in the page, which is the first item on a
        // newest-first endpoint (messages) and the last one elsewhere.
        const cursor = newestFirst ? data[0] : data[data.length - 1];
        if (cursor === undefined)
            return;
        last = lastIdFn(cursor);
    }
}
function getNested(obj, path) {
    let cur = obj;
    for (const key of path) {
        if (cur === null || typeof cur !== 'object')
            return null;
        cur = cur[key];
    }
    return cur;
}
export async function* offsetPages(accessor, opts) {
    const { endpoint, baseParams = {}, itemsPath, totalKey = 'total_results', pageSize = 25, startOffset = 0, maxPages, } = opts;
    let offset = startOffset;
    let total = null;
    let fetched = 0;
    for (;;) {
        const params = { ...baseParams, offset };
        const data = (await accessor.transport.call('GET', endpoint, params));
        if (data === null || typeof data !== 'object')
            return;
        const items = getNested(data, itemsPath) ?? [];
        if (items.length === 0)
            return;
        yield items;
        fetched += 1;
        if (total === null) {
            const t = data[totalKey];
            total = typeof t === 'number' ? t : 0;
        }
        offset += pageSize;
        if (offset >= total)
            return;
        if (maxPages !== undefined && fetched >= maxPages)
            return;
    }
}
//# sourceMappingURL=paginate.js.map