@wssto2/vue-core 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.5.4 — 2026-10-14
+
+A route says what its envelope's `meta` is, so a paged list reads its numbers with no cast. Needed by go-core v1.8.7's route tables.
+
+### New
+- **`route<In, Out, Meta = unknown>`** (and `ApiRoute<In, Out, Meta>`, `RouteResult<Out, Meta>`): a route can declare the type of go-core's top-level `meta`, and `client.request` resolves to `ApiResult<Out, Meta>`. A route without a meta type is unchanged (`meta: unknown`).
+- **`PageMeta`** from `/client`: what go-core's `route.Page[T]` (`web.PageMeta`) writes: `total`, `page`, `per_page`, `last_page`, `from`, `to`, optional `views`, and any other key as `unknown`.
+- **`readListPage`** accepts an `ApiResult<Row[], PageMeta>` with no cast.
+
 ## 0.5.3 — 2026-10-13
 
 The access rows on a phone.

package/dist/client/client.d.ts

@@ -38,7 +38,7 @@ export interface HttpClientOptions {
 /** A route that takes no input (`void`, or an empty object) needs no second argument. */
 type RequestArguments<In> = [In] extends [void] ? [input?: undefined, options?: RequestOptions] : [In] extends [Record<string, never>] ? [input?: In, options?: RequestOptions] : [input: In, options?: RequestOptions];
 /** A route declared `void` has no body: its data is `null`. */
-export type RouteResult<Out> = ApiResult<[Out] extends [void] ? null : Out>;
+export type RouteResult<Out, Meta = unknown> = ApiResult<[Out] extends [void] ? null : Out, Meta>;
 export interface HttpClient {
     /**
      * Calls a declared route: `:name` segments of the path are filled from `input` (encoded), the rest of
@@ -46,7 +46,7 @@ export interface HttpClient {
      * parameter rejects with a plain `Error` (a bug in the caller, not an answer from the server) before
      * anything is sent. Abort, request ids and 401 handling are those of `get` and `post`.
      */
-    request<In, Out>(route: ApiRoute<In, Out>, ...args: RequestArguments<In>): Promise<RouteResult<Out>>;
+    request<In, Out, Meta>(route: ApiRoute<In, Out, Meta>, ...args: RequestArguments<In>): Promise<RouteResult<Out, Meta>>;
     get<TData = unknown, TMeta = unknown>(path: string, options?: RequestOptions): Promise<ApiResult<TData, TMeta>>;
     post<TData = unknown, TMeta = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<ApiResult<TData, TMeta>>;
     put<TData = unknown, TMeta = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<ApiResult<TData, TMeta>>;

package/dist/client/index.d.ts

@@ -8,4 +8,4 @@ export type { ApiErrorInit, ApiErrorKind, FieldErrors } from "./error";
 export { fetchTransport } from "./transport";
 export type { Transport } from "./transport";
 export { route } from "./route";
-export type { HttpMethod, ListResult, RawRoute, ApiRoute, RouteOptions, ViewCount } from "./route";
+export type { HttpMethod, ListResult, PageMeta, RawRoute, ApiRoute, RouteOptions, ViewCount } from "./route";

package/dist/client/route.d.ts

@@ -13,13 +13,18 @@ interface RouteBase {
     readonly permission?: string;
     readonly public: boolean;
 }
-/** A typed call: `In` is what `client.request` takes, `Out` what it resolves to (`void`: no body). */
-export interface ApiRoute<In, Out> extends RouteBase {
+/**
+ * A typed call: `In` is what `client.request` takes, `Out` what it resolves to (`void`: no body), `Meta` the
+ * envelope's top-level `meta` (go-core `route.WithMeta` / `route.Page`). `Meta` defaults to `unknown`, not
+ * `never`: a route that declares none may still be answered with a meta, and `unknown` makes the caller narrow it.
+ */
+export interface ApiRoute<In, Out, Meta = unknown> extends RouteBase {
     readonly raw: false;
     /** Type-only; never set. */
     readonly [types]?: {
         readonly in: In;
         readonly out: Out;
+        readonly meta: Meta;
     };
 }
 /** A route without a JSON answer (an event stream, a file): it keeps method and path for links, `client.request` refuses it. */
@@ -30,8 +35,9 @@ export interface RawRoute extends RouteBase {
  * Declares one endpoint. go-core's generator writes these; the types come from the Go input and response.
  *
  *   route<ShowInput, Ticket>("GET", "/v1/tickets/:id", { permission: "tickets.ticket:view" })
+ *   route<ListInput, Ticket[], PageMeta>("GET", "/v1/tickets")   // a page: `result.meta` is a PageMeta
  */
-export declare function route<In, Out>(method: HttpMethod, path: string, options?: RouteOptions): ApiRoute<In, Out>;
+export declare function route<In, Out, Meta = unknown>(method: HttpMethod, path: string, options?: RouteOptions): ApiRoute<In, Out, Meta>;
 export declare namespace route {
     var raw: (method: HttpMethod, path: string, options?: RouteOptions) => RawRoute;
 }
@@ -40,6 +46,19 @@ export interface ViewCount {
     readonly key: string;
     readonly count: number;
 }
+/**
+ * The `meta` go-core's `web.PageMeta` writes next to a page of rows (`route.Page[T]`); other keys
+ * (lookups, totals) may sit beside these. `readListPage` reads an `ApiResult<Row[], PageMeta>` with no cast.
+ */
+export type PageMeta = Readonly<Record<string, unknown>> & {
+    readonly total: number;
+    readonly page: number;
+    readonly per_page: number;
+    readonly last_page: number;
+    readonly from: number;
+    readonly to: number;
+    readonly views?: readonly ViewCount[];
+};
 /**
  * The wire shape of go-core's `datatable.DatatableResult[T]`: a page of rows with its numbers.
  * `readListPage` (`/collection`) reads it into a `ListPage` with no glue.

package/dist/collection/http.d.ts

@@ -1,4 +1,4 @@
-import type { ApiResult, HttpClient, ListResult, QueryValue } from "../client";
+import type { ApiResult, HttpClient, ListResult, PageMeta, QueryValue } from "../client";
 import type { CollectionLoader, ListPage, CollectionQuery } from "./types";
 /**
  * The query parameters go-core's datatable reads: `page`, `per_page`, `order_col`, `order_dir`,
@@ -8,10 +8,11 @@ export declare function listParams(query: CollectionQuery): Record<string, Query
 /**
  * Reads a list answer into a `ListPage`. Understands go-core's envelope (`data` is the rows,
  * `meta` has `total`, `page`, `per_page`, `last_page`, `from`, `to`, and may carry `views` and lookups)
- * and the shape with the numbers next to `data` (`current_page`), which is `ListResult<Row>`: pass a typed
+ * and the shape with the numbers next to `data` (`current_page`), which is `ListResult<Row>`; a `route.Page` route answers `Row[]` with a `PageMeta`. Pass a typed
  * route's result (`client.request(route, input)`) and `Row` is inferred. Missing numbers are derived
  * from what is there rather than becoming 0; `query` supplies the page and size that were asked for.
  */
+export declare function readListPage<Row>(result: ApiResult<readonly Row[], PageMeta>, query: Pick<CollectionQuery, "page" | "pageSize">): ListPage<Row>;
 export declare function readListPage<Row>(result: ApiResult<ListResult<Row>, unknown>, query: Pick<CollectionQuery, "page" | "pageSize">): ListPage<Row>;
 export declare function readListPage<Row>(result: ApiResult<unknown, unknown>, query: Pick<CollectionQuery, "page" | "pageSize">): ListPage<Row>;
 /**

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 /** The version of @wssto2/vue-core (kept equal to package.json by index.test.ts). */
-export declare const version = "0.5.3";
+export declare const version = "0.5.4";

package/dist/index.js

@@ -1,4 +1,4 @@
-const o = "0.5.3";
+const o = "0.5.4";
 export {
   o as version
 };

package/dist/modules/access/routes.d.ts

@@ -1,16 +1,16 @@
 import type { BindableRoles, Binding, Replaced, Role, RoleComparison, RoleHolders, RoleList, ScopeOptions, SubjectAccess } from "./entities";
 export declare const accessRoutes: {
-    readonly rolesList: import("../../client").ApiRoute<void, RoleList>;
+    readonly rolesList: import("../../client").ApiRoute<void, RoleList, unknown>;
     readonly rolesShow: import("../../client").ApiRoute<{
         ref: string;
-    }, Role>;
+    }, Role, unknown>;
     readonly rolesHolders: import("../../client").ApiRoute<{
         ref: string;
-    }, RoleHolders>;
+    }, RoleHolders, unknown>;
     readonly rolesCompare: import("../../client").ApiRoute<{
         ref: string;
         with: string;
-    }, RoleComparison>;
+    }, RoleComparison, unknown>;
     readonly rolesCreate: import("../../client").ApiRoute<{
         name: string;
         description: string;
@@ -22,7 +22,7 @@ export declare const accessRoutes: {
             attribute: string;
             values: string[];
         }[];
-    }, Role>;
+    }, Role, unknown>;
     readonly rolesUpdate: import("../../client").ApiRoute<{
         ref: string;
         name: string;
@@ -35,33 +35,33 @@ export declare const accessRoutes: {
             attribute: string;
             values: string[];
         }[];
-    }, Role>;
+    }, Role, unknown>;
     readonly rolesDelete: import("../../client").ApiRoute<{
         ref: string;
-    }, void>;
+    }, void, unknown>;
     readonly rolesReplace: import("../../client").ApiRoute<{
         ref: string;
         with: string;
-    }, Replaced>;
+    }, Replaced, unknown>;
     readonly bindable: import("../../client").ApiRoute<{
         level: string;
         scope_id: number;
-    }, BindableRoles>;
+    }, BindableRoles, unknown>;
     readonly subjectsAccess: import("../../client").ApiRoute<{
         id: number;
-    }, SubjectAccess>;
+    }, SubjectAccess, unknown>;
     readonly subjectsScopes: import("../../client").ApiRoute<{
         id: number;
-    }, ScopeOptions>;
+    }, ScopeOptions, unknown>;
     readonly subjectsBind: import("../../client").ApiRoute<{
         id: number;
         role_ref: string;
         level: string;
         scope_id?: number | null | undefined;
-    }, Binding>;
+    }, Binding, unknown>;
     readonly subjectsUnbind: import("../../client").ApiRoute<{
         id: number;
         binding_id: number;
-    }, void>;
+    }, void, unknown>;
     readonly me: import("../../client").RawRoute;
 };

package/dist/modules/events/routes.d.ts

@@ -5,13 +5,13 @@ export declare const eventsRoutes: {
         consumer?: string | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<DeadLetterRow>>;
+    }, ListResult<DeadLetterRow>, unknown>;
     readonly deadLettersRetry: import("../../client").ApiRoute<{
         event: number;
         consumer: string;
-    }, Retried>;
+    }, Retried, unknown>;
     readonly deadLettersRetryAll: import("../../client").ApiRoute<{
         consumer: string;
-    }, Retried>;
-    readonly consumers: import("../../client").ApiRoute<void, ConsumerNames>;
+    }, Retried, unknown>;
+    readonly consumers: import("../../client").ApiRoute<void, ConsumerNames, unknown>;
 };

package/dist/modules/identity/routes.d.ts

@@ -4,19 +4,19 @@ export declare const identityRoutes: {
     readonly login: import("../../client").ApiRoute<{
         login: string;
         password: string;
-    }, SessionResponse>;
+    }, SessionResponse, unknown>;
     readonly refresh: import("../../client").ApiRoute<{
         refresh_token: string;
-    }, SessionResponse>;
-    readonly logout: import("../../client").ApiRoute<void, void>;
-    readonly me: import("../../client").ApiRoute<void, SessionResponse>;
+    }, SessionResponse, unknown>;
+    readonly logout: import("../../client").ApiRoute<void, void, unknown>;
+    readonly me: import("../../client").ApiRoute<void, SessionResponse, unknown>;
     readonly changeLocale: import("../../client").ApiRoute<{
         locale: string;
-    }, void>;
+    }, void, unknown>;
     readonly loginAs: import("../../client").ApiRoute<{
         user_id: number;
-    }, SessionResponse>;
-    readonly loginAsReturn: import("../../client").ApiRoute<void, SessionResponse>;
+    }, SessionResponse, unknown>;
+    readonly loginAsReturn: import("../../client").ApiRoute<void, SessionResponse, unknown>;
     readonly usersList: import("../../client").ApiRoute<{
         view?: "inactive" | "all" | "locked" | "active" | undefined;
         search?: string | undefined;
@@ -24,10 +24,10 @@ export declare const identityRoutes: {
         order_dir?: string | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<UserRow>>;
+    }, ListResult<UserRow>, unknown>;
     readonly usersShow: import("../../client").ApiRoute<{
         id: number;
-    }, UserDetail>;
+    }, UserDetail, unknown>;
     readonly usersCreate: import("../../client").ApiRoute<{
         login: string;
         name: string;
@@ -35,7 +35,7 @@ export declare const identityRoutes: {
         locale: string;
         password: string;
         phone?: string | undefined;
-    }, UserDetail>;
+    }, UserDetail, unknown>;
     readonly usersUpdate: import("../../client").ApiRoute<{
         id: number;
         login: string;
@@ -43,32 +43,32 @@ export declare const identityRoutes: {
         email: string;
         locale: string;
         phone?: string | undefined;
-    }, UserDetail>;
+    }, UserDetail, unknown>;
     readonly usersSetPassword: import("../../client").ApiRoute<{
         id: number;
         password: string;
-    }, void>;
+    }, void, unknown>;
     readonly usersDeactivate: import("../../client").ApiRoute<{
         id: number;
-    }, void>;
+    }, void, unknown>;
     readonly usersActivate: import("../../client").ApiRoute<{
         id: number;
-    }, void>;
+    }, void, unknown>;
     readonly usersUnlock: import("../../client").ApiRoute<{
         id: number;
-    }, UnlockResult>;
+    }, UnlockResult, unknown>;
     readonly usersSignins: import("../../client").ApiRoute<{
         id: number;
         view?: "all" | "failed" | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<SignInRow>>;
+    }, ListResult<SignInRow>, unknown>;
     readonly usersChanges: import("../../client").ApiRoute<{
         id: number;
         view?: "details" | "all" | "access" | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<ChangeRow>>;
+    }, ListResult<ChangeRow>, unknown>;
     readonly usersActivity: import("../../client").ApiRoute<{
         id: number;
         area?: string | undefined;
@@ -76,43 +76,43 @@ export declare const identityRoutes: {
         to?: string | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<ActivityRow>>;
+    }, ListResult<ActivityRow>, unknown>;
     readonly usersSessions: import("../../client").ApiRoute<{
         id: number;
-    }, SessionList>;
+    }, SessionList, unknown>;
     readonly usersRevokeSession: import("../../client").ApiRoute<{
         id: number;
         session_id: number;
-    }, void>;
+    }, void, unknown>;
     readonly usersRevokeSessions: import("../../client").ApiRoute<{
         id: number;
-    }, void>;
-    readonly profileShow: import("../../client").ApiRoute<void, ProfileResponse>;
+    }, void, unknown>;
+    readonly profileShow: import("../../client").ApiRoute<void, ProfileResponse, unknown>;
     readonly profileUpdate: import("../../client").ApiRoute<{
         name: string;
         phone?: string | undefined;
-    }, ProfileResponse>;
+    }, ProfileResponse, unknown>;
     readonly profileChangePassword: import("../../client").ApiRoute<{
         current_password: string;
         new_password: string;
         new_password_confirmation: string;
-    }, void>;
+    }, void, unknown>;
     readonly profileRequestEmail: import("../../client").ApiRoute<{
         email: string;
         current_password: string;
-    }, PendingEmail>;
-    readonly profileResendEmail: import("../../client").ApiRoute<void, PendingEmail>;
+    }, PendingEmail, unknown>;
+    readonly profileResendEmail: import("../../client").ApiRoute<void, PendingEmail, unknown>;
     readonly profileConfirmEmail: import("../../client").ApiRoute<{
         code: string;
-    }, ProfileResponse>;
-    readonly profileCancelEmail: import("../../client").ApiRoute<void, void>;
+    }, ProfileResponse, unknown>;
+    readonly profileCancelEmail: import("../../client").ApiRoute<void, void, unknown>;
     readonly profileSignins: import("../../client").ApiRoute<{
         view?: "all" | "failed" | undefined;
         page?: number | undefined;
         per_page?: number | undefined;
-    }, ListResult<SignInRow>>;
-    readonly profileSessions: import("../../client").ApiRoute<void, SessionList>;
+    }, ListResult<SignInRow>, unknown>;
+    readonly profileSessions: import("../../client").ApiRoute<void, SessionList, unknown>;
     readonly profileRevokeSession: import("../../client").ApiRoute<{
         session_id: number;
-    }, void>;
+    }, void, unknown>;
 };

package/dist/modules/notification/routes.d.ts

@@ -3,48 +3,48 @@ export declare const notificationRoutes: {
     readonly list: import("../../client").ApiRoute<{
         before_id?: number | undefined;
         limit?: number | undefined;
-    }, Page>;
-    readonly unread: import("../../client").ApiRoute<void, UnreadCount>;
+    }, Page, unknown>;
+    readonly unread: import("../../client").ApiRoute<void, UnreadCount, unknown>;
     readonly read: import("../../client").ApiRoute<{
         id: number;
-    }, UnreadCount>;
+    }, UnreadCount, unknown>;
     readonly readAll: import("../../client").ApiRoute<{
         up_to_id: number;
-    }, UnreadCount>;
+    }, UnreadCount, unknown>;
     readonly stream: import("../../client").RawRoute;
-    readonly test: import("../../client").ApiRoute<void, void>;
-    readonly preferences: import("../../client").ApiRoute<void, Preferences>;
+    readonly test: import("../../client").ApiRoute<void, void, unknown>;
+    readonly preferences: import("../../client").ApiRoute<void, Preferences, unknown>;
     readonly preferencesSetEmail: import("../../client").ApiRoute<{
         category: string;
         email: boolean | null;
-    }, CategorySettings>;
+    }, CategorySettings, unknown>;
     readonly quietHours: import("../../client").ApiRoute<{
         enabled: boolean;
         start: number;
         end: number;
-    }, QuietHours>;
+    }, QuietHours, unknown>;
     readonly preferencesSetPush: import("../../client").ApiRoute<{
         category: string;
         push: boolean | null;
-    }, CategorySettings>;
-    readonly push: import("../../client").ApiRoute<void, PushConfig>;
-    readonly devices: import("../../client").ApiRoute<void, DeviceList>;
+    }, CategorySettings, unknown>;
+    readonly push: import("../../client").ApiRoute<void, PushConfig, unknown>;
+    readonly devices: import("../../client").ApiRoute<void, DeviceList, unknown>;
     readonly deviceSubscribe: import("../../client").ApiRoute<{
         endpoint: string;
         p256dh: string;
         auth: string;
-    }, Device>;
+    }, Device, unknown>;
     readonly deviceUnsubscribe: import("../../client").ApiRoute<{
         endpoint: string;
-    }, DeviceList>;
+    }, DeviceList, unknown>;
     readonly deviceRename: import("../../client").ApiRoute<{
         id: number;
         label: string;
-    }, Device>;
+    }, Device, unknown>;
     readonly deviceRemove: import("../../client").ApiRoute<{
         id: number;
-    }, DeviceList>;
+    }, DeviceList, unknown>;
     readonly deviceTest: import("../../client").ApiRoute<{
         id: number;
-    }, DeviceList>;
+    }, DeviceList, unknown>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wssto2/vue-core",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "goCore": "v1.8.0",
   "description": "Shared Vue 3 library for go-core applications: app shell, list / record / form pages and their controls.",
   "keywords": [