@stonecrop/nuxt 0.35.0 → 0.36.0

package/README.md

@@ -427,7 +427,7 @@ await dispatchAction({ name: 'plan' }, 'SUBMIT', [recordId])
 | `setMeta(fn)` | `(fn: (ctx) => Doctype \| Promise<Doctype>) => void` | Sets the `getMeta` function on the Registry. Called by `useStonecrop({ doctype: 'slug' })` to lazy-load that doctype's metadata. `ctx` = `{ path, segments }`. |
 | `setClient(client)` | `(client: DataClient) => void` | Set the data client for record fetching. Throws if stonecrop not available. |
 | `getClient()` | `() => DataClient \| undefined` | Get the currently configured client. |
-| `dispatchAction(doctype, action, args)` | `Promise<{ success, data, error }>` | Dispatch an action via the configured client. Returns error if doctype not found in registry. |
+| `dispatchAction(doctype, action, args)` | `Promise<{ success, data, error }>` | Dispatch an action via the configured client, storing the result's `record` (the server's read of the record after the action). Returns error if doctype not found in registry. |
 
 ## Advanced Features
 
@@ -570,8 +570,10 @@ The CLI will detect that you're in a Nuxt project and prompt for features:
 
 ? Select features to install
   ◉ @stonecrop/nuxt - Frontend module
+  ◯ @stonecrop/graphql-client - GraphQL client
   ◯ @stonecrop/nuxt-grafserv - GraphQL server
   ◯ @stonecrop/casl-middleware - Authorization
+  ◯ @stonecrop/rockfoil - PostGraphile middleware
   ◉ Sample doctypes
 ```
 

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@stonecrop/nuxt",
   "configKey": "stonecrop",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/nuxt",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Nuxt module for Stonecrop",
   "keywords": [
     "nuxt",
@@ -60,18 +60,18 @@
     "pathe": "^2.0.3",
     "pinia": "^3.0.4",
     "prompts": "^2.4.2",
-    "@stonecrop/aform": "0.35.0",
-    "@stonecrop/atable": "0.35.0",
-    "@stonecrop/casl-middleware": "0.35.0",
-    "@stonecrop/code-editor": "0.35.0",
-    "@stonecrop/desktop": "0.35.0",
-    "@stonecrop/graphql-client": "0.35.0",
-    "@stonecrop/schema": "0.35.0",
-    "@stonecrop/node-editor": "0.35.0",
-    "@stonecrop/nuxt-grafserv": "0.35.0",
-    "@stonecrop/themes": "0.35.0",
-    "@stonecrop/stonecrop": "0.35.0",
-    "@stonecrop/graphql-middleware": "0.35.0"
+    "@stonecrop/atable": "0.36.0",
+    "@stonecrop/code-editor": "0.36.0",
+    "@stonecrop/casl-middleware": "0.36.0",
+    "@stonecrop/desktop": "0.36.0",
+    "@stonecrop/aform": "0.36.0",
+    "@stonecrop/graphql-client": "0.36.0",
+    "@stonecrop/graphql-middleware": "0.36.0",
+    "@stonecrop/nuxt-grafserv": "0.36.0",
+    "@stonecrop/schema": "0.36.0",
+    "@stonecrop/stonecrop": "0.36.0",
+    "@stonecrop/themes": "0.36.0",
+    "@stonecrop/node-editor": "0.36.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -95,6 +95,7 @@
     "nuxt": "^4.4.8",
     "nuxt-graphql-middleware": "^5.4.0",
     "postgraphile": "^5.0.3",
+    "temporal-polyfill": "^1.0.5",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
     "vite": "^8.2.2",

package/src/cli/installers/frontend.ts

@@ -26,11 +26,12 @@ export async function installFrontend(options: FrontendInstallerOptions): Promis
 
 	try {
 		// Add @stonecrop/nuxt and its required peer dependencies
-		// These packages are imported by the Nuxt module and need to be available at runtime
+		// These packages are imported by the Nuxt module or the scaffolded app files and need to be available at runtime
 		await addDependencies(cwd, {
 			'@stonecrop/nuxt': 'latest',
 			'@stonecrop/aform': 'latest',
 			'@stonecrop/atable': 'latest',
+			'@stonecrop/graphql-client': 'latest',
 			'@stonecrop/stonecrop': 'latest',
 			'@stonecrop/node-editor': 'latest',
 			'@stonecrop/schema': 'latest',

package/src/cli/installers/grafserv.ts

@@ -39,8 +39,10 @@ export async function installGrafserv(options: GrafservInstallerOptions): Promis
 		await addDependencies(cwd, {
 			'@stonecrop/nuxt-grafserv': 'latest',
 			'@stonecrop/graphql-middleware': 'latest',
+			'@stonecrop/schema': 'latest',
 			graphql: '^16.11.0',
 			grafast: '^1.0.1',
+			'temporal-polyfill': '^1.0.5',
 		})
 
 		// Update nuxt.config.ts

package/templates/resolvers.ts

@@ -22,6 +22,7 @@ import { constant, lambda, loadOne, object } from 'grafast'
 import { getMeta, getAllMeta, applyGuardedTransition } from '@stonecrop/graphql-middleware'
 import { getRecordIdField } from '@stonecrop/schema'
 import type { DoctypeMeta } from '@stonecrop/schema'
+import { Temporal } from 'temporal-polyfill'
 import { projects, tasks, type Project, type Task } from './data'
 
 // ============================================================
@@ -142,8 +143,8 @@ function nextId(doctype: string): string {
 // `selfTransition` has nothing for the dispatcher to apply, and without an entry here it fails
 // loudly rather than reporting a false success.
 //
-// Add your own by registering under the doctype's `name`. Throwing rejects the action; returning
-// the updated record makes it the client writeback payload.
+// Add your own by registering under the doctype's `name`. Throwing rejects the action; what it
+// returns becomes the result's `data`, while the client stores the record as a read returns it.
 
 type ActionHandler = (context: {
 	recordId?: string
@@ -165,9 +166,9 @@ export const actionHandlers: Record<string, Record<string, ActionHandler>> = {
 			const task = recordId != null ? tasks.get(recordId) : undefined
 			if (!task) throw new Error(`Task ${recordId ?? '(none)'} not found`)
 
-			const from = task.dueDate ? new Date(task.dueDate) : new Date()
-			from.setDate(from.getDate() + 7)
-			const updated: Task = { ...task, dueDate: from.toISOString().slice(0, 10) }
+			// A task with no due date is snoozed from the server's today.
+			const from = task.dueDate ? Temporal.PlainDate.from(task.dueDate) : Temporal.Now.plainDateISO()
+			const updated: Task = { ...task, dueDate: from.add({ weeks: 1 }).toString() }
 			tasks.set(task.id, updated)
 			return Promise.resolve(updated)
 		},
@@ -278,7 +279,7 @@ export const resolvers = {
 									// The server owns the transition: read current state, guard against allowedStates,
 									// write nextState. Reads/writes go straight to the in-memory Maps; a PostGraphile
 									// setup swaps in pgClient SQL instead.
-									return await applyGuardedTransition(
+									const outcome = await applyGuardedTransition(
 										actionDef,
 										{
 											readState: async () => {
@@ -302,7 +303,7 @@ export const resolvers = {
 											// untouched); creating derives the identity from the doctype's declared
 											// primary key when the submitted data carries it, which is how a
 											// natural-keyed doctype is identified, and mints one only otherwise.
-											// Either way the full record comes back for the client writeback.
+											// Either way the full record comes back, stating its identity.
 											writeData: async (patch: Record<string, unknown>, exists: boolean) => {
 												if (exists) {
 													if (recordId == null) return {}
@@ -340,6 +341,15 @@ export const resolvers = {
 										},
 										recordData
 									)
+									// The record as `stonecropRecord` returns it: the client stores this, never
+									// `data`. Keyed by the identity the reply states, since a save may create it.
+									const repliedId: unknown =
+										outcome.data !== null && typeof outcome.data === 'object'
+											? Reflect.get(outcome.data, lookupField)
+											: undefined
+									const readId = repliedId ?? recordId
+									const record = outcome.success && readId != null ? getRecord(d, String(readId), lookupField) : null
+									return { ...outcome, record }
 								} catch (err) {
 									return { success: false, data: null, error: err instanceof Error ? err.message : String(err) }
 								}

package/templates/schema.graphql

@@ -101,6 +101,8 @@ type ActionResult {
 	success: Boolean!
 	data: JSON
 	error: String
+	"The record as stonecropRecord returns it after the action. Null when the action failed or targets no record."
+	record: JSON
 }
 
 # ============================================