@everysk/apps-sdk 0.2.0 → 0.3.0-beta-20261019175049

package/dist/hooks/workspace/useFetchWorkspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFetchWorkspace.js","names":[],"sources":["../../../src/hooks/workspace/useFetchWorkspace.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nimport { useQuery } from \"@tanstack/react-query\";\n\nimport { useAxios } from \"@/hooks/useAxios\";\nimport { useAppAlert } from \"@/contexts/appAlertContext/useAppAlert\";\nimport type { Workspace } from \"@/types/workspace\";\nimport { getWorkspace } from \"@/api/workspace\";\nimport type { EntityQueryOptions } from \"@/types/entityQuery\";\n\nexport type FetchWorkspaceProps<TData = Workspace, TSelected = TData> = {\n    name: string;\n    queryOptions?: EntityQueryOptions<TData, TSelected>;\n};\n\nconst defaultQueryOptions: EntityQueryOptions<Workspace> = {\n    refetchOnMount: \"always\",\n    staleTime: 0,\n    gcTime: 0,\n};\n\n/**\n * useFetchWorkspace\n *\n * Data-fetching hook built on TanStack Query to retrieve a single workspace by name.\n *\n * It also:\n * - builds a stable React Query `queryKey` that can be reused by mutation hooks for cache invalidation\n * - triggers an error alert via `useAppAlert` whenever `query.error` is present\n *\n * Parameters (FetchWorkspaceProps):\n * @param {string} name\n *   Workspace name (required).\n *\n * @param queryOptions\n *   TanStack Query options passed through to `useQuery` (e.g., enabled, staleTime, gcTime, etc.).\n *\n * Returns:\n * @returns {object}\n *   TanStack Query's `query` object extended with:\n *   - `queryKey`: the cache key used by React Query\n *\n * Example:\n * ```ts\n * const { data, isLoading } = useFetchWorkspace({ name: \"main\" });\n * // data -> Workspace\n * ```\n */\nexport const useFetchWorkspace = ({ name, queryOptions = defaultQueryOptions }: FetchWorkspaceProps) => {\n\n    const { api } = useAxios();\n    const { showAlert } = useAppAlert();\n\n    const queryKey = [\"workspace\", name];\n\n    const query = useQuery<Workspace>({\n        queryKey,\n        queryFn: async () => {\n            const workspace = await getWorkspace(api, name);\n            return workspace;\n        },\n        ...queryOptions ?? {}\n    });\n\n    useEffect(() => {\n        if (!query.error) return;\n\n        showAlert({\n            severity: \"error\",\n            message: query.error.message,\n        });\n    }, [query.error, showAlert]);\n\n    return {\n        ...query,\n        queryKey,\n    };\n};\n"],"mappings":";;;;;;AAeA,IAAM,sBAAqD;CACvD,gBAAgB;CAChB,WAAW;CACX,QAAQ;AACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,qBAAqB,EAAE,MAAM,eAAe,0BAA+C;CAEpG,MAAM,EAAE,QAAQ,SAAS;CACzB,MAAM,EAAE,cAAc,YAAY;CAElC,MAAM,WAAW,CAAC,aAAa,IAAI;CAEnC,MAAM,QAAQ,SAAoB;EAC9B;EACA,SAAS,YAAY;GAEjB,OAAO,MADiB,aAAa,KAAK,IAAI;EAElD;EACA,GAAG,gBAAgB,CAAC;CACxB,CAAC;CAED,gBAAgB;EACZ,IAAI,CAAC,MAAM,OAAO;EAElB,UAAU;GACN,UAAU;GACV,SAAS,MAAM,MAAM;EACzB,CAAC;CACL,GAAG,CAAC,MAAM,OAAO,SAAS,CAAC;CAE3B,OAAO;EACH,GAAG;EACH;CACJ;AACJ"}
+{"version":3,"file":"useFetchWorkspace.js","names":[],"sources":["../../../src/hooks/workspace/useFetchWorkspace.ts"],"sourcesContent":["import { useAxios } from \"@/hooks/useAxios\";\nimport { useEntityQuery } from \"@/hooks/useEntityQuery\";\nimport { getWorkspace } from \"@/api/workspace\";\nimport type { Workspace } from \"@/types/workspace\";\nimport type { FetchEntityProps } from \"@/types/entityQuery\";\n\nexport type FetchWorkspaceProps<TData = Workspace, TSelected = TData> = FetchEntityProps<\n    TData,\n    TSelected\n> & {\n    name: string;\n};\n\n/**\n * useFetchWorkspace\n *\n * Fetches one workspace by name; `data` is the workspace, or whatever `select` makes of it.\n *\n * A workspace is identified by its name — the API's `GET /workspaces/:id` takes the name, its\n * UID — so `name` is this hook's id, and like the other hooks' id it usually comes from a\n * selection the user has not made yet: while it is empty the hook stays idle, rather than fail\n * as a misconfigured app. A failure is shown as an error alert.\n *\n * @param {FetchWorkspaceProps} props - `name`, `select` and TanStack `queryOptions`.\n * @returns {object} The `useQuery` result, plus `queryKey`.\n */\nexport const useFetchWorkspace = <TSelected = Workspace>({\n    name,\n    select,\n    queryOptions,\n}: FetchWorkspaceProps<Workspace, TSelected>) => {\n    const { api } = useAxios();\n\n    const queryKey = [\"workspace\", name];\n\n    const query = useEntityQuery<Workspace, TSelected>({\n        queryKey,\n        fetchEntity: (signal) => getWorkspace(api, name, signal),\n        select,\n        enabled: Boolean(name),\n        queryOptions,\n    });\n\n    return { ...query, queryKey };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA0BA,IAAa,qBAA4C,EACrD,MACA,QACA,mBAC6C;CAC7C,MAAM,EAAE,QAAQ,SAAS;CAEzB,MAAM,WAAW,CAAC,aAAa,IAAI;CAUnC,OAAO;EAAE,GARK,eAAqC;GAC/C;GACA,cAAc,WAAW,aAAa,KAAK,MAAM,MAAM;GACvD;GACA,SAAS,QAAQ,IAAI;GACrB;EACJ,CAEY;EAAO;CAAS;AAChC"}

package/dist/hooks/workspace/useFetchWorkspaces.d.ts

@@ -1,46 +1,26 @@
-import { type UseInfiniteQueryOptions, type QueryKey } from "@tanstack/react-query";
 import type { Workspace, WorkspaceListResponse } from "../../types/workspace.d.ts";
-type PageToken = string | null;
-type InfiniteOptions<TData> = Omit<UseInfiniteQueryOptions<WorkspaceListResponse, Error, TData, QueryKey, PageToken>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam">;
-export type FetchInfiniteWorkspaceProps = {
-    workspace?: string;
-    pageSize?: number;
-    queryOptions?: InfiniteOptions<Workspace[]>;
+import type { FetchEntitiesProps, ListCache } from "../../types/entityQuery.d.ts";
+/** The query cache of `useFetchWorkspaces`, for typing `setQueryData`. */
+export type WorkspacesCache = ListCache<WorkspaceListResponse>;
+export type FetchWorkspacesProps<TData = Workspace[]> = FetchEntitiesProps<Workspace, TData, WorkspaceListResponse> & {
+    /** A name prefix. */
+    search?: string;
 };
 /**
  * useFetchWorkspaces
  *
- * Data-fetching hook built on TanStack Query's `useInfiniteQuery` to retrieve
- * workspaces with cursor-based pagination.
+ * Lists workspaces with cursor pagination; `query.data` is every loaded page merged, or
+ * whatever `select` makes of it. `select` and `fetchAllPages` behave as in
+ * `useFetchDatastores`. This endpoint lists the account's workspaces: it takes a name `search`,
+ * and no workspace — the docs exempt it, and the endpoint ignores one, which this hook used to
+ * send.
  *
- * It also:
- * - flattens all pages into a single `Workspace[]` via `select`
- *
- * Important notes:
- * - `query.data` returns a flat `Workspace[]` (all pages merged).
- * - `workspace` is required by some API configurations to avoid being blocked.
- *
- * @param props - FetchInfiniteWorkspaceProps
- *   - `workspace`: Current workspace name sent as a query param.
- *   - `pageSize`: Number of workspaces to fetch per page.
- *   - `queryOptions`: TanStack Query options passed through to `useInfiniteQuery`.
- *
- * Returns:
- * @returns {object}
- *   - `query`: the full `useInfiniteQuery` result (data, isLoading, hasNextPage, fetchNextPage, etc.)
- *   - `queryKey`: the cache key used by React Query
- *
- * Example:
- * ```ts
- * const { query } = useFetchWorkspaces({ workspace: "main", pageSize: 20 });
- *
- * // Flat list of all fetched workspaces
- * const workspaces = query.data ?? [];
- * ```
+ * @param {FetchWorkspacesProps} props - Search, page size, `select`, `fetchAllPages` and
+ *   TanStack `queryOptions`.
+ * @returns {object} `query` (the `useInfiniteQuery` result) and `queryKey`.
  */
-export declare function useFetchWorkspaces({ workspace, pageSize, queryOptions }: FetchInfiniteWorkspaceProps): {
-    query: import("@tanstack/react-query").UseInfiniteQueryResult<Workspace[], Error>;
-    queryKey: readonly unknown[];
+export declare function useFetchWorkspaces<TData = Workspace[]>({ search, pageSize, select, fetchAllPages, queryOptions, }: FetchWorkspacesProps<TData>): {
+    query: import("@tanstack/react-query").UseInfiniteQueryResult<TData, Error>;
+    queryKey: unknown[];
 };
-export {};
 //# sourceMappingURL=useFetchWorkspaces.d.ts.map

package/dist/hooks/workspace/useFetchWorkspaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFetchWorkspaces.d.ts","sourceRoot":"","sources":["../../../src/hooks/workspace/useFetchWorkspaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItG,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/B,KAAK,eAAe,CAAC,KAAK,IAAI,IAAI,CAC9B,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EACjF,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,CACnE,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC;CAC/C,CAAC;AAQF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAa,EAAE,YAAY,EAAE,EAAE,2BAA2B;;;EA4BzG"}
+{"version":3,"file":"useFetchWorkspaces.d.ts","sourceRoot":"","sources":["../../../src/hooks/workspace/useFetchWorkspaces.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEzE,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;AAE/D,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,SAAS,EAAE,IAAI,kBAAkB,CACtE,SAAS,EACT,KAAK,EACL,qBAAqB,CACxB,GAAG;IACA,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAG,SAAS,EAAE,EAAE,EACpD,MAAM,EACN,QAAa,EACb,MAAM,EACN,aAAqB,EACrB,YAAY,GACf,EAAE,oBAAoB,CAAC,KAAK,CAAC;;;EAgB7B"}

package/dist/hooks/workspace/useFetchWorkspaces.js

@@ -1,61 +1,39 @@
 import { useAxios } from "../useAxios.js";
+import { useEntityInfiniteQuery } from "../useEntityInfiniteQuery.js";
+import { buildQueryKey } from "../../api/entityQuery.js";
 import { listWorkspaces } from "../../api/workspace.js";
-import { useMemo } from "react";
-import { useInfiniteQuery } from "@tanstack/react-query";
 //#region src/hooks/workspace/useFetchWorkspaces.ts
-var defaultQueryOptions = {
-	refetchOnMount: "always",
-	staleTime: 0,
-	gcTime: 0
-};
 /**
 * useFetchWorkspaces
 *
-* Data-fetching hook built on TanStack Query's `useInfiniteQuery` to retrieve
-* workspaces with cursor-based pagination.
+* Lists workspaces with cursor pagination; `query.data` is every loaded page merged, or
+* whatever `select` makes of it. `select` and `fetchAllPages` behave as in
+* `useFetchDatastores`. This endpoint lists the account's workspaces: it takes a name `search`,
+* and no workspace — the docs exempt it, and the endpoint ignores one, which this hook used to
+* send.
 *
-* It also:
-* - flattens all pages into a single `Workspace[]` via `select`
-*
-* Important notes:
-* - `query.data` returns a flat `Workspace[]` (all pages merged).
-* - `workspace` is required by some API configurations to avoid being blocked.
-*
-* @param props - FetchInfiniteWorkspaceProps
-*   - `workspace`: Current workspace name sent as a query param.
-*   - `pageSize`: Number of workspaces to fetch per page.
-*   - `queryOptions`: TanStack Query options passed through to `useInfiniteQuery`.
-*
-* Returns:
-* @returns {object}
-*   - `query`: the full `useInfiniteQuery` result (data, isLoading, hasNextPage, fetchNextPage, etc.)
-*   - `queryKey`: the cache key used by React Query
-*
-* Example:
-* ```ts
-* const { query } = useFetchWorkspaces({ workspace: "main", pageSize: 20 });
-*
-* // Flat list of all fetched workspaces
-* const workspaces = query.data ?? [];
-* ```
+* @param {FetchWorkspacesProps} props - Search, page size, `select`, `fetchAllPages` and
+*   TanStack `queryOptions`.
+* @returns {object} `query` (the `useInfiniteQuery` result) and `queryKey`.
 */
-function useFetchWorkspaces({ workspace, pageSize = 10, queryOptions }) {
+function useFetchWorkspaces({ search, pageSize = 10, select, fetchAllPages = false, queryOptions }) {
 	const { api } = useAxios();
-	const queryKey = ["workspaces", workspace ?? null];
-	const mergedQueryOptions = useMemo(() => ({
-		...defaultQueryOptions,
-		...queryOptions ?? {}
-	}), [queryOptions]);
+	const queryKey = buildQueryKey(["workspaces", search ?? null], [], {
+		pageSize,
+		fetchAllPages
+	});
 	return {
-		query: useInfiniteQuery({
+		query: useEntityInfiniteQuery({
 			queryKey,
-			initialPageParam: null,
-			getNextPageParam: (lastPage) => lastPage.next_page_token ?? void 0,
-			queryFn: async ({ pageParam }) => {
-				return await listWorkspaces(api, workspace, pageSize, pageParam ?? void 0);
-			},
-			select: (data) => data.pages.flatMap((p) => p.workspaces),
-			...mergedQueryOptions
+			itemsKey: "workspaces",
+			fetchPage: (pageToken, signal) => listWorkspaces(api, {
+				search,
+				pageSize,
+				pageToken: pageToken ?? void 0
+			}, signal),
+			select,
+			fetchAllPages,
+			queryOptions
 		}),
 		queryKey
 	};

package/dist/hooks/workspace/useFetchWorkspaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFetchWorkspaces.js","names":[],"sources":["../../../src/hooks/workspace/useFetchWorkspaces.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useInfiniteQuery, type UseInfiniteQueryOptions, type QueryKey } from \"@tanstack/react-query\";\n\nimport { useAxios } from \"@/hooks/useAxios\";\nimport { listWorkspaces } from \"@/api/workspace\";\nimport type { Workspace, WorkspaceListResponse } from \"@/types/workspace\";\n\ntype PageToken = string | null;\n\ntype InfiniteOptions<TData> = Omit<\n    UseInfiniteQueryOptions<WorkspaceListResponse, Error, TData, QueryKey, PageToken>,\n    \"queryKey\" | \"queryFn\" | \"initialPageParam\" | \"getNextPageParam\"\n>;\n\nexport type FetchInfiniteWorkspaceProps = {\n    workspace?: string;\n    pageSize?: number;\n    queryOptions?: InfiniteOptions<Workspace[]>;\n};\n\nconst defaultQueryOptions: InfiniteOptions<Workspace[]> = {\n    refetchOnMount: \"always\",\n    staleTime: 0,\n    gcTime: 0,\n};\n\n/**\n * useFetchWorkspaces\n *\n * Data-fetching hook built on TanStack Query's `useInfiniteQuery` to retrieve\n * workspaces with cursor-based pagination.\n *\n * It also:\n * - flattens all pages into a single `Workspace[]` via `select`\n *\n * Important notes:\n * - `query.data` returns a flat `Workspace[]` (all pages merged).\n * - `workspace` is required by some API configurations to avoid being blocked.\n *\n * @param props - FetchInfiniteWorkspaceProps\n *   - `workspace`: Current workspace name sent as a query param.\n *   - `pageSize`: Number of workspaces to fetch per page.\n *   - `queryOptions`: TanStack Query options passed through to `useInfiniteQuery`.\n *\n * Returns:\n * @returns {object}\n *   - `query`: the full `useInfiniteQuery` result (data, isLoading, hasNextPage, fetchNextPage, etc.)\n *   - `queryKey`: the cache key used by React Query\n *\n * Example:\n * ```ts\n * const { query } = useFetchWorkspaces({ workspace: \"main\", pageSize: 20 });\n *\n * // Flat list of all fetched workspaces\n * const workspaces = query.data ?? [];\n * ```\n */\nexport function useFetchWorkspaces({ workspace, pageSize = 10, queryOptions }: FetchInfiniteWorkspaceProps) {\n    const { api } = useAxios();\n\n    const queryKey: QueryKey = [\"workspaces\", workspace ?? null];\n\n    const mergedQueryOptions = useMemo<InfiniteOptions<Workspace[]>>(() => ({\n        ...defaultQueryOptions,\n        ...(queryOptions ?? {}),\n    }), [queryOptions]);\n\n    const query = useInfiniteQuery<WorkspaceListResponse, Error, Workspace[], QueryKey, PageToken>({\n        queryKey,\n        initialPageParam: null,\n        getNextPageParam: (lastPage) => lastPage.next_page_token ?? undefined,\n\n        queryFn: async ({ pageParam }) => {\n            return await listWorkspaces(api, workspace, pageSize, pageParam ?? undefined);\n        },\n\n        select: (data) => data.pages.flatMap((p) => p.workspaces),\n\n        ...mergedQueryOptions,\n    });\n\n    return {\n        query,\n        queryKey,\n    };\n}\n"],"mappings":";;;;;AAoBA,IAAM,sBAAoD;CACtD,gBAAgB;CAChB,WAAW;CACX,QAAQ;AACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,mBAAmB,EAAE,WAAW,WAAW,IAAI,gBAA6C;CACxG,MAAM,EAAE,QAAQ,SAAS;CAEzB,MAAM,WAAqB,CAAC,cAAc,aAAa,IAAI;CAE3D,MAAM,qBAAqB,eAA6C;EACpE,GAAG;EACH,GAAI,gBAAgB,CAAC;CACzB,IAAI,CAAC,YAAY,CAAC;CAgBlB,OAAO;EACH,OAfU,iBAAiF;GAC3F;GACA,kBAAkB;GAClB,mBAAmB,aAAa,SAAS,mBAAmB,KAAA;GAE5D,SAAS,OAAO,EAAE,gBAAgB;IAC9B,OAAO,MAAM,eAAe,KAAK,WAAW,UAAU,aAAa,KAAA,CAAS;GAChF;GAEA,SAAS,SAAS,KAAK,MAAM,SAAS,MAAM,EAAE,UAAU;GAExD,GAAG;EACP,CAGI;EACA;CACJ;AACJ"}
+{"version":3,"file":"useFetchWorkspaces.js","names":[],"sources":["../../../src/hooks/workspace/useFetchWorkspaces.ts"],"sourcesContent":["import { useAxios } from \"@/hooks/useAxios\";\nimport { useEntityInfiniteQuery } from \"@/hooks/useEntityInfiniteQuery\";\nimport { listWorkspaces } from \"@/api/workspace\";\nimport { buildQueryKey } from \"@/api/entityQuery\";\nimport type { Workspace, WorkspaceListResponse } from \"@/types/workspace\";\nimport type { FetchEntitiesProps, ListCache } from \"@/types/entityQuery\";\n\n/** The query cache of `useFetchWorkspaces`, for typing `setQueryData`. */\nexport type WorkspacesCache = ListCache<WorkspaceListResponse>;\n\nexport type FetchWorkspacesProps<TData = Workspace[]> = FetchEntitiesProps<\n    Workspace,\n    TData,\n    WorkspaceListResponse\n> & {\n    /** A name prefix. */\n    search?: string;\n};\n\n/**\n * useFetchWorkspaces\n *\n * Lists workspaces with cursor pagination; `query.data` is every loaded page merged, or\n * whatever `select` makes of it. `select` and `fetchAllPages` behave as in\n * `useFetchDatastores`. This endpoint lists the account's workspaces: it takes a name `search`,\n * and no workspace — the docs exempt it, and the endpoint ignores one, which this hook used to\n * send.\n *\n * @param {FetchWorkspacesProps} props - Search, page size, `select`, `fetchAllPages` and\n *   TanStack `queryOptions`.\n * @returns {object} `query` (the `useInfiniteQuery` result) and `queryKey`.\n */\nexport function useFetchWorkspaces<TData = Workspace[]>({\n    search,\n    pageSize = 10,\n    select,\n    fetchAllPages = false,\n    queryOptions,\n}: FetchWorkspacesProps<TData>) {\n    const { api } = useAxios();\n\n    const queryKey = buildQueryKey([\"workspaces\", search ?? null], [], { pageSize, fetchAllPages });\n\n    const query = useEntityInfiniteQuery<WorkspaceListResponse, \"workspaces\", TData>({\n        queryKey,\n        itemsKey: \"workspaces\",\n        fetchPage: (pageToken, signal) =>\n            listWorkspaces(api, { search, pageSize, pageToken: pageToken ?? undefined }, signal),\n        select,\n        fetchAllPages,\n        queryOptions,\n    });\n\n    return { query, queryKey };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgCA,SAAgB,mBAAwC,EACpD,QACA,WAAW,IACX,QACA,gBAAgB,OAChB,gBAC4B;CAC5B,MAAM,EAAE,QAAQ,SAAS;CAEzB,MAAM,WAAW,cAAc,CAAC,cAAc,UAAU,IAAI,GAAG,CAAC,GAAG;EAAE;EAAU;CAAc,CAAC;CAY9F,OAAO;EAAE,OAVK,uBAAmE;GAC7E;GACA,UAAU;GACV,YAAY,WAAW,WACnB,eAAe,KAAK;IAAE;IAAQ;IAAU,WAAW,aAAa,KAAA;GAAU,GAAG,MAAM;GACvF;GACA;GACA;EACJ,CAES;EAAO;CAAS;AAC7B"}

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-export { EveryskApp } from "./EveryskApp";
-export type { EveryskAppProps, ProviderComponent } from "./EveryskApp";
-export { AppConfigContext } from "./contexts/appConfigContext";
-export { AppConfigProvider } from "./contexts/appConfigContext/provider";
+export { EveryskApp, withProps } from "./EveryskApp";
+export type { ConfiguredProvider, EveryskAppProps, ProviderComponent, ProviderEntry, } from "./EveryskApp";
 export { useAppConfig } from "./contexts/appConfigContext/useAppConfig";
-export type { AppConfigContextType, AppConfigProviderProps, } from "./contexts/appConfigContext/types";
-export { AppAlertContext } from "./contexts/appAlertContext";
-export { AppAlertProvider } from "./contexts/appAlertContext/provider";
+export type { AppConfigContextType } from "./contexts/appConfigContext/types";
 export { useAppAlert } from "./contexts/appAlertContext/useAppAlert";
 export type { AppAlertContextType, AppAlertState, ShowAlertOptions, } from "./contexts/appAlertContext/types";
 export { useAxios } from "./hooks/useAxios";
-export { toFilterTuple, buildQueryObject, buildQueryKey } from "./api/entityQuery";
-export { createQueryClient, getQueryFn } from "./lib/queryClient";
+export { useEntityQuery } from "./hooks/useEntityQuery";
+export type { EntityQueryProps } from "./hooks/useEntityQuery";
+export { useEntityMutation } from "./hooks/useEntityMutation";
+export type { EntityMutationProps } from "./hooks/useEntityMutation";
+export { useEntityInfiniteQuery, FETCH_ALL_PAGES_LIMIT } from "./hooks/useEntityInfiniteQuery";
+export type { EntityInfiniteQueryProps, ItemOf } from "./hooks/useEntityInfiniteQuery";
+export { buildQueryObject, buildQueryKey, hasWorkspaceFilter, missingWorkspaceError, } from "./api/entityQuery";
+export type { QueryKeyParams } from "./api/entityQuery";
+export { createQueryClient } from "./lib/queryClient";
 export type { AnyRecord } from "./types/anyRecord";
-export type { BaseQueryParams, DeleteEntityDefaultResponse, DeleteEntityResponse, EntityDefaultResponse, EntityListResponse, EntityQueryOptions, EntityQueryParams, EntitySingleResponse, FetchEntitiesParams, FetchEntityParams, FilterClause, FilterExpression, FilterOperator, QueryObject, } from "./types/entityQuery";
+export type { DeletedEntity, DeleteEntityResponse, EntityInfiniteQueryOptions, EntityListResponse, EntityQueryOptions, EntityQueryParams, EntitySingleResponse, FetchEntitiesProps, FetchEntityByIdProps, FetchEntityProps, FilterClause, FilterExpression, FilterOperator, ListCache, ListQueryProps, PagedResponse, PageToken, QueryObject, } from "./types/entityQuery";
 export * from "./portfolio";
 export * from "./datastore";
 export * from "./file";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,YAAY,EACR,oBAAoB,EACpB,sBAAsB,GACzB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,YAAY,EACR,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGlE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACR,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,WAAW,GACd,MAAM,qBAAqB,CAAC;AAI7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACR,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,aAAa,GAChB,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,YAAY,EACR,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACnB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,YAAY,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAGvF,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACR,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,EACT,WAAW,GACd,MAAM,qBAAqB,CAAC;AAI7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { components } from "./theme/overrides/index.js";
+import { componentOverrides } from "./theme/overrides/index.js";
 import { DefaultLightTheme } from "./theme/themes/DefaultLight.js";
 import { DefaultDarkTheme } from "./theme/themes/DefaultDark.js";
 import { EveryskLightTheme } from "./theme/themes/EveryskLight.js";
@@ -6,39 +6,41 @@ import { EveryskDarkTheme } from "./theme/themes/EveryskDark.js";
 import { MidnightEmberTheme } from "./theme/themes/MidnightEmber.js";
 import { getBrandTheme, getDefaultTheme, getTheme } from "./theme/themes/index.js";
 import { ThemeProvider } from "./theme/ThemeProvider.js";
-import { AppConfigContext } from "./contexts/appConfigContext/index.js";
-import { AppConfigProvider } from "./contexts/appConfigContext/provider.js";
-import { AppAlertContext } from "./contexts/appAlertContext/index.js";
-import { AppAlertProvider } from "./contexts/appAlertContext/provider.js";
-import { createQueryClient, getQueryFn } from "./lib/queryClient.js";
-import { EveryskApp } from "./EveryskApp.js";
+import { createQueryClient } from "./lib/queryClient.js";
+import { EveryskApp, withProps } from "./EveryskApp.js";
 import { useAppConfig } from "./contexts/appConfigContext/useAppConfig.js";
 import { useAppAlert } from "./contexts/appAlertContext/useAppAlert.js";
 import { useAxios } from "./hooks/useAxios.js";
-import { buildQueryKey, buildQueryObject, toFilterTuple } from "./api/entityQuery.js";
+import { FETCH_ALL_PAGES_LIMIT, useEntityInfiniteQuery } from "./hooks/useEntityInfiniteQuery.js";
+import { useEntityQuery } from "./hooks/useEntityQuery.js";
+import { useEntityMutation } from "./hooks/useEntityMutation.js";
+import { buildQueryKey, buildQueryObject, hasWorkspaceFilter, missingWorkspaceError } from "./api/entityQuery.js";
 import { createPortfolio, deletePortfolio, getPortfolio, listPortfolios, updatePortfolio } from "./api/portfolio.js";
 import { useFetchPortfolio } from "./hooks/portfolio/useFetchPortfolio.js";
 import { useFetchPortfolios } from "./hooks/portfolio/useFetchPortfolios.js";
 import { usePortfolioMutations } from "./hooks/portfolio/usePortfolioMutations.js";
 import { createDatastore, deleteDatastore, getDatastore, listDatastores, updateDatastore } from "./api/datastore.js";
 import { useDatastoreMutations } from "./hooks/datastore/useDatastoreMutations.js";
-import { buildDatastoreProps, mergeDatastores, objectsToTable, tableToObjects } from "./lib/datastoreTable.js";
+import { isTableDatastore, matrixToObjects, objectsToMatrix, parseDatastore, toDatastoreMatrix } from "./lib/datastoreTable.js";
 import { useFetchDatastore } from "./hooks/datastore/useFetchDatastore.js";
 import { useFetchDatastores } from "./hooks/datastore/useFetchDatastores.js";
 import { createFile, deleteFile, getFile, listFiles, updateFile } from "./api/file.js";
 import { useFetchFile } from "./hooks/file/useFetchFile.js";
 import { useFetchFiles } from "./hooks/file/useFetchFiles.js";
 import { useFileMutations } from "./hooks/file/useFileMutations.js";
+import { base64ToBlob, fileToBase64 } from "./lib/file.js";
 import { DEV_PROFILE, getProfile } from "./api/profile.js";
 import { useFetchProfile } from "./hooks/profile/useFetchProfile.js";
-import { TERMINAL_RUN_STATUSES, getWorkerExecution, getWorkflow, getWorkflowExecution, listWorkerExecutions, listWorkflowExecutions, listWorkflows, pollWorkflowExecution, runWorkflow, runWorkflowAndGetResult } from "./api/workflow.js";
+import { TERMINAL_RUN_STATUSES, getWorkerExecution, getWorkflow, getWorkflowExecution, isTerminalRunStatus, listWorkerExecutions, listWorkflowExecutions, listWorkflows, runWorkflow, terminalRunStatusOf } from "./api/workflow.js";
 import { useFetchWorkerExecution } from "./hooks/workflow/useFetchWorkerExecution.js";
 import { useFetchWorkerExecutions } from "./hooks/workflow/useFetchWorkerExecutions.js";
 import { useFetchWorkflow } from "./hooks/workflow/useFetchWorkflow.js";
 import { useFetchWorkflowExecution } from "./hooks/workflow/useFetchWorkflowExecution.js";
 import { useFetchWorkflowExecutions } from "./hooks/workflow/useFetchWorkflowExecutions.js";
 import { useFetchWorkflows } from "./hooks/workflow/useFetchWorkflows.js";
+import { WorkflowRunAbortedError } from "./lib/workflowRun.js";
 import { useRunWorkflow } from "./hooks/workflow/useRunWorkflow.js";
+import { useTriggerWorkflow } from "./hooks/workflow/useTriggerWorkflow.js";
 import { getWorkspace, listWorkspaces } from "./api/workspace.js";
 import { useFetchWorkspace } from "./hooks/workspace/useFetchWorkspace.js";
 import { useFetchWorkspaces } from "./hooks/workspace/useFetchWorkspaces.js";
@@ -47,4 +49,4 @@ import { Footer } from "./components/ui/Footer/index.js";
 import { GlobalLoading } from "./components/ui/GlobalLoading/index.js";
 import { PageContainer } from "./components/ui/PageContainer/index.js";
 import { Toolbar } from "./components/ui/Toolbar/index.js";
-export { AppAlertContext, AppAlertProvider, AppConfigContext, AppConfigProvider, DEV_PROFILE, DefaultDarkTheme, DefaultLightTheme, EveryskApp, EveryskDarkTheme, EveryskIcon, EveryskLightTheme, Footer, GlobalLoading, MidnightEmberTheme, PageContainer, TERMINAL_RUN_STATUSES, ThemeProvider, Toolbar, buildDatastoreProps, buildQueryKey, buildQueryObject, components, createDatastore, createFile, createPortfolio, createQueryClient, deleteDatastore, deleteFile, deletePortfolio, getBrandTheme, getDatastore, getDefaultTheme, getFile, getPortfolio, getProfile, getQueryFn, getTheme, getWorkerExecution, getWorkflow, getWorkflowExecution, getWorkspace, listDatastores, listFiles, listPortfolios, listWorkerExecutions, listWorkflowExecutions, listWorkflows, listWorkspaces, mergeDatastores, objectsToTable, pollWorkflowExecution, runWorkflow, runWorkflowAndGetResult, tableToObjects, toFilterTuple, updateDatastore, updateFile, updatePortfolio, useAppAlert, useAppConfig, useAxios, useDatastoreMutations, useFetchDatastore, useFetchDatastores, useFetchFile, useFetchFiles, useFetchPortfolio, useFetchPortfolios, useFetchProfile, useFetchWorkerExecution, useFetchWorkerExecutions, useFetchWorkflow, useFetchWorkflowExecution, useFetchWorkflowExecutions, useFetchWorkflows, useFetchWorkspace, useFetchWorkspaces, useFileMutations, usePortfolioMutations, useRunWorkflow };
+export { DEV_PROFILE, DefaultDarkTheme, DefaultLightTheme, EveryskApp, EveryskDarkTheme, EveryskIcon, EveryskLightTheme, FETCH_ALL_PAGES_LIMIT, Footer, GlobalLoading, MidnightEmberTheme, PageContainer, TERMINAL_RUN_STATUSES, ThemeProvider, Toolbar, WorkflowRunAbortedError, base64ToBlob, buildQueryKey, buildQueryObject, componentOverrides, createDatastore, createFile, createPortfolio, createQueryClient, deleteDatastore, deleteFile, deletePortfolio, fileToBase64, getBrandTheme, getDatastore, getDefaultTheme, getFile, getPortfolio, getProfile, getTheme, getWorkerExecution, getWorkflow, getWorkflowExecution, getWorkspace, hasWorkspaceFilter, isTableDatastore, isTerminalRunStatus, listDatastores, listFiles, listPortfolios, listWorkerExecutions, listWorkflowExecutions, listWorkflows, listWorkspaces, matrixToObjects, missingWorkspaceError, objectsToMatrix, parseDatastore, runWorkflow, terminalRunStatusOf, toDatastoreMatrix, updateDatastore, updateFile, updatePortfolio, useAppAlert, useAppConfig, useAxios, useDatastoreMutations, useEntityInfiniteQuery, useEntityMutation, useEntityQuery, useFetchDatastore, useFetchDatastores, useFetchFile, useFetchFiles, useFetchPortfolio, useFetchPortfolios, useFetchProfile, useFetchWorkerExecution, useFetchWorkerExecutions, useFetchWorkflow, useFetchWorkflowExecution, useFetchWorkflowExecutions, useFetchWorkflows, useFetchWorkspace, useFetchWorkspaces, useFileMutations, usePortfolioMutations, useRunWorkflow, useTriggerWorkflow, withProps };

package/dist/lib/abort.d.ts

@@ -0,0 +1,58 @@
+/**
+ * abortable
+ *
+ * The one shape every abortable wait here takes: a promise that `start` settles, or that rejects
+ * with the signal's reason as soon as it aborts. `start` returns its cleanup, which runs either
+ * way, so a timer or a listener never outlives the promise.
+ *
+ * @param signal - Aborts the wait.
+ * @param start - Begins the work and returns what undoes it.
+ * @returns The work's result, unless the signal aborts first.
+ */
+export declare const abortable: <T>(signal: AbortSignal, start: (resolve: (value: T) => void, reject: (error: unknown) => void) => () => void) => Promise<T>;
+/**
+ * Settles as `promise` does, or rejects with the signal's reason once it aborts first — for work
+ * that may not honour the signal itself.
+ */
+export declare const unlessAborted: <T>(promise: Promise<T>, signal: AbortSignal) => Promise<T>;
+/**
+ * createDeadline
+ *
+ * A signal that aborts after `timeoutMs`, or as soon as `signal` does, each with its own error.
+ * `dispose` stops the timer and the listener once the work is done.
+ *
+ * @param options - The timeout, the outer signal, and the error each abort carries. The errors
+ *   are built when the abort happens, so they can describe the state at that moment.
+ * @returns The signal, and `dispose`.
+ */
+export declare const createDeadline: ({ timeoutMs, signal, timeoutError, abortError, }: {
+    timeoutMs: number;
+    signal?: AbortSignal;
+    timeoutError: () => Error;
+    abortError: () => Error;
+}) => {
+    signal: AbortSignal;
+    dispose(): void;
+};
+/**
+ * anySignal
+ *
+ * A signal that aborts as soon as any of `signals` does, with that one's reason. It is
+ * `AbortSignal.any`, written out because that arrived in Chrome 116, Firefox 124 and Safari 17.4,
+ * after the browsers a Vite 8 app targets by default (Chrome 111, Firefox 114, Safari 16.4).
+ * What it uses instead — `abort(reason)`, `signal.reason` and `addEventListener`'s `once` —
+ * predates them all. Source: MDN browser-compat-data, `api/AbortSignal.json` and
+ * `api/AbortController.json` (2026-10-14).
+ *
+ * Missing signals are skipped, so an optional one can be passed as is. It stops listening to the
+ * others once one aborts, or when `dispose` is called: a run that ends normally aborts nothing,
+ * and a long-lived signal would otherwise keep one listener per run.
+ *
+ * @param signals - The signals to follow; `undefined` entries are ignored.
+ * @returns The signal that aborts with the first of them, and `dispose`.
+ */
+export declare const anySignal: (signals: (AbortSignal | undefined)[]) => {
+    signal: AbortSignal;
+    dispose: () => void;
+};
+//# sourceMappingURL=abort.d.ts.map

package/dist/lib/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/lib/abort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACvB,QAAQ,WAAW,EACnB,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,KACrF,OAAO,CAAC,CAAC,CAyBN,CAAC;AAEP;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,WAAW,KAAG,OAAO,CAAC,CAAC,CAI/E,CAAC;AAEP;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,kDAK5B;IACC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,MAAM,KAAK,CAAC;IAC1B,UAAU,EAAE,MAAM,KAAK,CAAC;CAC3B;;;CAeA,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,GAClB,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,KACrC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAuB5C,CAAC"}

package/dist/lib/abort.js

@@ -0,0 +1,112 @@
+//#region src/lib/abort.ts
+/**
+* abortable
+*
+* The one shape every abortable wait here takes: a promise that `start` settles, or that rejects
+* with the signal's reason as soon as it aborts. `start` returns its cleanup, which runs either
+* way, so a timer or a listener never outlives the promise.
+*
+* @param signal - Aborts the wait.
+* @param start - Begins the work and returns what undoes it.
+* @returns The work's result, unless the signal aborts first.
+*/
+var abortable = (signal, start) => new Promise((resolve, reject) => {
+	if (signal.aborted) return reject(signal.reason);
+	let cleanup = () => {};
+	const finish = () => {
+		cleanup();
+		signal.removeEventListener("abort", onAbort);
+	};
+	const onAbort = () => {
+		finish();
+		reject(signal.reason);
+	};
+	signal.addEventListener("abort", onAbort, { once: true });
+	cleanup = start((value) => {
+		finish();
+		resolve(value);
+	}, (error) => {
+		finish();
+		reject(error);
+	});
+});
+/**
+* Settles as `promise` does, or rejects with the signal's reason once it aborts first — for work
+* that may not honour the signal itself.
+*/
+var unlessAborted = (promise, signal) => abortable(signal, (resolve, reject) => {
+	promise.then(resolve, reject);
+	return () => {};
+});
+/**
+* createDeadline
+*
+* A signal that aborts after `timeoutMs`, or as soon as `signal` does, each with its own error.
+* `dispose` stops the timer and the listener once the work is done.
+*
+* @param options - The timeout, the outer signal, and the error each abort carries. The errors
+*   are built when the abort happens, so they can describe the state at that moment.
+* @returns The signal, and `dispose`.
+*/
+var createDeadline = ({ timeoutMs, signal, timeoutError, abortError }) => {
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(timeoutError()), timeoutMs);
+	const abort = () => controller.abort(abortError());
+	if (signal?.aborted) abort();
+	else signal?.addEventListener("abort", abort, { once: true });
+	return {
+		signal: controller.signal,
+		dispose() {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", abort);
+		}
+	};
+};
+/**
+* anySignal
+*
+* A signal that aborts as soon as any of `signals` does, with that one's reason. It is
+* `AbortSignal.any`, written out because that arrived in Chrome 116, Firefox 124 and Safari 17.4,
+* after the browsers a Vite 8 app targets by default (Chrome 111, Firefox 114, Safari 16.4).
+* What it uses instead — `abort(reason)`, `signal.reason` and `addEventListener`'s `once` —
+* predates them all. Source: MDN browser-compat-data, `api/AbortSignal.json` and
+* `api/AbortController.json` (2026-10-14).
+*
+* Missing signals are skipped, so an optional one can be passed as is. It stops listening to the
+* others once one aborts, or when `dispose` is called: a run that ends normally aborts nothing,
+* and a long-lived signal would otherwise keep one listener per run.
+*
+* @param signals - The signals to follow; `undefined` entries are ignored.
+* @returns The signal that aborts with the first of them, and `dispose`.
+*/
+var anySignal = (signals) => {
+	const controller = new AbortController();
+	const present = signals.filter((signal) => signal !== void 0);
+	const already = present.find((signal) => signal.aborted);
+	if (already) {
+		controller.abort(already.reason);
+		return {
+			signal: controller.signal,
+			dispose: () => {}
+		};
+	}
+	const dispose = () => {
+		for (const [signal, listener] of listeners) signal.removeEventListener("abort", listener);
+	};
+	const listeners = present.map((signal) => {
+		const listener = () => {
+			dispose();
+			controller.abort(signal.reason);
+		};
+		signal.addEventListener("abort", listener, { once: true });
+		return [signal, listener];
+	});
+	return {
+		signal: controller.signal,
+		dispose
+	};
+};
+//#endregion
+export { abortable, anySignal, createDeadline, unlessAborted };
+
+//# sourceMappingURL=abort.js.map

package/dist/lib/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","names":[],"sources":["../../src/lib/abort.ts"],"sourcesContent":["/**\n * abortable\n *\n * The one shape every abortable wait here takes: a promise that `start` settles, or that rejects\n * with the signal's reason as soon as it aborts. `start` returns its cleanup, which runs either\n * way, so a timer or a listener never outlives the promise.\n *\n * @param signal - Aborts the wait.\n * @param start - Begins the work and returns what undoes it.\n * @returns The work's result, unless the signal aborts first.\n */\nexport const abortable = <T>(\n    signal: AbortSignal,\n    start: (resolve: (value: T) => void, reject: (error: unknown) => void) => () => void,\n): Promise<T> =>\n    new Promise<T>((resolve, reject) => {\n        if (signal.aborted) return reject(signal.reason);\n\n        let cleanup = () => {};\n        const finish = () => {\n            cleanup();\n            signal.removeEventListener(\"abort\", onAbort);\n        };\n        const onAbort = () => {\n            finish();\n            reject(signal.reason);\n        };\n\n        signal.addEventListener(\"abort\", onAbort, { once: true });\n        cleanup = start(\n            (value) => {\n                finish();\n                resolve(value);\n            },\n            (error) => {\n                finish();\n                reject(error);\n            },\n        );\n    });\n\n/**\n * Settles as `promise` does, or rejects with the signal's reason once it aborts first — for work\n * that may not honour the signal itself.\n */\nexport const unlessAborted = <T>(promise: Promise<T>, signal: AbortSignal): Promise<T> =>\n    abortable(signal, (resolve, reject) => {\n        promise.then(resolve, reject);\n        return () => {};\n    });\n\n/**\n * createDeadline\n *\n * A signal that aborts after `timeoutMs`, or as soon as `signal` does, each with its own error.\n * `dispose` stops the timer and the listener once the work is done.\n *\n * @param options - The timeout, the outer signal, and the error each abort carries. The errors\n *   are built when the abort happens, so they can describe the state at that moment.\n * @returns The signal, and `dispose`.\n */\nexport const createDeadline = ({\n    timeoutMs,\n    signal,\n    timeoutError,\n    abortError,\n}: {\n    timeoutMs: number;\n    signal?: AbortSignal;\n    timeoutError: () => Error;\n    abortError: () => Error;\n}) => {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(timeoutError()), timeoutMs);\n    const abort = () => controller.abort(abortError());\n\n    if (signal?.aborted) abort();\n    else signal?.addEventListener(\"abort\", abort, { once: true });\n\n    return {\n        signal: controller.signal,\n        dispose() {\n            clearTimeout(timer);\n            signal?.removeEventListener(\"abort\", abort);\n        },\n    };\n};\n\n/**\n * anySignal\n *\n * A signal that aborts as soon as any of `signals` does, with that one's reason. It is\n * `AbortSignal.any`, written out because that arrived in Chrome 116, Firefox 124 and Safari 17.4,\n * after the browsers a Vite 8 app targets by default (Chrome 111, Firefox 114, Safari 16.4).\n * What it uses instead — `abort(reason)`, `signal.reason` and `addEventListener`'s `once` —\n * predates them all. Source: MDN browser-compat-data, `api/AbortSignal.json` and\n * `api/AbortController.json` (2026-10-14).\n *\n * Missing signals are skipped, so an optional one can be passed as is. It stops listening to the\n * others once one aborts, or when `dispose` is called: a run that ends normally aborts nothing,\n * and a long-lived signal would otherwise keep one listener per run.\n *\n * @param signals - The signals to follow; `undefined` entries are ignored.\n * @returns The signal that aborts with the first of them, and `dispose`.\n */\nexport const anySignal = (\n    signals: (AbortSignal | undefined)[],\n): { signal: AbortSignal; dispose: () => void } => {\n    const controller = new AbortController();\n    const present = signals.filter((signal): signal is AbortSignal => signal !== undefined);\n\n    const already = present.find((signal) => signal.aborted);\n    if (already) {\n        controller.abort(already.reason);\n        return { signal: controller.signal, dispose: () => {} };\n    }\n\n    const dispose = () => {\n        for (const [signal, listener] of listeners) signal.removeEventListener(\"abort\", listener);\n    };\n    const listeners = present.map((signal) => {\n        const listener = () => {\n            dispose();\n            controller.abort(signal.reason);\n        };\n        signal.addEventListener(\"abort\", listener, { once: true });\n        return [signal, listener] as const;\n    });\n\n    return { signal: controller.signal, dispose };\n};\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,aACT,QACA,UAEA,IAAI,SAAY,SAAS,WAAW;CAChC,IAAI,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM;CAE/C,IAAI,gBAAgB,CAAC;CACrB,MAAM,eAAe;EACjB,QAAQ;EACR,OAAO,oBAAoB,SAAS,OAAO;CAC/C;CACA,MAAM,gBAAgB;EAClB,OAAO;EACP,OAAO,OAAO,MAAM;CACxB;CAEA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CACxD,UAAU,OACL,UAAU;EACP,OAAO;EACP,QAAQ,KAAK;CACjB,IACC,UAAU;EACP,OAAO;EACP,OAAO,KAAK;CAChB,CACJ;AACJ,CAAC;;;;;AAML,IAAa,iBAAoB,SAAqB,WAClD,UAAU,SAAS,SAAS,WAAW;CACnC,QAAQ,KAAK,SAAS,MAAM;CAC5B,aAAa,CAAC;AAClB,CAAC;;;;;;;;;;;AAYL,IAAa,kBAAkB,EAC3B,WACA,QACA,cACA,iBAME;CACF,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,QAAQ,iBAAiB,WAAW,MAAM,aAAa,CAAC,GAAG,SAAS;CAC1E,MAAM,cAAc,WAAW,MAAM,WAAW,CAAC;CAEjD,IAAI,QAAQ,SAAS,MAAM;MACtB,QAAQ,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;CAE5D,OAAO;EACH,QAAQ,WAAW;EACnB,UAAU;GACN,aAAa,KAAK;GAClB,QAAQ,oBAAoB,SAAS,KAAK;EAC9C;CACJ;AACJ;;;;;;;;;;;;;;;;;;AAmBA,IAAa,aACT,YAC+C;CAC/C,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,UAAU,QAAQ,QAAQ,WAAkC,WAAW,KAAA,CAAS;CAEtF,MAAM,UAAU,QAAQ,MAAM,WAAW,OAAO,OAAO;CACvD,IAAI,SAAS;EACT,WAAW,MAAM,QAAQ,MAAM;EAC/B,OAAO;GAAE,QAAQ,WAAW;GAAQ,eAAe,CAAC;EAAE;CAC1D;CAEA,MAAM,gBAAgB;EAClB,KAAK,MAAM,CAAC,QAAQ,aAAa,WAAW,OAAO,oBAAoB,SAAS,QAAQ;CAC5F;CACA,MAAM,YAAY,QAAQ,KAAK,WAAW;EACtC,MAAM,iBAAiB;GACnB,QAAQ;GACR,WAAW,MAAM,OAAO,MAAM;EAClC;EACA,OAAO,iBAAiB,SAAS,UAAU,EAAE,MAAM,KAAK,CAAC;EACzD,OAAO,CAAC,QAAQ,QAAQ;CAC5B,CAAC;CAED,OAAO;EAAE,QAAQ,WAAW;EAAQ;CAAQ;AAChD"}