@selvajs/platform 1.0.0-beta.4 → 1.0.0-beta.5

package/README.md

@@ -111,7 +111,7 @@ Throw `ProviderError` for user-facing failures (`new ProviderError('...', 404)`)
 
 ## Data privacy
 
-Identity and credentials belong to whichever `IAuthProvider` is configured — for Supabase that's a separate service; for the local provider, Selva itself is the auth provider and holds email addresses and password hashes on disk. This package's own stores hold user IDs, authorization metadata, display names, invite email addresses, and audit payloads. **The operator is the data controller.** See [data privacy](../../docs/self-hosting/concepts/data-privacy.md) for the full inventory and what erasure reaches, plus [providers](../../docs/self-hosting/providers/overview.md) and [security & limits](../../docs/self-hosting/concepts/security-and-limits.md).
+Identity and credentials belong to whichever `IAuthProvider` is configured — for Supabase that's a separate service; for the local provider, Selva itself is the auth provider and holds email addresses and password hashes on disk. This package's own stores hold user IDs, authorization metadata, display names, invite email addresses, and audit payloads. **The operator is the data controller.** See [data privacy](../../docs/self-hosting/concepts/data-privacy.md) for the full inventory and what erasure reaches, plus [providers](../../docs/self-hosting/providers/overview.md) and [security & limits](../../docs/self-hosting/deployment/security-and-limits.md).
 
 ---
 

package/dist/index.d.ts

@@ -28,7 +28,7 @@ export { NoopBindingResolver } from './bindings/interface.js';
 export type { RequestContext } from './context.js';
 export { SYSTEM_CONTEXT, hasPermission, requireActingOrg, isShareContext, assertNotShareContext } from './context.js';
 export type { ListOptions, DefinitionListOptions, Page } from './pagination.js';
-export { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT, clampPageLimit, decodeOffsetCursor, encodeOffsetCursor } from './pagination.js';
+export { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT, clampPageLimit, decodeOffsetCursor, encodeOffsetCursor, listAll, walkPages } from './pagination.js';
 export type { TenancyMode, SelvaFlags, SelvaBranding, SelvaConfig, SelvaConfigFactory } from './config.js';
 export { isFlagEnabled, defineConfig } from './config.js';
 export { ProviderError } from './errors.js';

package/dist/index.js

@@ -22,6 +22,6 @@ export { NoopErrorReporter } from './errors/interface.js';
 export { NoopLogger } from './logging/interface.js';
 export { NoopBindingResolver } from './bindings/interface.js';
 export { SYSTEM_CONTEXT, hasPermission, requireActingOrg, isShareContext, assertNotShareContext } from './context.js';
-export { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT, clampPageLimit, decodeOffsetCursor, encodeOffsetCursor } from './pagination.js';
+export { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT, clampPageLimit, decodeOffsetCursor, encodeOffsetCursor, listAll, walkPages } from './pagination.js';
 export { isFlagEnabled, defineConfig } from './config.js';
 export { ProviderError } from './errors.js';

package/dist/pagination.d.ts

@@ -49,5 +49,17 @@ export declare const MAX_PAGE_LIMIT = 200;
 /** For adapters paging by offset. Junk and negatives read as the first page. */
 export declare function decodeOffsetCursor(cursor: string | undefined): number;
 export declare function encodeOffsetCursor(offset: number): string;
+type PageFetcher<T> = (page: {
+    limit: number;
+    cursor?: string;
+}) => Promise<Page<T>>;
+/**
+ * Every page of a list, in order. One call stops at `MAX_PAGE_LIMIT` without saying so, which is
+ * fatal for a read that must see every row. Break out of the loop to stop reading.
+ */
+export declare function walkPages<T>(fetchPage: PageFetcher<T>): AsyncGenerator<Page<T>>;
+/** Every row of a list, across all its pages. */
+export declare function listAll<T>(fetchPage: PageFetcher<T>): Promise<T[]>;
 /** The effective page size for a requested limit. */
 export declare function clampPageLimit(limit: number | undefined): number;
+export {};

package/dist/pagination.js

@@ -8,6 +8,25 @@ export function decodeOffsetCursor(cursor) {
 export function encodeOffsetCursor(offset) {
     return String(offset);
 }
+/**
+ * Every page of a list, in order. One call stops at `MAX_PAGE_LIMIT` without saying so, which is
+ * fatal for a read that must see every row. Break out of the loop to stop reading.
+ */
+export async function* walkPages(fetchPage) {
+    let cursor;
+    do {
+        const page = await fetchPage({ limit: MAX_PAGE_LIMIT, cursor });
+        yield page;
+        cursor = page.nextCursor;
+    } while (cursor);
+}
+/** Every row of a list, across all its pages. */
+export async function listAll(fetchPage) {
+    const items = [];
+    for await (const page of walkPages(fetchPage))
+        items.push(...page.items);
+    return items;
+}
 /** The effective page size for a requested limit. */
 export function clampPageLimit(limit) {
     const requested = limit ?? DEFAULT_PAGE_LIMIT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvajs/platform",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "description": "Interfaces, access rules and conformance suites for Selva platform providers",
   "license": "MIT",
   "author": "VektorNode",