@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.11

package/dist/identity/ui/users/userListColumns.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admin → Users: the DataTable column contract (issue #67, epic #51).
+ *
+ * A sibling module rather than columns inlined in `UserList.tsx`, for the
+ * reason every migrated table in this epic follows: the column list is the
+ * table's PUBLIC shape — the thing a test, a CSV export and the two renderers
+ * all read — while the page component is just the state that feeds it. Keeping
+ * them apart means a test can assert the contract without mounting a page and
+ * mocking its fetch layer.
+ *
+ * ## What `GET /api/users` actually honours
+ *
+ * `sortable` and `filterable` are declared ONLY where the endpoint can serve
+ * them. Both default to `false` in the contract precisely because a control the
+ * page cannot answer looks live and does nothing. Read off
+ * `packages/platform-api/src/identity/users/dto/user-list-query.dto.ts`:
+ *
+ *   | query param | accepts                              | column here          |
+ *   | ----------- | ------------------------------------ | -------------------- |
+ *   | `sortBy`    | `email` \| `createdAt` \| `updatedAt` | `email`, `createdAt` |
+ *   | `sortOrder` | `asc` \| `desc`                      | —                    |
+ *   | `search`    | free text over email, displayName,   | `searchable` on      |
+ *   |             | providerDisplayName (case-insens.)   | `email`,`displayName`|
+ *   | `role`      | one role name (relation predicate)   | `roles`, `is` only   |
+ *   | `isActive`  | `'true'` \| `'false'`                | `isActive`, `is` only|
+ *
+ * Everything else is display-only. In particular `createdAt` is SORTABLE but
+ * not filterable — there is no date-range parameter — and `id` is neither.
+ *
+ * `roles` is filterable with `is` alone, not the enum default set: the API's
+ * `role` param compiles to `userRoles: { some: { role: { name } } }`, which can
+ * express "has this role" and nothing else. Offering `isNot` / `isAnyOf` would
+ * be three operators backed by one.
+ */
+import { Avatar, Box, Chip, Stack, Typography } from '@mui/material';
+/**
+ * Persistence key for `user_settings.dataTables`. A constant, never derived
+ * from the route or the heading: it is a storage key and must survive a rename.
+ */
+export const TABLE_ID = 'admin-users';
+/**
+ * Column ids that are also valid `sortBy` values, and the narrowing that keeps
+ * the two in step.
+ *
+ * `DataTableSortState.field` is a bare `string` — it comes back from a stored
+ * layout, which is user-writable JSON. Narrowing here rather than casting at
+ * the fetch boundary means a stale persisted sort on a column that has since
+ * lost `sortable` is dropped, not sent to an endpoint that would 400 on it.
+ */
+const SORTABLE_FIELDS = ['email', 'createdAt'];
+export function asUserSortField(field) {
+    return SORTABLE_FIELDS.find((candidate) => candidate === field);
+}
+/** Effective display name: the user's own override, else the provider's. */
+export function userDisplayName(user) {
+    return user.displayName || user.providerDisplayName || 'No name';
+}
+function formatDate(value) {
+    return new Date(value).toLocaleDateString();
+}
+/**
+ * The user list's columns.
+ *
+ * @param roles - the roles the Roles column can filter by (`GET /api/roles`),
+ *   with their labels. Without them the column offers no filter values.
+ * @returns the columns, in display order.
+ *
+ * @stability experimental
+ */
+export function buildUserColumns(roles = []) {
+    const roleEnumValues = roles.map((role) => ({ value: role.id, label: role.label }));
+    return [
+        {
+            /**
+             * The row-unique `primary` column, and therefore the row's ACCESSIBLE
+             * NAME: `rowAccessibleName()` takes the first visible `primary` column's
+             * scalar and names every selection checkbox ("Select ada\@example.com"),
+             * every row-action button and every card after it.
+             *
+             * The avatar lives INSIDE this column's `render` rather than in a column
+             * of its own. A thumbnail-only column has no scalar at all, so it would
+             * export as an empty CSV cell, sort by nothing, and — worst — if it came
+             * first it would hand `rowAccessibleName` an empty string and every
+             * checkbox on the page would fall back to a UUID.
+             *
+             * `hideable: false` for the same reason: a user who hid this column would
+             * be renaming every control on the page after whichever column happened
+             * to be `primary` next.
+             */
+            id: 'email',
+            label: 'Email',
+            priority: 'primary',
+            sortable: true, // sortBy=email
+            searchable: true, // covered by ?search=
+            hideable: false,
+            minWidth: 240,
+            flex: 1.4,
+            value: (user) => user.email,
+            render: (user) => (_jsxs(Stack, { direction: "row", spacing: 1, sx: { alignItems: 'center', minWidth: 0 }, children: [_jsx(Avatar, { src: user.profileImageUrl || undefined, alt: user.email, sx: { width: 32, height: 32, flexShrink: 0 }, children: user.email[0]?.toUpperCase() }), _jsx(Typography, { variant: "body2", noWrap: true, sx: { minWidth: 0 }, children: user.email })] })),
+        },
+        {
+            /**
+             * Not sortable — `sortBy` has no `isActive` member. Filterable with `is`
+             * only, mapped by the page onto `?isActive=true|false`.
+             */
+            id: 'isActive',
+            label: 'Status',
+            priority: 'primary',
+            filterable: ['is'],
+            filterType: 'enum',
+            enumValues: [
+                { value: 'active', label: 'Active' },
+                { value: 'inactive', label: 'Inactive' },
+            ],
+            width: 120,
+            value: (user) => (user.isActive ? 'Active' : 'Inactive'),
+            render: (user) => user.isActive ? (_jsx(Chip, { label: "Active", color: "success", size: "small" })) : (_jsx(Chip, { label: "Inactive", color: "error", size: "small" })),
+        },
+        {
+            id: 'displayName',
+            label: 'Display Name',
+            priority: 'secondary',
+            searchable: true, // ?search= covers displayName AND providerDisplayName
+            minWidth: 160,
+            flex: 1,
+            value: userDisplayName,
+        },
+        {
+            id: 'roles',
+            label: 'Roles',
+            priority: 'secondary',
+            filterable: ['is'], // ?role=<name>; see the module docblock
+            filterType: 'enum',
+            enumValues: roleEnumValues,
+            minWidth: 160,
+            value: (user) => user.roles.join(', '),
+            render: (user) => (_jsx(Box, { sx: { display: 'flex', gap: 0.5, flexWrap: 'wrap' }, children: user.roles.map((role) => (_jsx(Chip, { label: role, size: "small" }, role))) })),
+        },
+        {
+            id: 'createdAt',
+            label: 'Created',
+            priority: 'detail',
+            sortable: true, // sortBy=createdAt (the endpoint's default order)
+            width: 130,
+            value: (user) => formatDate(user.createdAt),
+        },
+        {
+            id: 'id',
+            label: 'ID',
+            priority: 'detail',
+            truncate: true,
+            minWidth: 160,
+            value: (user) => user.id,
+        },
+    ];
+}
+//# sourceMappingURL=userListColumns.js.map

package/dist/identity/ui/users/userListColumns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userListColumns.js","sourceRoot":"","sources":["../../../../src/identity/ui/users/userListColumns.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The npm name of this package, which holds React pages, components and hooks of the platform.
+ *
+ * A placeholder export so the build, the pack check and the smoke imports in
+ * CI have something to load end to end. Real slices arrive as subpath
+ * exports (`@marinoscar/platform-web/<slice>`).
+ *
+ * @stability experimental
+ */
+export declare const PLATFORM_PACKAGE: "@marinoscar/platform-web";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAG,0BAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * The npm name of this package, which holds React pages, components and hooks of the platform.
+ *
+ * A placeholder export so the build, the pack check and the smoke imports in
+ * CI have something to load end to end. Real slices arrive as subpath
+ * exports (`@marinoscar/platform-web/<slice>`).
+ *
+ * @stability experimental
+ */
+export const PLATFORM_PACKAGE = '@marinoscar/platform-web';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAAmC,CAAC"}

package/dist/jobs/headless/adapters.d.ts

@@ -0,0 +1,76 @@
+import type { ComponentType, ReactElement, ReactNode } from 'react';
+import type { JobsApi } from './api.js';
+import type { JobsDataTableComponent } from './table.js';
+/**
+ * What {@link JobsWebAdapters.Spinner} takes.
+ *
+ * @stability experimental
+ */
+export interface JobsSpinnerProps {
+    /** A whole-page wait. The jobs pages never ask for one. */
+    fullScreen?: boolean;
+}
+/**
+ * What the jobs pages take from the app. Every member is optional; keep the
+ * object a module constant.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/platform/jobsAdapters.ts
+ * export const appJobsAdapters: JobsWebAdapters = {
+ *   Spinner: LoadingSpinner,
+ *   DataTable,
+ *   api: createJobsApi(appPlatformApi),
+ * };
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface JobsWebAdapters {
+    /** The app's loading spinner. Default an MUI `CircularProgress`. */
+    Spinner?: ComponentType<JobsSpinnerProps>;
+    /** The app's table for the job, insights, fleet and credential lists. Default a plain MUI table. */
+    DataTable?: JobsDataTableComponent;
+    /** The jobs calls. Default `createJobsApi(usePlatformApi())`. */
+    api?: JobsApi;
+}
+/**
+ * Hands the app's {@link JobsWebAdapters} to every jobs page below it. Mount
+ * it once, around the signed-in shell.
+ *
+ * @param props - `adapters`: the app's adapters (a module constant); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <JobsWebAdaptersProvider adapters={appJobsAdapters}>{shell}</JobsWebAdaptersProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function JobsWebAdaptersProvider(props: {
+    adapters: JobsWebAdapters;
+    children: ReactNode;
+}): ReactElement;
+/**
+ * The adapters in context (an empty object without a provider).
+ *
+ * @returns the app's jobs adapters.
+ *
+ * @stability experimental
+ */
+export declare function useJobsWebAdapters(): JobsWebAdapters;
+/**
+ * The jobs client the hooks use: `explicit` when given, else the adapters'
+ * `api`, else `createJobsApi` over the platform host's transport.
+ *
+ * @param explicit - a client to use instead (keep its identity stable).
+ * @returns the client.
+ * @throws Error when none of the three is available.
+ *
+ * @stability experimental
+ */
+export declare function useJobsApi(explicit?: JobsApi): JobsApi;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/jobs/headless/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/jobs/headless/adapters.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC1C,oGAAoG;IACpG,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAqB/G;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAYtD"}

package/dist/jobs/headless/adapters.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// The jobs slice's app adapters (issue #854)
+// =============================================================================
+//
+// What the Jobs, Job Insights and Worker Nodes pages need from the app beyond
+// the platform host: the app's spinner and table (the app owns appearance),
+// and optionally the app's own jobs client. The identity slice's
+// `IdentityWebAdaptersProvider` is the model.
+//
+// Without a provider every adapter has a default: an MUI spinner, a plain MUI
+// table, and `createJobsApi(host.api)`.
+// =============================================================================
+import { createContext, useContext, useMemo } from 'react';
+import { useOptionalPlatformHost } from '../../core/index.js';
+import { NodesWebAdaptersProvider, useNodesWebAdapters } from '../../nodes/index.js';
+import { createJobsApi } from './api.js';
+const NO_ADAPTERS = Object.freeze({});
+const JobsWebAdaptersContext = createContext(NO_ADAPTERS);
+JobsWebAdaptersContext.displayName = 'JobsWebAdaptersContext';
+/**
+ * Hands the app's {@link JobsWebAdapters} to every jobs page below it. Mount
+ * it once, around the signed-in shell.
+ *
+ * @param props - `adapters`: the app's adapters (a module constant); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <JobsWebAdaptersProvider adapters={appJobsAdapters}>{shell}</JobsWebAdaptersProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function JobsWebAdaptersProvider(props) {
+    const { adapters } = props;
+    // The Worker Nodes page lives in `@marinoscar/platform-web/nodes` (#881) and
+    // reads `NodesWebAdapters`. Handing it the same spinner, table and client
+    // keeps an app that only wired the jobs adapters unchanged; a
+    // `NodesWebAdaptersProvider` the app mounted above this one still wins.
+    const outer = useNodesWebAdapters();
+    const nodesAdapters = useMemo(() => ({
+        ...(adapters.Spinner ? { Spinner: adapters.Spinner } : {}),
+        ...(adapters.DataTable ? { DataTable: adapters.DataTable } : {}),
+        ...(adapters.api ? { api: adapters.api } : {}),
+        ...outer,
+    }), [adapters, outer]);
+    return (_jsx(JobsWebAdaptersContext.Provider, { value: adapters, children: _jsx(NodesWebAdaptersProvider, { adapters: nodesAdapters, children: props.children }) }));
+}
+/**
+ * The adapters in context (an empty object without a provider).
+ *
+ * @returns the app's jobs adapters.
+ *
+ * @stability experimental
+ */
+export function useJobsWebAdapters() {
+    return useContext(JobsWebAdaptersContext);
+}
+/**
+ * The jobs client the hooks use: `explicit` when given, else the adapters'
+ * `api`, else `createJobsApi` over the platform host's transport.
+ *
+ * @param explicit - a client to use instead (keep its identity stable).
+ * @returns the client.
+ * @throws Error when none of the three is available.
+ *
+ * @stability experimental
+ */
+export function useJobsApi(explicit) {
+    const adapters = useJobsWebAdapters();
+    const hostApi = useOptionalPlatformHost()?.api;
+    const fromHost = useMemo(() => (hostApi ? createJobsApi(hostApi) : null), [hostApi]);
+    const api = explicit ?? adapters.api ?? fromHost;
+    if (!api) {
+        throw new Error('useJobsApi: no jobs client. Mount PlatformHostProvider (@marinoscar/platform-web/core) or ' +
+            'JobsWebAdaptersProvider with an `api`, or pass a client to the hook.');
+    }
+    return api;
+}
+//# sourceMappingURL=adapters.js.map

package/dist/jobs/headless/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../src/jobs/headless/adapters.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,6CAA6C;AAC7C,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,iEAAiE;AACjE,8CAA8C;AAC9C,EAAE;AACF,8EAA8E;AAC9E,wCAAwC;AACxC,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAwCzC,MAAM,WAAW,GAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvD,MAAM,sBAAsB,GAAG,aAAa,CAAkB,WAAW,CAAC,CAAC;AAC3E,sBAAsB,CAAC,WAAW,GAAG,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAyD;IAC/F,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC3B,6EAA6E;IAC7E,0EAA0E;IAC1E,8DAA8D;IAC9D,wEAAwE;IACxE,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,KAAK;KACT,CAAC,EACF,CAAC,QAAQ,EAAE,KAAK,CAAC,CAClB,CAAC;IACF,OAAO,CACL,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAC9C,KAAC,wBAAwB,IAAC,QAAQ,EAAE,aAAa,YAAG,KAAK,CAAC,QAAQ,GAA4B,GAC9D,CACnC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,QAAkB;IAC3C,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,uBAAuB,EAAE,EAAE,GAAG,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrF,MAAM,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,4FAA4F;YAC1F,sEAAsE,CACzE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/jobs/headless/api.d.ts

@@ -0,0 +1,44 @@
+import type { PlatformApiClient } from '../../core/index.js';
+import type { NodesApi } from '../../nodes/index.js';
+import type { Job, JobInsights, JobListParams, JobListResponse, JobStats, ResetHistoryResult, ResetStuckResult, RetryFailedResult } from './types.js';
+/**
+ * Every call the jobs pages and hooks make. `createJobsApi` builds one over
+ * the app's transport; a test or an app with its own client implements it.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface JobsApi extends NodesApi {
+    /** `GET /admin/jobs` with the filters, the activity window and the page. */
+    getJobs(params?: JobListParams): Promise<JobListResponse>;
+    /** `GET /admin/jobs/stats`: the queue summary (cached about 2 s by the API). */
+    getJobStats(): Promise<JobStats>;
+    /** `POST /admin/jobs/:id/retry`. The API refuses a `running` job (400). */
+    retryJob(id: string): Promise<Job>;
+    /** `DELETE /admin/jobs/:id`. 400 for a `running` job; 409 when the owning feature vetoes it (show its message). */
+    deleteJob(id: string): Promise<void>;
+    /** `POST /admin/jobs/retry-failed`: queue-wide, up to 500 per call, optionally one type. */
+    retryFailedJobs(type?: string): Promise<RetryFailedResult>;
+    /** `POST /admin/jobs/reset-stuck`: the lease reaper on demand; omitted, the `jobs.stuckThresholdMinutes` setting applies. */
+    resetStuckJobs(olderThanMinutes?: number): Promise<ResetStuckResult>;
+    /** `GET /admin/jobs/insights`; omitted, the API's default window (7 days). */
+    getJobInsights(windowDays?: number): Promise<JobInsights>;
+    /** `POST /admin/jobs/insights/reset-history`: clears the lifetime rollup, no job. */
+    resetJobInsightsHistory(): Promise<ResetHistoryResult>;
+}
+/**
+ * The jobs client over the app's transport.
+ *
+ * @param client - the app's {@link PlatformApiClient} (`usePlatformApi()`, or the app's own adapter).
+ * @returns a {@link JobsApi} whose calls go through `client`.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/platform/jobsAdapters.ts
+ * export const appJobsAdapters: JobsWebAdapters = { DataTable, Spinner: LoadingSpinner, api: createJobsApi(appPlatformApi) };
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function createJobsApi(client: PlatformApiClient): JobsApi;
+//# sourceMappingURL=api.d.ts.map

package/dist/jobs/headless/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/jobs/headless/api.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,GAAG,EACH,WAAW,EACX,aAAa,EACb,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,gFAAgF;IAChF,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,mHAAmH;IACnH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,4FAA4F;IAC5F,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3D,6HAA6H;IAC7H,cAAc,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrE,8EAA8E;IAC9E,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,qFAAqF;IACrF,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxD;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CA0BhE"}

package/dist/jobs/headless/api.js

@@ -0,0 +1,94 @@
+// =============================================================================
+// The jobs slice's API client (issue #854)
+// =============================================================================
+//
+// Every admin route of the job queue the packaged pages call, plus the worker
+// fleet's (the `NodesApi` of `@marinoscar/platform-web/nodes/headless`, #881,
+// which `JobsApi` extends so an app's existing wiring keeps working), over the app's transport (`PlatformApiClient` of
+// `@marinoscar/platform-web/core`), so the auth header, the token refresh and
+// the app's error handling stay the app's. Moved from the reference app's
+// `services/jobs.ts` (#266) and `services/nodes.ts` (#271); the paths and
+// query strings are byte-identical.
+//
+// THE FLEET ROUTES ARE ON TWO PREFIXES, AND THAT IS NOT AN ACCIDENT. Five are
+// under `/admin/nodes`; minting a credential is `POST /node-credentials`.
+// `JwtAuthGuard` admits a `nod_` worker credential on `/api/nodes` and nothing
+// else (#267): `admin/nodes` publishes other operators' email addresses and
+// deletes other people's nodes, and a worker token that could reach its own
+// minting endpoint could grow a replacement for the one just revoked. A path
+// "corrected" here to look consistent either 404s or moves an admin action
+// inside the worker-token blast radius.
+//
+// THERE IS NO `sortBy`. `GET /admin/jobs` orders by `createdAt DESC` and
+// offers nothing else (a sortable column set needs an index per column at the
+// sizes a queue reaches), and `GET /admin/nodes` returns the whole fleet
+// ordered by name, unpaginated.
+// =============================================================================
+import { createNodesApi } from '../../nodes/index.js';
+/** `GET /admin/jobs`'s query string, in the app's order and omissions. */
+function jobListQuery(params) {
+    const query = new URLSearchParams();
+    if (params.page)
+        query.set('page', String(params.page));
+    if (params.pageSize)
+        query.set('pageSize', String(params.pageSize));
+    if (params.status)
+        query.set('status', params.status);
+    if (params.type)
+        query.set('type', params.type);
+    if (params.subjectType)
+        query.set('subjectType', params.subjectType);
+    if (params.subjectId)
+        query.set('subjectId', params.subjectId);
+    // #734: one organization's jobs. Omitted, every job, system jobs included.
+    if (params.orgId)
+        query.set('orgId', params.orgId);
+    // Sent as the literal string the schema's `z.enum(['true','false'])` expects,
+    // and ONLY when true: `scheduled=false` means the same as omitting it.
+    if (params.scheduled)
+        query.set('scheduled', 'true');
+    // `all` is the schema default, so it is omitted rather than sent.
+    if (params.processedWithin && params.processedWithin !== 'all') {
+        query.set('processedWithin', params.processedWithin);
+    }
+    return query;
+}
+/**
+ * The jobs client over the app's transport.
+ *
+ * @param client - the app's {@link PlatformApiClient} (`usePlatformApi()`, or the app's own adapter).
+ * @returns a {@link JobsApi} whose calls go through `client`.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/platform/jobsAdapters.ts
+ * export const appJobsAdapters: JobsWebAdapters = { DataTable, Spinner: LoadingSpinner, api: createJobsApi(appPlatformApi) };
+ * ```
+ *
+ * @stability experimental
+ */
+export function createJobsApi(client) {
+    return {
+        ...createNodesApi(client),
+        getJobs: (params = {}) => client.get(`/admin/jobs?${jobListQuery(params)}`),
+        getJobStats: () => client.get('/admin/jobs/stats'),
+        retryJob: (id) => client.post(`/admin/jobs/${id}/retry`),
+        deleteJob: async (id) => {
+            await client.delete(`/admin/jobs/${id}`);
+        },
+        retryFailedJobs: (type) => client.post('/admin/jobs/retry-failed', type ? { type } : {}),
+        // `olderThanMinutes` is OMITTED unless the caller means it, so the API
+        // falls through to the `jobs.stuckThresholdMinutes` system setting: a
+        // default invented here would be a second place the threshold is decided.
+        resetStuckJobs: (olderThanMinutes) => client.post('/admin/jobs/reset-stuck', olderThanMinutes === undefined ? {} : { olderThanMinutes }),
+        getJobInsights: (windowDays) => {
+            const query = new URLSearchParams();
+            if (windowDays !== undefined)
+                query.set('windowDays', String(windowDays));
+            const suffix = query.toString();
+            return client.get(`/admin/jobs/insights${suffix ? `?${suffix}` : ''}`);
+        },
+        resetJobInsightsHistory: () => client.post('/admin/jobs/insights/reset-history'),
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/jobs/headless/api.js.map

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

package/dist/jobs/headless/format.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A duration, in the largest unit that still says something: `850 ms`,
+ * `1.5 s`, `4m 05s`, `2h 03m`, `3d 4h`.
+ *
+ * `null` (and `undefined`, and a non-finite number) renders as an em dash
+ * rather than "0 ms": the API's nullable durations mean "no succeeded jobs to
+ * measure", and printing a zero would state a measurement that was never taken.
+ *
+ * @param ms - the duration in milliseconds.
+ * @returns the formatted duration, or an em dash.
+ *
+ * @stability experimental
+ */
+export declare function formatDuration(ms: number | null | undefined): string;
+/**
+ * A timestamp in the viewer's locale, or an em dash when the API sent `null`.
+ *
+ * @param value - an ISO 8601 timestamp, or `null`.
+ * @returns the localized date and time, or an em dash.
+ *
+ * @stability experimental
+ */
+export declare function formatDateTime(value: string | null | undefined): string;
+/**
+ * The first 8 characters of a UUID: enough to tell two rows apart by eye.
+ *
+ * @param id - the id.
+ * @returns its first 8 characters.
+ *
+ * @stability experimental
+ */
+export declare function shortId(id: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/jobs/headless/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/jobs/headless/format.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAiBpE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C"}

package/dist/jobs/headless/format.js

@@ -0,0 +1,65 @@
+// =============================================================================
+// The jobs slice's formatting helpers (issue #854)
+// =============================================================================
+//
+// Moved from the reference app's `pages/Admin/jobsTable.tsx`, where the Job
+// Insights page, the worker-fleet tables and the app's own backup and About
+// pages already shared them: one formatter for the same milliseconds, so a
+// page never reads "1500ms" beside one reading "1.5 s" for the same number.
+// Pure functions, no markup, so they live in the headless entry.
+// =============================================================================
+/**
+ * A duration, in the largest unit that still says something: `850 ms`,
+ * `1.5 s`, `4m 05s`, `2h 03m`, `3d 4h`.
+ *
+ * `null` (and `undefined`, and a non-finite number) renders as an em dash
+ * rather than "0 ms": the API's nullable durations mean "no succeeded jobs to
+ * measure", and printing a zero would state a measurement that was never taken.
+ *
+ * @param ms - the duration in milliseconds.
+ * @returns the formatted duration, or an em dash.
+ *
+ * @stability experimental
+ */
+export function formatDuration(ms) {
+    if (ms === null || ms === undefined || !Number.isFinite(ms))
+        return '—';
+    if (ms < 1000)
+        return `${Math.round(ms)} ms`;
+    const totalSeconds = ms / 1000;
+    if (totalSeconds < 60)
+        return `${totalSeconds.toFixed(1)} s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = Math.round(totalSeconds % 60);
+    if (minutes < 60)
+        return `${minutes}m ${String(seconds).padStart(2, '0')}s`;
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    if (hours < 24)
+        return `${hours}h ${String(remainingMinutes).padStart(2, '0')}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ${hours % 24}h`;
+}
+/**
+ * A timestamp in the viewer's locale, or an em dash when the API sent `null`.
+ *
+ * @param value - an ISO 8601 timestamp, or `null`.
+ * @returns the localized date and time, or an em dash.
+ *
+ * @stability experimental
+ */
+export function formatDateTime(value) {
+    return value ? new Date(value).toLocaleString() : '—';
+}
+/**
+ * The first 8 characters of a UUID: enough to tell two rows apart by eye.
+ *
+ * @param id - the id.
+ * @returns its first 8 characters.
+ *
+ * @stability experimental
+ */
+export function shortId(id) {
+    return id.slice(0, 8);
+}
+//# sourceMappingURL=format.js.map

package/dist/jobs/headless/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/jobs/headless/format.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,iEAAiE;AACjE,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,EAA6B;IAC1D,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACxE,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;IAE7C,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,YAAY,GAAG,EAAE;QAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IAE5E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IAEjF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,GAAG,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC7D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/jobs/headless/index.d.ts

@@ -0,0 +1,16 @@
+export { createJobsApi } from './api.js';
+export type { JobsApi } from './api.js';
+export { isJobActionable } from './types.js';
+export type { Job, JobDurationStats, JobEta, JobEtaBasis, JobInsights, JobLifetimeStats, JobListParams, JobListResponse, JobReasonName, JobStats, JobStatusCounts, JobStatusName, JobTypeDurationStats, JobTypeStats, ProcessedWithin, ResetHistoryResult, ResetStuckResult, RetryFailedResult, } from './types.js';
+export { formatDateTime, formatDuration, shortId } from './format.js';
+export { JobsWebAdaptersProvider, useJobsApi, useJobsWebAdapters } from './adapters.js';
+export type { JobsSpinnerProps, JobsWebAdapters } from './adapters.js';
+export type { JobsDataTableComponent, JobsDataTableProps, JobsTableColumn, JobsTableColumnPriority, JobsTableEnumValue, JobsTableFilter, JobsTableFilterModelOperator, JobsTableFilterOperator, JobsTableRowAction, JobsTableSortState, } from './table.js';
+export { useVisiblePolling } from './use-visible-polling.js';
+export { JOBS_POLL_INTERVAL_MS, useJobActions, useJobStats, useJobs } from './use-jobs.js';
+export type { UseJobActionsResult, UseJobStatsResult, UseJobsResult } from './use-jobs.js';
+export { DEFAULT_INSIGHTS_WINDOW_DAYS, INSIGHTS_WINDOW_OPTIONS, useJobInsights } from './use-job-insights.js';
+export type { UseJobInsightsResult } from './use-job-insights.js';
+export { MAX_NODE_CREDENTIAL_DAYS, MAX_NODE_CREDENTIAL_NAME_LENGTH, NODE_HEALTHS, NODE_STATUSES, WORKER_NODES_POLL_INTERVAL_MS, nodeCredentialStatus, useNodeActions, useNodeCredentials, useWorkerNode, useWorkerNodes, } from '../../nodes/index.js';
+export type { CreateNodeCredentialInput, NodeCredential, NodeCredentialCreated, NodeCredentialStatus, NodeHealth, NodeJobCounts, NodeOwner, NodeStatus, NodeVitals, NodeVitalsCounters, UseNodeActionsResult, UseNodeCredentialsResult, UseWorkerNodeResult, UseWorkerNodesResult, WorkerNode, } from '../../nodes/index.js';
+//# sourceMappingURL=index.d.ts.map