@protobase/server 0.68.0 → 0.68.2

package/dist/check-views.js

@@ -69,6 +69,11 @@ const textHintErrors = (view, model) => Object.entries(view.fields).flatMap(([na
 	const format = hints.format !== void 0 && textFormats.has(hints.format) ? [`format('${hints.format}') of "${name}" needs a text field, not ${field.type}`] : [];
 	return [...textHints.filter((hint) => hints[hint]).map((hint) => `${hint} "${name}" needs a text field, not ${field.type}`), ...format];
 });
+const notOnCreateErrors = (view, model) => Object.entries(view.fields).flatMap(([name, hints]) => {
+	const field = model.fields[name];
+	if (!hints.notOnCreate || !field || field.nullable || field.default || field.readOnly) return [];
+	return [`notOnCreate "${name}" is a field a create needs: make it optional or give it a default`];
+});
 const linkErrors = (view, model, models, pages, createPages) => view.actions.flatMap(({ name, label, run }) => {
 	if (run?.kind !== "link") return [];
 	const error = linkActionError(label, run);
@@ -192,6 +197,7 @@ const checkViews = (registry, views, pages = [], fieldTypes = {}) => {
 			...valueLabelErrors(view, model),
 			...valueColorErrors(view, model),
 			...textHintErrors(view, model),
+			...notOnCreateErrors(view, model),
 			...numberHintErrors(view, model),
 			...listEditErrors(view, model),
 			...widgetErrors(view, model, fieldTypes),

package/dist/comments/record-comments.js

@@ -29,6 +29,7 @@ const commentsView = view("record_comments").names({
 	singular: "Comment",
 	plural: "Comments"
 }).icon("message-square").title((r) => r.record_key).help("Every comment on the records whose resource takes comments, newest first. Delete one to take it down.").fields((r) => ({
+	resource: r.resource.label("Resource"),
 	record_key: r.record_key.label("Record"),
 	author_id: r.author_id.label("By"),
 	body: r.body.label("Comment"),

package/dist/history/activity.js

@@ -39,11 +39,21 @@ const activityView = view("record_history").names({
 	singular: "Change",
 	plural: "Activity"
 }).icon("history").title((r) => r.record_key).help("Every change of the records whose resource keeps history, from the app or straight in the database, newest first.").fields((r) => ({
+	resource: r.resource.label("Resource"),
 	record_key: r.record_key.label("Record"),
+	operation: r.operation.label("Operation").valueLabels({
+		create: "Created",
+		update: "Updated",
+		delete: "Deleted",
+		undelete: "Restored"
+	}),
+	before: r.before.label("Before"),
+	after: r.after.label("After"),
 	actor_id: r.actor_id.label("By"),
 	actor_roles: r.actor_roles.label("Acting as"),
 	database_role: r.database_role.label("Database role"),
 	changed: r.changed.label("Changed fields"),
+	transaction: r.transaction.label("Transaction"),
 	at: r.at.label("When")
 })).list((r) => ({
 	columns: [

package/dist/jobs/failed-jobs.js

@@ -30,8 +30,11 @@ const failedJobsView = view("failed_jobs").names({
 }).icon("triangle-alert").title((r) => r.name).help("Jobs that used up their attempts, or failed for good. Retry one once its cause is fixed: it gets one more attempt.").fields((r) => ({
 	name: r.name.label("Job"),
 	error: r.error.label("Last error"),
+	attempts: r.attempts.label("Attempts"),
 	failed_at: r.failed_at.label("Failed"),
 	created_at: r.created_at.label("Enqueued"),
+	key: r.key.label("Key"),
+	payload: r.payload.label("Payload"),
 	output: r.output.label("Error details")
 })).list((r) => ({
 	columns: [

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.68.0";
+var version = "0.68.2";
 //#endregion
 export { version };

package/dist/user-tables/admin-user-tables.js

@@ -1,12 +1,13 @@
 import { definitionsResources, fieldsResourceName, tablesResourceName } from "./definitions-resources.js";
 import { definitionsHook } from "./definitions-hook.js";
+import { fieldsView, tablesView } from "./definitions-views.js";
 import { servedUserTables } from "./served-user-tables.js";
 //#region src/user-tables/admin-user-tables.ts
 /**
 * What the tables users add bring to the admin, with `userTables` on: the resources over their definitions, through
-* which they are created, each user table a name in code (`codeNames`, the app's and Protobase's) does not take, and the
-* hook that creates their tables and columns. Without `tables`, nothing. With `organizations`, each definition belongs
-* to the organization it was made in (`definitionsResources`).
+* which they are created, with the views the admin app makes them in, each user table a name in code (`codeNames`, the
+* app's and Protobase's) does not take, and the hook that creates their tables and columns. Without `tables`, nothing.
+* With `organizations`, each definition belongs to the organization it was made in (`definitionsResources`).
 */
 const adminUserTables = (tables, codeNames, roles, organizations = false) => {
 	if (!tables) return {
@@ -31,7 +32,11 @@ const adminUserTables = (tables, codeNames, roles, organizations = false) => {
 			definitions.fields,
 			...served.resources
 		],
-		views: served.views,
+		views: [
+			tablesView,
+			fieldsView,
+			...served.views
+		],
 		hooks: [definitionsHook(codeNames)],
 		warnings: served.warnings
 	};

package/dist/user-tables/definitions-views.js

@@ -0,0 +1,93 @@
+import { fieldsResourceName, tablesResourceName } from "./definitions-resources.js";
+import { l, view } from "@protobase/schema";
+//#region src/user-tables/definitions-views.ts
+/** What each field type is called in the admin app; the UI's locale files translate them. */
+const fieldTypeLabels = {
+	text: "Text",
+	long_text: "Long text",
+	integer: "Whole number",
+	decimal: "Decimal number",
+	boolean: "Yes or no",
+	date: "Date",
+	timestamp: "Date and time",
+	json: "JSON"
+};
+/**
+* The tables list of the admin app, for whoever may make tables: a table's page has its fields, a link to add one and a
+* link to the table's own list, which shows once the app serves it. The title field is set once its field exists.
+*/
+const tablesView = view(tablesResourceName).names({
+	singular: "Table",
+	plural: "Tables"
+}).title((r) => r.plural_label).help("The tables people add to the app. Open one to give it fields or to go to its records.").nav({
+	creatorsOnly: true,
+	order: 0
+}).fields((r) => ({
+	name: r.name.label("Name").format("code").help("Its address and the name of its database table: lowercase letters, digits and _, starting with a letter. It cannot change later."),
+	plural_label: r.plural_label.label("Plural label").help("Its name in the sidebar and above its list, such as Notes."),
+	singular_label: r.singular_label.label("Singular label").help("What one record is called, such as Note."),
+	title_field: r.title_field.label("Title field").notOnCreate().help("The name of the text field that titles each record and that search looks in.")
+})).list((r) => ({
+	columns: [r.plural_label, r.name],
+	sort: [[r.name, "asc"]]
+})).layout((r) => [l.section("Table", [
+	r.plural_label,
+	r.singular_label,
+	r.name,
+	r.title_field
+]), l.related("Fields", {
+	resource: fieldsResourceName,
+	field: "table_id",
+	columns: [
+		"label",
+		"name",
+		"type"
+	],
+	sort: "position",
+	empty: "No fields yet."
+})]).actions((a) => [a.link("open_table", {
+	label: "Open table",
+	icon: "table",
+	to: {
+		kind: "list",
+		resource: "{table_name}"
+	}
+}), a.link("add_field", {
+	label: "Add field",
+	icon: "plus",
+	to: {
+		kind: "create",
+		resource: fieldsResourceName,
+		values: { table_id: "{id}" }
+	}
+})]);
+/** A table's fields, reached from its page; a field users add is always optional, so its form leaves that out. */
+const fieldsView = view(fieldsResourceName).names({
+	singular: "Field",
+	plural: "Fields"
+}).title((r) => r.label).nav({ hidden: true }).fields((r) => ({
+	table_id: r.table_id.label("Table"),
+	label: r.label.label("Label").help("What the field is called on screen."),
+	name: r.name.label("Name").format("code").help("Its name in the API and its database column: lowercase letters, digits and _, starting with a letter. It cannot change later."),
+	type: r.type.label("Type").valueLabels(fieldTypeLabels).help("What it holds. It cannot change later."),
+	position: r.position.label("Position").help("Where it sits among the fields of its table, 1 the first."),
+	precision: r.precision.label("Digits").help("For a decimal number only: how many digits it holds in all, from 1 to 1000."),
+	scale: r.scale.label("Decimals").help("For a decimal number only: how many of those digits come after the decimal point."),
+	required: r.required.notOnCreate()
+})).list((r) => ({
+	columns: [
+		r.label,
+		r.name,
+		r.type,
+		r.position
+	],
+	sort: [[r.position, "asc"]]
+})).layout((r) => [l.section("Field", [
+	r.table_id,
+	r.label,
+	r.name,
+	r.type,
+	r.position
+]), l.section("Decimal number", [r.precision, r.scale])]);
+//#endregion
+export { fieldTypeLabels, fieldsView, tablesView };

package/dist/view-access.js

@@ -306,6 +306,7 @@ const actionShape = (model, models, createPages) => shapes.object({
 const viewShape = (resource, model, models, prompted, createPages, writeOnly) => {
 	const nav = shapes.object({
 		hidden: shapes.data,
+		creatorsOnly: shapes.data,
 		group: shapes.data,
 		order: shapes.data,
 		tenant: shapes.data,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/server",
-  "version": "0.68.0",
+  "version": "0.68.2",
   "description": "The Protobase REST API as a Hono app, with Better Auth sign-in.",
   "license": "Apache-2.0",
   "repository": {
@@ -44,11 +44,11 @@
     "@better-auth/sso": "^1.7.12",
     "@livekit/protocol": "1.53.1",
     "@modelcontextprotocol/server": "^2.3.1",
-    "@protobase/layout": "0.68.0",
-    "@protobase/query": "0.68.0",
-    "@protobase/schema": "0.68.0",
-    "@protobase/workflow-plugins": "0.68.0",
-    "@protobase/workflows": "0.68.0",
+    "@protobase/layout": "0.68.2",
+    "@protobase/query": "0.68.2",
+    "@protobase/schema": "0.68.2",
+    "@protobase/workflow-plugins": "0.68.2",
+    "@protobase/workflows": "0.68.2",
     "@react-email/render": "^2.1.0",
     "@react-pdf/primitives": "^4.4.0",
     "@react-pdf/renderer": "^4.9.0",