@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.0

package/dist/data/types.d.ts

@@ -0,0 +1,219 @@
+import type { EntityQuery } from '../entity/types.js';
+/**
+ * Data Capability Types
+ *
+ * Data source resolution, fetch integration, and data binding for surfaces
+ *
+ * @module @pwfabric/runtime/data/types
+ */
+/**
+ * Supported data source kinds
+ */
+export type DataSourceKind = 'rest' | 'graphql' | 'static' | 'state' | 'computed';
+/**
+ * Data source definition for capability resolution
+ */
+export interface DataSourceDefinition<T = unknown> {
+    readonly id: string;
+    readonly kind: DataSourceKind;
+    readonly name?: string;
+    readonly endpoint?: string;
+    readonly method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly staticData?: T;
+    readonly stateKey?: string;
+    readonly compute?: (context: DataResolveContext) => T | Promise<T>;
+    readonly transform?: (raw: unknown) => T;
+    readonly cache?: DataCacheConfig;
+    readonly retry?: DataRetryConfig;
+    /**
+     * the identity this source is called WITH, by name.
+     *
+     * Without it a `rest` source cannot read authenticated data at all — 403
+     * anonymous, 401 without a bearer, CORS-blocked with cookies — so the only
+     * answer to "read this API as me" would be to write an engine. Named here,
+     * the data path attaches that identity's LIVE token at call time.
+     *
+     * A NAME, NEVER A VALUE. The ref is resolved per call against the running
+     * app's auth bridge; no token is stored on the source and none is serialised
+     * into a published bundle.
+     */
+    readonly authProviderRef?: string;
+    /**
+     * The response property holding the list — `data`, `products`, or absent
+     * when the body IS the array. Dotted paths allowed for a nested one.
+     */
+    readonly returns?: string;
+    /**
+     * The source's own filter / sort / pagination, applied to the rows AFTER the
+     * fetch. A REST endpoint does not speak the platform's query language — a
+     * declared engine's foreign API answers 400 to `filter=` — so the query is
+     * never sent; it is applied here, once, the same way for every kind.
+     */
+    readonly query?: EntityQuery;
+}
+/**
+ * Cache configuration for data sources
+ */
+export interface DataCacheConfig {
+    readonly enabled: boolean;
+    readonly ttl?: number;
+    readonly key?: string;
+}
+/**
+ * Retry configuration for data sources
+ */
+export interface DataRetryConfig {
+    readonly maxAttempts: number;
+    readonly baseDelay: number;
+    readonly exponentialBackoff?: boolean;
+}
+/**
+ * Context provided during data resolution
+ */
+export interface DataResolveContext {
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly signal?: AbortSignal;
+    readonly getState?: (key: string) => unknown;
+}
+/**
+ * Options for fetching data
+ */
+export interface DataFetchOptions {
+    readonly params?: Readonly<Record<string, unknown>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    /**
+     * Overrides the source's own method for this call — a form writing to a
+     * source it also reads from. The source declares how it is READ; a write is
+     * a different verb against the same address.
+     */
+    readonly method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /**
+     * Address ONE record of the collection the source reads: the request goes
+     * to `<endpoint>/<recordId>`. A form updating the row it loaded needs this;
+     * a PATCH to the collection path is a request nobody answers.
+     */
+    readonly recordId?: string;
+    readonly signal?: AbortSignal;
+    readonly skipCache?: boolean;
+    readonly timeout?: number;
+}
+/**
+ * Result of a data fetch operation
+ */
+export type DataFetchResult<T> = {
+    readonly success: true;
+    readonly data: T;
+    readonly metadata: DataFetchMetadata;
+} | {
+    readonly success: false;
+    readonly error: DataFetchError;
+};
+/**
+ * Metadata about a successful data fetch
+ */
+export interface DataFetchMetadata {
+    readonly duration: number;
+    readonly fromCache: boolean;
+    /** HTTP status of a `rest` / `graphql` answer. */
+    readonly status?: number;
+    readonly timestamp: number;
+    /**
+     * The rest of the response body when `returns` plucked the list out of it —
+     * DummyJSON's `{ products, total, skip, limit }` gives
+     * `{ total, skip, limit }`. Without it a paginated list could not know how
+     * many rows exist. Absent when there is no `returns` or the body is not an
+     * object.
+     */
+    readonly envelope?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Error from a data fetch operation
+ */
+export interface DataFetchError {
+    readonly type: 'network' | 'timeout' | 'validation' | 'transform' | 'not_found' | 'unknown';
+    /**
+     * The server's own message when its refusal carried one
+     * (`{ error: { code, message } }`), else the HTTP status line.
+     */
+    readonly message: string;
+    readonly status?: number;
+    /** The server's error code (`NOT_FOUND`, `VALIDATION_FAILED`, …) when it sent one. */
+    readonly code?: string;
+    readonly cause?: unknown;
+}
+/**
+ * Binding between a data source and a surface element
+ */
+export interface DataBinding<T = unknown> {
+    readonly id: string;
+    readonly sourceId: string;
+    readonly targetPath: string;
+    readonly transform?: (data: T) => unknown;
+    readonly autoRefresh?: boolean;
+}
+/**
+ * Data binding state
+ */
+export type DataBindingState = 'idle' | 'loading' | 'loaded' | 'error' | 'stale';
+/**
+ * Live data binding with current state and subscription
+ */
+export interface LiveDataBinding<T = unknown> {
+    readonly binding: DataBinding<T>;
+    readonly state: DataBindingState;
+    readonly data: T | undefined;
+    readonly error: DataFetchError | undefined;
+    refresh(): Promise<DataFetchResult<T>>;
+    subscribe(listener: DataBindingListener<T>): () => void;
+}
+/**
+ * Listener for data binding changes
+ */
+export type DataBindingListener<T> = (data: T | undefined, state: DataBindingState) => void;
+/**
+ * Configuration for DataService instances.
+ * Can be provided by the capability registry or directly.
+ */
+export interface DataServiceConfig {
+    readonly defaultCacheTtl?: number;
+    readonly maxRetries?: number;
+    readonly timeout?: number;
+    /**
+     * resolves the live token for a source's
+     * `authProviderRef`. Supplied by the host (the runner hands over the same
+     * PKCE bridge the engine registry is constructed with). Absent, every
+     * request goes out unauthenticated, exactly as before.
+     */
+    readonly getAccessToken?: (ref?: string) => Promise<string | null>;
+    /**
+     * The platform's own API origin — and ONLY requests to it carry credentials.
+     *
+     * The platform store is a REST resource like any other, so it goes through
+     * the same engine; the one thing that differs is that it authenticates by
+     * cookie. `credentials` is therefore decided by origin, never by default:
+     * `'same-origin'` is what fetch does on its own, and a published app served
+     * at `<slug>.apps.example.com` calling `api.example.com` is cross-origin, so
+     * the default would silently drop the cookie. Absent, nothing is ever sent
+     * anywhere — a cookie must never leak to a third party's endpoint.
+     */
+    readonly platformApiOrigin?: string;
+}
+/**
+ * Service interface for managing data sources and bindings.
+ *
+ * Renamed from DataCapability to avoid overloading "capability" —
+ * this is a service, not a registry capability declaration.
+ */
+export interface DataServiceInterface {
+    registerSource<T>(definition: DataSourceDefinition<T>): void;
+    resolveDataSource(sourceId: string): DataSourceDefinition | undefined;
+    hasSource(sourceId: string): boolean;
+    fetchData<T>(sourceId: string, options?: DataFetchOptions): Promise<DataFetchResult<T>>;
+    bindData<T>(binding: DataBinding<T>): LiveDataBinding<T>;
+    unregisterSource(sourceId: string): boolean;
+    getSourceIds(): readonly string[];
+    clear(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/data/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;AAEjF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;IAChC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CACtC;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAA;AAE/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAA;IAC3F;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAA;IAC1C,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAA;CACxD;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAM3F;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAClE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC5D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAA;IACrE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IACxD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3C,YAAY,IAAI,SAAS,MAAM,EAAE,CAAA;IACjC,KAAK,IAAI,IAAI,CAAA;CACd"}

package/dist/data/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/data/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":""}

package/dist/entity/aggregate.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorAggregateResult, ConnectorQueryResult } from './connector.js';
+import type { EntityAggregate, EntityQuery, EntityTypeId } from './types.js';
+/** The least a source needs: `query`, and `aggregate` when it has one. */
+export interface AggregateSource {
+    query(entityType: EntityTypeId, query: EntityQuery): Promise<ConnectorQueryResult>;
+    aggregate?(entityType: EntityTypeId, aggregate: EntityAggregate): Promise<ConnectorAggregateResult>;
+}
+export declare function aggregateThrough(source: AggregateSource, entityType: EntityTypeId, aggregate: EntityAggregate): Promise<ConnectorAggregateResult>;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/entity/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/entity/aggregate.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE5E,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClF,SAAS,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;CACpG;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,YAAY,EACxB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAKnC"}

package/dist/entity/aggregate.js

@@ -0,0 +1,24 @@
+/**
+ * aggregateThrough — one number from whatever can answer.
+ *
+ * The platform connector asks the server (`HttpEntityConnector.aggregate`).
+ * Everything else — the static connector, a declared engine, a host facade
+ * that predates `resolveAggregate` — only lists. Rather than make every one
+ * of them grow an aggregate, the store and the renderer go through here: a
+ * source with `aggregate` is asked, a source without is queried with the
+ * aggregate's filter and reduced in memory (`aggregateEntities`). The
+ * fallback reduces the rows the query RETURNS — a paginated list connector
+ * counts its first page — which is why the platform path is server-side.
+ *
+ * @module @pwfabric/runtime/entity/aggregate
+ */
+import { aggregateEntities } from './apply-query.js';
+export async function aggregateThrough(source, entityType, aggregate) {
+    if (typeof source.aggregate === 'function')
+        return source.aggregate(entityType, aggregate);
+    const res = await source.query(entityType, aggregate.filter ? { filter: aggregate.filter } : {});
+    if (!res.success)
+        return res;
+    return { success: true, result: aggregateEntities(res.result.items, aggregate) };
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/entity/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../src/entity/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAUpD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAuB,EACvB,UAAwB,EACxB,SAA0B;IAE1B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAC1F,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAChG,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,GAAG,CAAA;IAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;AAClF,CAAC"}

package/dist/entity/apply-query.d.ts

@@ -0,0 +1,59 @@
+/**
+ * applyEntityQuery — the ONE place an `EntityQuery` is actually applied.
+ *
+ * Engines typically read the filter only as a NAMED-PARAMETER lookup
+ * (`ctx.filter('siteId')`) and apply neither `operator` nor sort/pagination,
+ * so a pattern that declared
+ * `{ filter: { field: 'isRead', operator: 'eq', value: false } }` would be
+ * silently ignored. Connectors call this on their result envelope so the
+ * declared query is honoured client-side regardless of what the upstream API
+ * supports.
+ *
+ * Semantics:
+ *   - filter: one node = `field operator value`; `and[]` / `or[]` combine
+ *     child nodes with the node's own test (a node with no `field` is pure
+ *     combinator). Missing fields compare as `undefined`.
+ *   - sort: stable multi-key; numbers/dates/strings compared natively,
+ *     `null`/`undefined` last in both directions.
+ *   - pagination: `{ offset, limit }` slice AFTER filter+sort; `total` is the
+ *     filtered count, `hasMore` is offset+limit < total.
+ *
+ * @module @pwfabric/runtime/entity/apply-query
+ */
+import type { EntityAggregate, EntityAggregateResult, EntityFilter, EntityQuery, EntityQueryResult, EntitySortField } from './types.js';
+type Row = Record<string, unknown>;
+/** Evaluate one filter node (leaf test + and/or combinators) against a row. */
+export declare function matchesEntityFilter(row: Row, filter: EntityFilter): boolean;
+/** Stable multi-key sort; nullish values sort last in both directions. */
+export declare function sortEntities<T extends Row>(items: readonly T[], sort: readonly EntitySortField[]): T[];
+/**
+ * Every shape a sort is written in, as the one the sorter takes.
+ *
+ * WHY: the contract says `sort: EntitySortField[]`, but pages and models write
+ * a single object far more often: `{ field: 'date', direction: 'asc' }`. It
+ * has no `length`, so the old `query.sort.length > 0` test read it as "no
+ * sort" and the list came back in storage order, silently. Accepted now:
+ *
+ *   [{ field, direction }]          the contract shape (invalid entries dropped)
+ *   { field, direction? }           one sort key
+ *   { date: 'desc', title: 'asc' }  a field → direction map, in key order
+ *   'date' | '-date'                a field name, `-` for descending
+ *
+ * A missing or unknown direction reads as ascending. Anything else is no sort.
+ */
+export declare function normalizeEntitySort(sort: unknown): EntitySortField[];
+/**
+ * Reduce an in-memory list to ONE NUMBER — the client half of what the
+ * platform's `/count` and `/aggregate` routes do server-side, for connectors
+ * that only list. `filter` narrows first; `count` is the kept rows; the rest
+ * read `field` as a number (a numeric string counts, nullish/NaN is skipped)
+ * and answer `null` when nothing was numeric.
+ */
+export declare function aggregateEntities(items: readonly Row[], aggregate: EntityAggregate): EntityAggregateResult;
+/**
+ * Apply filter → sort → pagination to an in-memory list and return the
+ * paginated envelope. An empty/undefined query returns everything.
+ */
+export declare function applyEntityQuery<T extends Row>(items: readonly T[], query: EntityQuery | undefined): EntityQueryResult<T>;
+export {};
+//# sourceMappingURL=apply-query.d.ts.map

package/dist/entity/apply-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-query.d.ts","sourceRoot":"","sources":["../../src/entity/apply-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AA+GlC,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAc3E;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,CAAC,EAAE,CAmBtG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAwBpE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,SAAS,EAAE,eAAe,GAAG,qBAAqB,CA0B1G;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,WAAW,GAAG,SAAS,GAC7B,iBAAiB,CAAC,CAAC,CAAC,CAatB"}

package/dist/entity/apply-query.js

@@ -0,0 +1,264 @@
+function readField(row, field) {
+    if (field in row)
+        return row[field];
+    // dotted path (`owner.displayName`)
+    let cur = row;
+    for (const part of field.split('.')) {
+        if (cur === null || cur === undefined || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function toComparable(v) {
+    if (v === null || v === undefined)
+        return undefined;
+    if (typeof v === 'number' || typeof v === 'string')
+        return v;
+    if (typeof v === 'boolean')
+        return v ? 1 : 0;
+    if (v instanceof Date)
+        return v.getTime();
+    return String(v);
+}
+/** Loose equality for filter values: `'3' eq 3`, `true eq 'true'`, dates by time. */
+function looseEq(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    if (a instanceof Date || b instanceof Date) {
+        const ta = a instanceof Date ? a.getTime() : new Date(String(a)).getTime();
+        const tb = b instanceof Date ? b.getTime() : new Date(String(b)).getTime();
+        return Number.isFinite(ta) && ta === tb;
+    }
+    if (typeof a === 'object' || typeof b === 'object')
+        return false;
+    return String(a) === String(b);
+}
+/** A string that is a number and nothing else — `"95"`, `"-3.5"`, `"1e3"`; not `""`, not a date. */
+const NUMERIC = /^\s*[-+]?(\d+\.?\d*|\.\d+)(e[-+]?\d+)?\s*$/i;
+/** The number a comparable reads as, or undefined when it is not number-looking. */
+function numericValue(v) {
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : undefined;
+    if (!NUMERIC.test(v))
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+function compareOrdered(a, b) {
+    const ca = toComparable(a);
+    const cb = toComparable(b);
+    if (ca === undefined || cb === undefined)
+        return undefined;
+    if (typeof ca === 'number' && typeof cb === 'number')
+        return ca - cb;
+    // A number-looking string is a number here. A form saves what was typed, so
+    // `price` is "95" on one row and 100 on the next; compared as strings
+    // "95" > "100", and `price gt 100` would keep the cheaper item.
+    //
+    // TOTAL ORDER: number-looking values are one class, compared
+    // numerically, and sort BEFORE every other value; the rest (ISO dates,
+    // text) compare as strings. Comparing a number with text as text made a
+    // cycle on a mixed column ("2" < "10" < "1a" < "2") and the sort order
+    // depended on the input. Note: "007" reads as 7 — leading-zero codes sort
+    // numerically and tie their unpadded value.
+    const na = numericValue(ca);
+    const nb = numericValue(cb);
+    if (na !== undefined && nb !== undefined)
+        return na - nb;
+    if (na !== undefined)
+        return -1;
+    if (nb !== undefined)
+        return 1;
+    // ISO date strings compare correctly as strings; text compares as text
+    const sa = String(ca);
+    const sb = String(cb);
+    return sa < sb ? -1 : sa > sb ? 1 : 0;
+}
+function testLeaf(actual, operator, expected) {
+    switch (operator) {
+        case 'eq':
+            return looseEq(actual, expected);
+        case 'neq':
+            return !looseEq(actual, expected);
+        case 'gt': {
+            const c = compareOrdered(actual, expected);
+            return c !== undefined && c > 0;
+        }
+        case 'gte': {
+            const c = compareOrdered(actual, expected);
+            return c !== undefined && c >= 0;
+        }
+        case 'lt': {
+            const c = compareOrdered(actual, expected);
+            return c !== undefined && c < 0;
+        }
+        case 'lte': {
+            const c = compareOrdered(actual, expected);
+            return c !== undefined && c <= 0;
+        }
+        case 'in': {
+            const set = Array.isArray(expected) ? expected : [expected];
+            return set.some((e) => looseEq(actual, e));
+        }
+        case 'contains': {
+            if (Array.isArray(actual))
+                return actual.some((x) => looseEq(x, expected));
+            if (actual === null || actual === undefined)
+                return false;
+            return String(actual).toLowerCase().includes(String(expected).toLowerCase());
+        }
+        case 'startsWith': {
+            if (actual === null || actual === undefined)
+                return false;
+            return String(actual).toLowerCase().startsWith(String(expected).toLowerCase());
+        }
+        default:
+            return false;
+    }
+}
+/** Evaluate one filter node (leaf test + and/or combinators) against a row. */
+export function matchesEntityFilter(row, filter) {
+    // A leaf needs something to compare against. Every operator in the union
+    // takes a value, so `value: undefined` is not a constraint the author wrote —
+    // it is a control with no selection (see resolveQueryState) — and a node
+    // without a constraint matches, rather than eliminating every row.
+    const hasLeaf = typeof filter.field === 'string' &&
+        filter.field !== '' &&
+        filter.operator !== undefined &&
+        filter.value !== undefined;
+    const leaf = hasLeaf ? testLeaf(readField(row, filter.field), filter.operator, filter.value) : true;
+    const andOk = filter.and && filter.and.length > 0 ? filter.and.every((f) => matchesEntityFilter(row, f)) : true;
+    const orOk = filter.or && filter.or.length > 0 ? filter.or.some((f) => matchesEntityFilter(row, f)) : true;
+    return leaf && andOk && orOk;
+}
+/** Stable multi-key sort; nullish values sort last in both directions. */
+export function sortEntities(items, sort) {
+    if (sort.length === 0)
+        return [...items];
+    return items
+        .map((item, index) => ({ item, index }))
+        .sort((a, b) => {
+        for (const s of sort) {
+            const va = readField(a.item, s.field);
+            const vb = readField(b.item, s.field);
+            const na = va === null || va === undefined;
+            const nb = vb === null || vb === undefined;
+            if (na && nb)
+                continue;
+            if (na)
+                return 1;
+            if (nb)
+                return -1;
+            const c = compareOrdered(va, vb) ?? 0;
+            if (c !== 0)
+                return s.direction === 'desc' ? -c : c;
+        }
+        return a.index - b.index;
+    })
+        .map((x) => x.item);
+}
+/**
+ * Every shape a sort is written in, as the one the sorter takes.
+ *
+ * WHY: the contract says `sort: EntitySortField[]`, but pages and models write
+ * a single object far more often: `{ field: 'date', direction: 'asc' }`. It
+ * has no `length`, so the old `query.sort.length > 0` test read it as "no
+ * sort" and the list came back in storage order, silently. Accepted now:
+ *
+ *   [{ field, direction }]          the contract shape (invalid entries dropped)
+ *   { field, direction? }           one sort key
+ *   { date: 'desc', title: 'asc' }  a field → direction map, in key order
+ *   'date' | '-date'                a field name, `-` for descending
+ *
+ * A missing or unknown direction reads as ascending. Anything else is no sort.
+ */
+export function normalizeEntitySort(sort) {
+    const dir = (d) => typeof d === 'string' && d.toLowerCase() === 'desc' ? 'desc' : 'asc';
+    const one = (s) => {
+        if (typeof s === 'string') {
+            const t = s.trim();
+            if (!t || t === '-')
+                return null;
+            return t.startsWith('-') ? { field: t.slice(1), direction: 'desc' } : { field: t, direction: 'asc' };
+        }
+        if (s && typeof s === 'object' && !Array.isArray(s)) {
+            const o = s;
+            if (typeof o['field'] === 'string' && o['field'])
+                return { field: o['field'], direction: dir(o['direction']) };
+        }
+        return null;
+    };
+    if (Array.isArray(sort))
+        return sort.map(one).filter((s) => s !== null);
+    const single = one(sort);
+    if (single)
+        return [single];
+    if (sort && typeof sort === 'object') {
+        return Object.entries(sort)
+            .filter(([field, d]) => field.length > 0 && typeof d === 'string')
+            .map(([field, d]) => ({ field, direction: dir(d) }));
+    }
+    return [];
+}
+/**
+ * Reduce an in-memory list to ONE NUMBER — the client half of what the
+ * platform's `/count` and `/aggregate` routes do server-side, for connectors
+ * that only list. `filter` narrows first; `count` is the kept rows; the rest
+ * read `field` as a number (a numeric string counts, nullish/NaN is skipped)
+ * and answer `null` when nothing was numeric.
+ */
+export function aggregateEntities(items, aggregate) {
+    const filter = aggregate.filter;
+    const rows = filter ? items.filter((r) => matchesEntityFilter(r, filter)) : items;
+    const base = { fn: aggregate.fn, ...(aggregate.field ? { field: aggregate.field } : {}), count: rows.length };
+    if (aggregate.fn === 'count')
+        return { ...base, value: rows.length };
+    if (!aggregate.field)
+        return { ...base, value: null };
+    const field = aggregate.field;
+    const nums = [];
+    for (const r of rows) {
+        const v = readField(r, field);
+        if (v === null || v === undefined || v === '')
+            continue;
+        const n = typeof v === 'number' ? v : Number(v);
+        if (Number.isFinite(n))
+            nums.push(n);
+    }
+    if (nums.length === 0)
+        return { ...base, value: null };
+    // A loop, never a spread: `Math.x(...nums)` overflows the argument limit
+    // on the large in-memory lists this path exists for.
+    const sum = nums.reduce((a, b) => a + b, 0);
+    switch (aggregate.fn) {
+        case 'sum':
+            return { ...base, value: sum };
+        case 'avg':
+            return { ...base, value: sum / nums.length };
+        default:
+            return { ...base, value: null };
+    }
+}
+/**
+ * Apply filter → sort → pagination to an in-memory list and return the
+ * paginated envelope. An empty/undefined query returns everything.
+ */
+export function applyEntityQuery(items, query) {
+    let out = [...items];
+    if (query?.filter) {
+        const f = query.filter;
+        out = out.filter((row) => matchesEntityFilter(row, f));
+    }
+    const sort = normalizeEntitySort(query?.sort);
+    if (sort.length > 0)
+        out = sortEntities(out, sort);
+    const total = out.length;
+    const offset = Math.max(0, query?.pagination?.offset ?? 0);
+    const limit = query?.pagination?.limit !== undefined ? Math.max(0, query.pagination.limit) : total;
+    const page = query?.pagination ? out.slice(offset, offset + limit) : out;
+    return { items: page, total, offset, limit, hasMore: offset + page.length < total };
+}
+//# sourceMappingURL=apply-query.js.map

package/dist/entity/apply-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-query.js","sourceRoot":"","sources":["../../src/entity/apply-query.ts"],"names":[],"mappings":"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"}