@everystack/admin 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+All notable changes to `@everystack/admin` are documented here.
+
+Format based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [Unreleased]
+
+### Added
+
+- auto-generated changelogs from conventional commits
+- automate the version-drift check — a manual note is not a gate
+
+### Fixed
+
+- the test suite compiled with type checking off
+
+## [0.4.0] - 2026-07-19
+
+### Added
+
+- tx-contract dashboard RPCs + role-scoped jobs adapter
+
+### Fixed
+
+- serve the jobs list via jobsEventList RPC, not the shadowed REST table
+- correct sidebar hierarchy emphasis
+- camelCase listRpc rows so snake_case columns render
+- pin React to a single 19.2.0 across the monorepo
+
+## [0.2.6] - 2026-06-18
+
+### Fixed
+
+- audit-log detail view (Show) + list-only row-nav guard
+
+## [0.2.5] - 2026-06-17
+
+### Added
+
+- physical tableName + static where for resource dashboards
+- RPC-backed row actions on the show view
+- @everystack/jobs/admin — config, health RPC, retry/cancel RPCs
+- RPC-backed row detail — telemetry never enters REST
+- extensibility, unified view, observability + Track B rollup
+- DB-free Logs + Crashes row lists via S3 list RPCs
+- menu toggle by title, breadcrumbs, accordion nav
+- DB-free row detail (Show) for log events and crashes over S3
+- field-fold (sum/avg) stat dials for artifact dashboards
+- DB-free alerting — artifact-backed evaluation over S3, no Postgres
+- config-driven ResourceDashboard for all tables
+- wire image upload into field renderers with full S3 loop
+- Crashes dashboard header reads the issues rollup artifact
+
+### Fixed
+
+- Issues RPC auth, Health screen, Raw Data navigation, D3 deps
+- pin all dependency versions to lockfile-resolved values
+- dashboards size charts to the container, not the window
+- CRUD tables fill the panel and format cells by field type
+- coalesce list fetches — one request per load, not two
+- serve DB-free row detail via the existing EventDetail RPC convention
+
+### Changed
+
+- split expo-stack into discrete packages and remove @jest/globals imports
+- drop type module from all packages, switch Jest to CJS mode
+- consolidate Jest configs into shared base
+- one chart vocabulary in @everystack/ui
+
+### Documentation
+
+- rewrite documentation around V1→V2→V3 progressive complexity model
+- prepare documentation for open-source release
+- definition of done for the branch (8 requirements mapped)
+- mark Track B engine done (write + read, 70 tests, no DB)
+- Track B rollup LIVE-VERIFIED on dev (verify:rollup green)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/admin",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Declarative admin dashboard framework for PostgREST APIs",
   "license": "AGPL-3.0-only",
   "author": "Scalable Technology, Inc. <licensing@scalable.technology>",
@@ -18,22 +18,27 @@
   },
   "files": [
     "src",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./src/index.ts",
       "default": "./src/index.ts"
     },
     "./rpc": {
+      "source": "./src/rpc/resource-dashboard-rpc.ts",
       "types": "./src/rpc/resource-dashboard-rpc.ts",
       "default": "./src/rpc/resource-dashboard-rpc.ts"
     },
     "./presets/twitter": {
+      "source": "./src/presets/twitter.ts",
       "types": "./src/presets/twitter.ts",
       "default": "./src/presets/twitter.ts"
     },
     "./editors/tiptap": {
+      "source": "./src/editors/tiptap.tsx",
       "types": "./src/editors/tiptap.tsx",
       "default": "./src/editors/tiptap.tsx"
     }
@@ -43,6 +48,7 @@
     "d3-time-format": "4.1.0"
   },
   "peerDependencies": {
+    "drizzle-orm": "0.41.0",
     "@everystack/api": ">=0.2.4",
     "@everystack/ui": ">=0.2.2",
     "@tiptap/pm": ">=2.0.0",
@@ -74,10 +80,11 @@
     "jest": "29.7.0",
     "react": "19.2.0",
     "react-native": "0.83.6",
+    "react-test-renderer": "19.2.0",
     "ts-jest": "29.4.9",
     "typescript": "5.9.3",
-    "@everystack/ui": "0.4.0",
-    "@everystack/api": "0.4.0"
+    "@everystack/api": "0.4.2",
+    "@everystack/ui": "0.4.1"
   },
   "scripts": {
     "test": "jest",

package/src/adapters/EverystackAdapter.ts

@@ -23,6 +23,15 @@ const POSTGREST_OPERATORS = new Set([
   'sl', 'sr', 'nxl', 'nxr', 'adj', 'ov', 'fts',
 ]);
 
+/**
+ * `onTokenExpired` and `onAuthFailure` (inherited from `ClientOptions`) are how
+ * the admin survives a session longer than the access token's TTL. Without
+ * `onTokenExpired`, `getToken` keeps handing every request the same dead token
+ * forever — the user stays "logged in" while every screen 401s. `onAuthFailure`
+ * fires only once refresh itself is unrecoverable (refresh token also
+ * expired/revoked) — wire it to sign the user out for real. See
+ * `@everystack/auth/api`'s `refreshAuthToken` for a ready-made `onTokenExpired`.
+ */
 export interface EverystackAdapterOptions extends ClientOptions {
   /**
    * Resources whose list rows come from an RPC instead of the PostgREST table.

package/src/editors/tiptap.tsx

@@ -7,7 +7,7 @@
  *   pnpm add @tiptap/react @tiptap/starter-kit @tiptap/pm
  *   import { TiptapEditor } from '@everystack/admin/editors/tiptap';
  *   <AdminShell editors={{ tiptap: TiptapEditor }} ... />
- *   // field: { name: 'body', type: 'html', editor: 'tiptap' }
+ *   // field: { name: 'body', type: 'string', editor: 'tiptap', format: 'html' }
  *
  * Reads and writes an HTML string via the EditorProps contract. The toolbar
  * uses React Native primitives; the editable surface is tiptap's EditorContent

package/src/presets/twitter.ts

@@ -39,14 +39,14 @@ const profilesResource: ResourceConfig = {
   fields: [
     { name: 'id', type: 'string', label: 'ID' },
     { name: 'username', type: 'string', label: 'Username', sortable: true, searchable: true },
-    { name: 'display_name', type: 'string', label: 'Display Name', sortable: true, searchable: true },
+    { name: 'displayName', type: 'string', label: 'Display Name', sortable: true, searchable: true },
     { name: 'bio', type: 'string', label: 'Bio' },
-    { name: 'avatar_url', type: 'image', label: 'Avatar', renderer: 'avatar' },
-    { name: 'created_at', type: 'datetime', label: 'Joined', sortable: true },
+    { name: 'avatarUrl', type: 'image', label: 'Avatar', renderer: 'avatar' },
+    { name: 'createdAt', type: 'datetime', label: 'Joined', sortable: true },
   ],
-  listFields: ['username', 'display_name', 'bio', 'created_at'],
-  editFields: ['username', 'display_name', 'bio', 'avatar_url'],
-  defaultSort: { field: 'created_at', order: 'desc' },
+  listFields: ['username', 'displayName', 'bio', 'createdAt'],
+  editFields: ['username', 'displayName', 'bio', 'avatarUrl'],
+  defaultSort: { field: 'createdAt', order: 'desc' },
   dashboard: profilesDashboard,
 };
 
@@ -76,16 +76,16 @@ const postsResource: ResourceConfig = {
   fields: [
     { name: 'id', type: 'string', label: 'ID' },
     {
-      name: 'author_id',
+      name: 'authorId',
       type: 'relation',
       label: 'Author',
       relation: { resource: 'profiles', field: 'id', displayField: 'username' },
     },
     { name: 'body', type: 'string', label: 'Body', searchable: true },
-    { name: 'created_at', type: 'datetime', label: 'Posted', sortable: true },
+    { name: 'createdAt', type: 'datetime', label: 'Posted', sortable: true },
   ],
-  listFields: ['author_id', 'body', 'created_at'],
-  defaultSort: { field: 'created_at', order: 'desc' },
+  listFields: ['authorId', 'body', 'createdAt'],
+  defaultSort: { field: 'createdAt', order: 'desc' },
   dashboard: postsDashboard,
 };
 
@@ -110,25 +110,25 @@ const likesResource: ResourceConfig = {
   label: 'Like',
   labelPlural: 'Likes',
   icon: 'heart',
-  primaryKey: 'user_id',
+  primaryKey: 'userId',
   actions: { list: true, show: true, create: true, edit: false, delete: true },
   fields: [
     {
-      name: 'user_id',
+      name: 'userId',
       type: 'relation',
       label: 'User',
       relation: { resource: 'profiles', field: 'id', displayField: 'username' },
     },
     {
-      name: 'post_id',
+      name: 'postId',
       type: 'relation',
       label: 'Post',
       relation: { resource: 'posts', field: 'id' },
     },
-    { name: 'created_at', type: 'datetime', label: 'Liked At', sortable: true },
+    { name: 'createdAt', type: 'datetime', label: 'Liked At', sortable: true },
   ],
-  listFields: ['user_id', 'post_id', 'created_at'],
-  defaultSort: { field: 'created_at', order: 'desc' },
+  listFields: ['userId', 'postId', 'createdAt'],
+  defaultSort: { field: 'createdAt', order: 'desc' },
   dashboard: likesDashboard,
 };
 
@@ -153,25 +153,25 @@ const followsResource: ResourceConfig = {
   label: 'Follow',
   labelPlural: 'Follows',
   icon: 'people',
-  primaryKey: 'follower_id',
+  primaryKey: 'followerId',
   actions: { list: true, show: true, create: true, edit: false, delete: true },
   fields: [
     {
-      name: 'follower_id',
+      name: 'followerId',
       type: 'relation',
       label: 'Follower',
       relation: { resource: 'profiles', field: 'id', displayField: 'username' },
     },
     {
-      name: 'following_id',
+      name: 'followingId',
       type: 'relation',
       label: 'Following',
       relation: { resource: 'profiles', field: 'id', displayField: 'username' },
     },
-    { name: 'created_at', type: 'datetime', label: 'Followed At', sortable: true },
+    { name: 'createdAt', type: 'datetime', label: 'Followed At', sortable: true },
   ],
-  listFields: ['follower_id', 'following_id', 'created_at'],
-  defaultSort: { field: 'created_at', order: 'desc' },
+  listFields: ['followerId', 'followingId', 'createdAt'],
+  defaultSort: { field: 'createdAt', order: 'desc' },
   dashboard: followsDashboard,
 };
 

package/src/screens/ResourceCreate.tsx

@@ -11,7 +11,8 @@ import { useAdminConfig } from '../hooks/useAdminConfig';
 import { useDataAdapter } from '../hooks/useAdminData';
 import { useEditors } from '../hooks/useEditors';
 import { editorFor } from '../utils/render-resolution';
-import { FormField, TextInput, SelectInput, SwitchInput, Button, ErrorState } from '@everystack/ui';
+import { toDateInputValue } from '../utils/format-cell-value';
+import { FormField, TextInput, SelectInput, SwitchInput, DateInput, Button, ErrorState } from '@everystack/ui';
 import { ImageFieldInput } from '../components/ImageFieldInput';
 import { AvatarFieldInput } from '../components/AvatarFieldInput';
 import type { FieldDefinition } from '../types';
@@ -173,6 +174,20 @@ function FieldInput({ field, value, error, onChange }: FieldInputProps): React.R
         </FormField>
       );
 
+    case 'date':
+      return (
+        <FormField label={label} error={error} required={required}>
+          <DateInput value={toDateInputValue(value)} onValueChange={onChange} granularity="date" />
+        </FormField>
+      );
+
+    case 'datetime':
+      return (
+        <FormField label={label} error={error} required={required}>
+          <DateInput value={toDateInputValue(value)} onValueChange={onChange} granularity="datetime" />
+        </FormField>
+      );
+
     case 'number':
       return (
         <FormField label={label} error={error} required={required}>

package/src/screens/ResourceEdit.tsx

@@ -11,7 +11,8 @@ import { useAdminConfig } from '../hooks/useAdminConfig';
 import { useDataAdapter } from '../hooks/useAdminData';
 import { useEditors } from '../hooks/useEditors';
 import { editorFor } from '../utils/render-resolution';
-import { FormField, TextInput, SelectInput, SwitchInput, Button, LoadingState, ErrorState } from '@everystack/ui';
+import { toDateInputValue } from '../utils/format-cell-value';
+import { FormField, TextInput, SelectInput, SwitchInput, DateInput, Button, LoadingState, ErrorState } from '@everystack/ui';
 import { ImageFieldInput } from '../components/ImageFieldInput';
 import { AvatarFieldInput } from '../components/AvatarFieldInput';
 import type { FieldDefinition, DataRecord } from '../types';
@@ -215,6 +216,20 @@ function EditFieldInput({ field, value, error, onChange, record }: EditFieldInpu
         </FormField>
       );
 
+    case 'date':
+      return (
+        <FormField label={label} error={error} required={required}>
+          <DateInput value={toDateInputValue(value)} onValueChange={onChange} granularity="date" />
+        </FormField>
+      );
+
+    case 'datetime':
+      return (
+        <FormField label={label} error={error} required={required}>
+          <DateInput value={toDateInputValue(value)} onValueChange={onChange} granularity="datetime" />
+        </FormField>
+      );
+
     case 'number':
       return (
         <FormField label={label} error={error} required={required}>

package/src/screens/ResourceShow.tsx

@@ -14,6 +14,7 @@ import { ImageDisplay } from '../components/ImageDisplay';
 import { RowActionButton } from '../components/RowActionButton';
 import { visibleRowActions } from '../utils/row-actions';
 import { toCamelCase } from '../utils/naming';
+import { formatDateOnly } from '../utils/format-cell-value';
 import type { FieldDefinition, DataRecord, ResourceConfig } from '../types';
 import type { DataAdapter } from '../adapters/types';
 
@@ -194,9 +195,11 @@ function formatFieldValue(value: unknown, field: FieldDefinition): string {
     case 'boolean':
       return value ? 'Yes' : 'No';
     case 'date':
-      return new Date(String(value)).toLocaleDateString();
-    case 'datetime':
-      return new Date(String(value)).toLocaleString();
+      return formatDateOnly(value);
+    case 'datetime': {
+      const date = new Date(String(value));
+      return Number.isNaN(date.getTime()) ? String(value) : date.toLocaleString();
+    }
     case 'json':
       return JSON.stringify(value, null, 2);
     case 'url':

package/src/utils/format-cell-value.ts

@@ -8,6 +8,47 @@
 
 import type { FieldDefinition } from '../types';
 
+/**
+ * A date-only ISO string has no time-of-day; `new Date(str)` parses it as UTC midnight, and
+ * `toLocaleDateString()` then converts that back to the viewer's local time -- which rolls the
+ * displayed day back one in any UTC-negative timezone. Parses the Y-M-D digits directly and
+ * builds a LOCAL date from them instead (same approach DateInput uses for editing). A native
+ * Date value (a custom DataAdapter's prerogative -- the adapter interface is schema-agnostic)
+ * is read via its own local getters, not restringified. Range-invalid digits (e.g. month 13)
+ * would silently normalize to a different, wrong calendar date rather than error -- verified
+ * against the ORIGINAL Y/M/D instead of trusted blindly, falling back to the raw value like any
+ * other unparseable input.
+ */
+export function formatDateOnly(value: unknown): string {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return String(value);
+    return new Date(value.getFullYear(), value.getMonth(), value.getDate()).toLocaleDateString();
+  }
+  const str = String(value);
+  const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(str);
+  if (!match) return str;
+  const [, y, m, d] = match;
+  const year = Number(y);
+  const month = Number(m) - 1;
+  const day = Number(d);
+  const date = new Date(year, month, day);
+  if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {
+    return str;
+  }
+  return date.toLocaleDateString();
+}
+
+/**
+ * Coerce a field value to the string DateInput expects. A native Date value (a custom
+ * DataAdapter's prerogative) must go through `toISOString()`, not the default `String(value)` —
+ * `Date#toString()` ("Sun Sep 22 2026 00:00:00 GMT...") doesn't match DateInput's ISO parser, so
+ * a populated field would silently render as if it were unset.
+ */
+export function toDateInputValue(value: unknown): string {
+  if (value instanceof Date) return value.toISOString();
+  return value == null ? '' : String(value);
+}
+
 export function formatCellValue(field: FieldDefinition, value: unknown): string {
   if (value === null || value === undefined) return '—';
 
@@ -16,10 +57,8 @@ export function formatCellValue(field: FieldDefinition, value: unknown): string
       const date = new Date(String(value));
       return Number.isNaN(date.getTime()) ? String(value) : date.toLocaleString();
     }
-    case 'date': {
-      const date = new Date(String(value));
-      return Number.isNaN(date.getTime()) ? String(value) : date.toLocaleDateString();
-    }
+    case 'date':
+      return formatDateOnly(value);
     case 'boolean':
       return value ? 'Yes' : 'No';
     case 'json':