@blaxel/core 0.2.90-dev.181 → 0.2.90-preview.182

package/dist/cjs/common/pagination.js

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.unwrapListData = unwrapListData;
-exports.createPaginatedList = createPaginatedList;
-function unwrapListData(response) {
-    if (!response) {
-        return [];
-    }
-    if (Array.isArray(response)) {
-        return response;
-    }
-    return response.data ?? [];
-}
-function unwrapListMeta(response) {
-    if (!response || Array.isArray(response)) {
-        return { hasMore: false };
-    }
-    return response.meta ?? { hasMore: false };
-}
-async function createPaginatedList({ response, fetchPage, mapItem, query, seenCursors, }) {
-    const meta = unwrapListMeta(response);
-    const data = await Promise.all(unwrapListData(response).map(mapItem));
-    const cursors = new Set(seenCursors);
-    if (query?.cursor) {
-        cursors.add(query.cursor);
-    }
-    const list = {
-        data,
-        meta,
-        get hasMore() {
-            return Boolean(meta.hasMore);
-        },
-        get nextCursor() {
-            return meta.nextCursor || undefined;
-        },
-        async nextPage() {
-            const cursor = list.nextCursor;
-            if (!cursor) {
-                return null;
-            }
-            if (cursors.has(cursor)) {
-                throw new Error("Pagination returned a repeated cursor");
-            }
-            const nextQuery = { ...(query ?? {}), cursor };
-            const nextSeenCursors = new Set(cursors);
-            nextSeenCursors.add(cursor);
-            return createPaginatedList({
-                response: await fetchPage(nextQuery),
-                fetchPage,
-                mapItem,
-                query: nextQuery,
-                seenCursors: nextSeenCursors,
-            });
-        },
-        async autoPagingEach(onItem) {
-            for await (const item of list) {
-                const shouldContinue = await onItem(item);
-                if (shouldContinue === false) {
-                    return;
-                }
-            }
-        },
-        async autoPagingToArray(options) {
-            if (!options || !Number.isFinite(options.limit) || options.limit <= 0) {
-                throw new Error("autoPagingToArray requires a positive limit");
-            }
-            const items = [];
-            for await (const item of list) {
-                items.push(item);
-                if (items.length >= options.limit) {
-                    return items;
-                }
-            }
-            return items;
-        },
-        async *[Symbol.asyncIterator]() {
-            let page = list;
-            while (page) {
-                for (const item of page.data) {
-                    yield item;
-                }
-                page = await page.nextPage();
-            }
-        },
-    };
-    return list;
-}

package/dist/cjs/common/pagination.test.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const pagination_js_1 = require("./pagination.js");
-(0, vitest_1.describe)("pagination helpers", () => {
-    (0, vitest_1.it)("unwraps legacy array and paginated list responses", () => {
-        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)([{ name: "legacy" }])).toEqual([{ name: "legacy" }]);
-        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)({
-            data: [{ name: "paginated" }],
-            meta: { hasMore: false },
-        })).toEqual([{ name: "paginated" }]);
-    });
-    (0, vitest_1.it)("returns page data and lets callers request the next page", async () => {
-        const cursors = [];
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            cursors.push(query?.cursor);
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await (0, pagination_js_1.createPaginatedList)({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item.toUpperCase(),
-        });
-        (0, vitest_1.expect)(page.data).toEqual(["FIRST"]);
-        (0, vitest_1.expect)(page.hasMore).toBe(true);
-        (0, vitest_1.expect)(page.nextCursor).toBe("next-page");
-        const nextPage = await page.nextPage();
-        (0, vitest_1.expect)(nextPage?.data).toEqual(["SECOND"]);
-        (0, vitest_1.expect)(cursors).toEqual([undefined, "next-page"]);
-    });
-    (0, vitest_1.it)("supports auto paging with an explicit limit", async () => {
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await (0, pagination_js_1.createPaginatedList)({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item,
-        });
-        await (0, vitest_1.expect)(page.autoPagingToArray({ limit: 2 })).resolves.toEqual(["first", "second"]);
-    });
-});

package/dist/cjs/types/common/pagination.d.ts

@@ -1,35 +0,0 @@
-export type PaginatedListMeta = {
-    hasMore?: boolean;
-    nextCursor?: string;
-    total?: number;
-};
-export type CursorPaginationQuery = {
-    cursor?: string;
-};
-export type ListResponse<T> = T[] | {
-    data?: T[] | null;
-    meta?: PaginatedListMeta | null;
-} | null | undefined;
-export type AutoPagingEachCallback<T> = (item: T) => boolean | void | Promise<boolean | void>;
-export type AutoPagingToArrayOptions = {
-    limit: number;
-};
-export type PaginatedList<T, TQuery extends CursorPaginationQuery = CursorPaginationQuery> = AsyncIterable<T> & {
-    data: T[];
-    meta: PaginatedListMeta;
-    hasMore: boolean;
-    nextCursor?: string;
-    nextPage(): Promise<PaginatedList<T, TQuery> | null>;
-    autoPagingEach(onItem: AutoPagingEachCallback<T>): Promise<void>;
-    autoPagingToArray(options: AutoPagingToArrayOptions): Promise<T[]>;
-};
-type CreatePaginatedListOptions<TRaw, TItem, TQuery extends CursorPaginationQuery> = {
-    response: ListResponse<TRaw>;
-    fetchPage: (query?: TQuery) => Promise<ListResponse<TRaw>>;
-    mapItem: (item: TRaw) => TItem | Promise<TItem>;
-    query?: TQuery;
-    seenCursors?: Set<string>;
-};
-export declare function unwrapListData<T>(response: ListResponse<T>): T[];
-export declare function createPaginatedList<TRaw, TItem, TQuery extends CursorPaginationQuery = CursorPaginationQuery>({ response, fetchPage, mapItem, query, seenCursors, }: CreatePaginatedListOptions<TRaw, TItem, TQuery>): Promise<PaginatedList<TItem, TQuery>>;
-export {};

package/dist/cjs/types/common/pagination.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cjs-browser/common/pagination.js

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.unwrapListData = unwrapListData;
-exports.createPaginatedList = createPaginatedList;
-function unwrapListData(response) {
-    if (!response) {
-        return [];
-    }
-    if (Array.isArray(response)) {
-        return response;
-    }
-    return response.data ?? [];
-}
-function unwrapListMeta(response) {
-    if (!response || Array.isArray(response)) {
-        return { hasMore: false };
-    }
-    return response.meta ?? { hasMore: false };
-}
-async function createPaginatedList({ response, fetchPage, mapItem, query, seenCursors, }) {
-    const meta = unwrapListMeta(response);
-    const data = await Promise.all(unwrapListData(response).map(mapItem));
-    const cursors = new Set(seenCursors);
-    if (query?.cursor) {
-        cursors.add(query.cursor);
-    }
-    const list = {
-        data,
-        meta,
-        get hasMore() {
-            return Boolean(meta.hasMore);
-        },
-        get nextCursor() {
-            return meta.nextCursor || undefined;
-        },
-        async nextPage() {
-            const cursor = list.nextCursor;
-            if (!cursor) {
-                return null;
-            }
-            if (cursors.has(cursor)) {
-                throw new Error("Pagination returned a repeated cursor");
-            }
-            const nextQuery = { ...(query ?? {}), cursor };
-            const nextSeenCursors = new Set(cursors);
-            nextSeenCursors.add(cursor);
-            return createPaginatedList({
-                response: await fetchPage(nextQuery),
-                fetchPage,
-                mapItem,
-                query: nextQuery,
-                seenCursors: nextSeenCursors,
-            });
-        },
-        async autoPagingEach(onItem) {
-            for await (const item of list) {
-                const shouldContinue = await onItem(item);
-                if (shouldContinue === false) {
-                    return;
-                }
-            }
-        },
-        async autoPagingToArray(options) {
-            if (!options || !Number.isFinite(options.limit) || options.limit <= 0) {
-                throw new Error("autoPagingToArray requires a positive limit");
-            }
-            const items = [];
-            for await (const item of list) {
-                items.push(item);
-                if (items.length >= options.limit) {
-                    return items;
-                }
-            }
-            return items;
-        },
-        async *[Symbol.asyncIterator]() {
-            let page = list;
-            while (page) {
-                for (const item of page.data) {
-                    yield item;
-                }
-                page = await page.nextPage();
-            }
-        },
-    };
-    return list;
-}

package/dist/cjs-browser/common/pagination.test.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const pagination_js_1 = require("./pagination.js");
-(0, vitest_1.describe)("pagination helpers", () => {
-    (0, vitest_1.it)("unwraps legacy array and paginated list responses", () => {
-        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)([{ name: "legacy" }])).toEqual([{ name: "legacy" }]);
-        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)({
-            data: [{ name: "paginated" }],
-            meta: { hasMore: false },
-        })).toEqual([{ name: "paginated" }]);
-    });
-    (0, vitest_1.it)("returns page data and lets callers request the next page", async () => {
-        const cursors = [];
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            cursors.push(query?.cursor);
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await (0, pagination_js_1.createPaginatedList)({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item.toUpperCase(),
-        });
-        (0, vitest_1.expect)(page.data).toEqual(["FIRST"]);
-        (0, vitest_1.expect)(page.hasMore).toBe(true);
-        (0, vitest_1.expect)(page.nextCursor).toBe("next-page");
-        const nextPage = await page.nextPage();
-        (0, vitest_1.expect)(nextPage?.data).toEqual(["SECOND"]);
-        (0, vitest_1.expect)(cursors).toEqual([undefined, "next-page"]);
-    });
-    (0, vitest_1.it)("supports auto paging with an explicit limit", async () => {
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await (0, pagination_js_1.createPaginatedList)({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item,
-        });
-        await (0, vitest_1.expect)(page.autoPagingToArray({ limit: 2 })).resolves.toEqual(["first", "second"]);
-    });
-});

package/dist/cjs-browser/types/common/pagination.d.ts

@@ -1,35 +0,0 @@
-export type PaginatedListMeta = {
-    hasMore?: boolean;
-    nextCursor?: string;
-    total?: number;
-};
-export type CursorPaginationQuery = {
-    cursor?: string;
-};
-export type ListResponse<T> = T[] | {
-    data?: T[] | null;
-    meta?: PaginatedListMeta | null;
-} | null | undefined;
-export type AutoPagingEachCallback<T> = (item: T) => boolean | void | Promise<boolean | void>;
-export type AutoPagingToArrayOptions = {
-    limit: number;
-};
-export type PaginatedList<T, TQuery extends CursorPaginationQuery = CursorPaginationQuery> = AsyncIterable<T> & {
-    data: T[];
-    meta: PaginatedListMeta;
-    hasMore: boolean;
-    nextCursor?: string;
-    nextPage(): Promise<PaginatedList<T, TQuery> | null>;
-    autoPagingEach(onItem: AutoPagingEachCallback<T>): Promise<void>;
-    autoPagingToArray(options: AutoPagingToArrayOptions): Promise<T[]>;
-};
-type CreatePaginatedListOptions<TRaw, TItem, TQuery extends CursorPaginationQuery> = {
-    response: ListResponse<TRaw>;
-    fetchPage: (query?: TQuery) => Promise<ListResponse<TRaw>>;
-    mapItem: (item: TRaw) => TItem | Promise<TItem>;
-    query?: TQuery;
-    seenCursors?: Set<string>;
-};
-export declare function unwrapListData<T>(response: ListResponse<T>): T[];
-export declare function createPaginatedList<TRaw, TItem, TQuery extends CursorPaginationQuery = CursorPaginationQuery>({ response, fetchPage, mapItem, query, seenCursors, }: CreatePaginatedListOptions<TRaw, TItem, TQuery>): Promise<PaginatedList<TItem, TQuery>>;
-export {};

package/dist/cjs-browser/types/common/pagination.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/esm/common/pagination.js

@@ -1,83 +0,0 @@
-export function unwrapListData(response) {
-    if (!response) {
-        return [];
-    }
-    if (Array.isArray(response)) {
-        return response;
-    }
-    return response.data ?? [];
-}
-function unwrapListMeta(response) {
-    if (!response || Array.isArray(response)) {
-        return { hasMore: false };
-    }
-    return response.meta ?? { hasMore: false };
-}
-export async function createPaginatedList({ response, fetchPage, mapItem, query, seenCursors, }) {
-    const meta = unwrapListMeta(response);
-    const data = await Promise.all(unwrapListData(response).map(mapItem));
-    const cursors = new Set(seenCursors);
-    if (query?.cursor) {
-        cursors.add(query.cursor);
-    }
-    const list = {
-        data,
-        meta,
-        get hasMore() {
-            return Boolean(meta.hasMore);
-        },
-        get nextCursor() {
-            return meta.nextCursor || undefined;
-        },
-        async nextPage() {
-            const cursor = list.nextCursor;
-            if (!cursor) {
-                return null;
-            }
-            if (cursors.has(cursor)) {
-                throw new Error("Pagination returned a repeated cursor");
-            }
-            const nextQuery = { ...(query ?? {}), cursor };
-            const nextSeenCursors = new Set(cursors);
-            nextSeenCursors.add(cursor);
-            return createPaginatedList({
-                response: await fetchPage(nextQuery),
-                fetchPage,
-                mapItem,
-                query: nextQuery,
-                seenCursors: nextSeenCursors,
-            });
-        },
-        async autoPagingEach(onItem) {
-            for await (const item of list) {
-                const shouldContinue = await onItem(item);
-                if (shouldContinue === false) {
-                    return;
-                }
-            }
-        },
-        async autoPagingToArray(options) {
-            if (!options || !Number.isFinite(options.limit) || options.limit <= 0) {
-                throw new Error("autoPagingToArray requires a positive limit");
-            }
-            const items = [];
-            for await (const item of list) {
-                items.push(item);
-                if (items.length >= options.limit) {
-                    return items;
-                }
-            }
-            return items;
-        },
-        async *[Symbol.asyncIterator]() {
-            let page = list;
-            while (page) {
-                for (const item of page.data) {
-                    yield item;
-                }
-                page = await page.nextPage();
-            }
-        },
-    };
-    return list;
-}

package/dist/esm/common/pagination.test.js

@@ -1,60 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { createPaginatedList, unwrapListData } from "./pagination.js";
-describe("pagination helpers", () => {
-    it("unwraps legacy array and paginated list responses", () => {
-        expect(unwrapListData([{ name: "legacy" }])).toEqual([{ name: "legacy" }]);
-        expect(unwrapListData({
-            data: [{ name: "paginated" }],
-            meta: { hasMore: false },
-        })).toEqual([{ name: "paginated" }]);
-    });
-    it("returns page data and lets callers request the next page", async () => {
-        const cursors = [];
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            cursors.push(query?.cursor);
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await createPaginatedList({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item.toUpperCase(),
-        });
-        expect(page.data).toEqual(["FIRST"]);
-        expect(page.hasMore).toBe(true);
-        expect(page.nextCursor).toBe("next-page");
-        const nextPage = await page.nextPage();
-        expect(nextPage?.data).toEqual(["SECOND"]);
-        expect(cursors).toEqual([undefined, "next-page"]);
-    });
-    it("supports auto paging with an explicit limit", async () => {
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await createPaginatedList({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item,
-        });
-        await expect(page.autoPagingToArray({ limit: 2 })).resolves.toEqual(["first", "second"]);
-    });
-});

package/dist/esm-browser/common/pagination.js

@@ -1,83 +0,0 @@
-export function unwrapListData(response) {
-    if (!response) {
-        return [];
-    }
-    if (Array.isArray(response)) {
-        return response;
-    }
-    return response.data ?? [];
-}
-function unwrapListMeta(response) {
-    if (!response || Array.isArray(response)) {
-        return { hasMore: false };
-    }
-    return response.meta ?? { hasMore: false };
-}
-export async function createPaginatedList({ response, fetchPage, mapItem, query, seenCursors, }) {
-    const meta = unwrapListMeta(response);
-    const data = await Promise.all(unwrapListData(response).map(mapItem));
-    const cursors = new Set(seenCursors);
-    if (query?.cursor) {
-        cursors.add(query.cursor);
-    }
-    const list = {
-        data,
-        meta,
-        get hasMore() {
-            return Boolean(meta.hasMore);
-        },
-        get nextCursor() {
-            return meta.nextCursor || undefined;
-        },
-        async nextPage() {
-            const cursor = list.nextCursor;
-            if (!cursor) {
-                return null;
-            }
-            if (cursors.has(cursor)) {
-                throw new Error("Pagination returned a repeated cursor");
-            }
-            const nextQuery = { ...(query ?? {}), cursor };
-            const nextSeenCursors = new Set(cursors);
-            nextSeenCursors.add(cursor);
-            return createPaginatedList({
-                response: await fetchPage(nextQuery),
-                fetchPage,
-                mapItem,
-                query: nextQuery,
-                seenCursors: nextSeenCursors,
-            });
-        },
-        async autoPagingEach(onItem) {
-            for await (const item of list) {
-                const shouldContinue = await onItem(item);
-                if (shouldContinue === false) {
-                    return;
-                }
-            }
-        },
-        async autoPagingToArray(options) {
-            if (!options || !Number.isFinite(options.limit) || options.limit <= 0) {
-                throw new Error("autoPagingToArray requires a positive limit");
-            }
-            const items = [];
-            for await (const item of list) {
-                items.push(item);
-                if (items.length >= options.limit) {
-                    return items;
-                }
-            }
-            return items;
-        },
-        async *[Symbol.asyncIterator]() {
-            let page = list;
-            while (page) {
-                for (const item of page.data) {
-                    yield item;
-                }
-                page = await page.nextPage();
-            }
-        },
-    };
-    return list;
-}

package/dist/esm-browser/common/pagination.test.js

@@ -1,60 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { createPaginatedList, unwrapListData } from "./pagination.js";
-describe("pagination helpers", () => {
-    it("unwraps legacy array and paginated list responses", () => {
-        expect(unwrapListData([{ name: "legacy" }])).toEqual([{ name: "legacy" }]);
-        expect(unwrapListData({
-            data: [{ name: "paginated" }],
-            meta: { hasMore: false },
-        })).toEqual([{ name: "paginated" }]);
-    });
-    it("returns page data and lets callers request the next page", async () => {
-        const cursors = [];
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            cursors.push(query?.cursor);
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await createPaginatedList({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item.toUpperCase(),
-        });
-        expect(page.data).toEqual(["FIRST"]);
-        expect(page.hasMore).toBe(true);
-        expect(page.nextCursor).toBe("next-page");
-        const nextPage = await page.nextPage();
-        expect(nextPage?.data).toEqual(["SECOND"]);
-        expect(cursors).toEqual([undefined, "next-page"]);
-    });
-    it("supports auto paging with an explicit limit", async () => {
-        const fetchPage = async (query) => {
-            await Promise.resolve();
-            if (!query?.cursor) {
-                return {
-                    data: ["first"],
-                    meta: { hasMore: true, nextCursor: "next-page" },
-                };
-            }
-            return {
-                data: ["second"],
-                meta: { hasMore: false },
-            };
-        };
-        const page = await createPaginatedList({
-            response: await fetchPage(),
-            fetchPage,
-            mapItem: (item) => item,
-        });
-        await expect(page.autoPagingToArray({ limit: 2 })).resolves.toEqual(["first", "second"]);
-    });
-});