@atscript/moost-ui-presets 0.1.58

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artem Maltsev <artem@maltsev.nl>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @atscript/moost-ui-presets
+
+Moost controller + `.as` schema for persisting [`@atscript/vue-table`](../vue-table) presets on the server.
+
+Part of the [atscript-ui](https://github.com/moostjs/atscript-ui) monorepo.
+
+## What it provides
+
+- A drop-in Moost controller exposing CRUD endpoints for table presets (per-user, per-table)
+- The `.as` schema and DB record for preset storage, backed by [`@atscript/moost-db`](https://github.com/moostjs/atscript-db)
+- Wire-compatible with the preset payload that [`@atscript/ui-table`](../ui-table) serializes
+
+## Install
+
+```sh
+pnpm add @atscript/moost-ui-presets
+```
+
+Peer requirements: `moost`, `@moostjs/event-http`, `@atscript/db`, `@atscript/moost-db`, `@atscript/ui-table`.
+
+## License
+
+MIT © Artem Maltsev

package/dist/as-preset-entry-BCmIVhgQ.mjs

@@ -0,0 +1,56 @@
+import { defineAnnotatedType, throwFeatureDisabled } from "@atscript/typescript/utils";
+//#region src/as-capabilities-query.as
+var AsCapabilitiesQuery = class {
+	static __is_atscript_annotated_type = true;
+	static type = {};
+	static metadata = /* @__PURE__ */ new Map();
+	static id = "AsCapabilitiesQuery";
+	static toJsonSchema() {
+		throwFeatureDisabled("JSON Schema", "jsonSchema", "emit.jsonSchema");
+	}
+};
+defineAnnotatedType("object", AsCapabilitiesQuery).prop("app", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).$type).prop("tableKey", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 1 }).$type);
+//#endregion
+//#region src/as-preset-entry.as
+var PresetId = class {
+	static __is_atscript_annotated_type = true;
+	static type = {};
+	static metadata = /* @__PURE__ */ new Map();
+	static id = "PresetId";
+	static toJsonSchema() {
+		throwFeatureDisabled("JSON Schema", "jsonSchema", "emit.jsonSchema");
+	}
+};
+var FieldPath = class {
+	static __is_atscript_annotated_type = true;
+	static type = {};
+	static metadata = /* @__PURE__ */ new Map();
+	static id = "FieldPath";
+	static toJsonSchema() {
+		throwFeatureDisabled("JSON Schema", "jsonSchema", "emit.jsonSchema");
+	}
+};
+var PresetAspect = class {
+	static __is_atscript_annotated_type = true;
+	static type = {};
+	static metadata = /* @__PURE__ */ new Map();
+	static id = "PresetAspect";
+	static toJsonSchema() {
+		throwFeatureDisabled("JSON Schema", "jsonSchema", "emit.jsonSchema");
+	}
+};
+var AsPresetEntry = class {
+	static __is_atscript_annotated_type = true;
+	static type = {};
+	static metadata = /* @__PURE__ */ new Map();
+	static id = "AsPresetEntry";
+	static toJsonSchema() {
+		throwFeatureDisabled("JSON Schema", "jsonSchema", "emit.jsonSchema");
+	}
+};
+defineAnnotatedType("", PresetId).designType("string").tags("string").annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 3 });
+defineAnnotatedType("", FieldPath).designType("string").tags("string").annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 });
+defineAnnotatedType("union", PresetAspect).item(defineAnnotatedType().designType("string").value("columns").$type).item(defineAnnotatedType().designType("string").value("filters").$type).item(defineAnnotatedType().designType("string").value("filterOps").$type).item(defineAnnotatedType().designType("string").value("sorters").$type).item(defineAnnotatedType().designType("string").value("itemsPerPage").$type);
+defineAnnotatedType("object", AsPresetEntry).prop("id", defineAnnotatedType().designType("string").tags("string").annotate("meta.id", true).annotate("db.default.uuid", true).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 3 }).$type).prop("type", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("preset").$type).item(defineAnnotatedType().designType("string").value("userConf").$type).item(defineAnnotatedType().designType("string").value("appConf").$type).annotate("db.index.plain", { name: "preset_scope_idx" }, true).$type).prop("app", defineAnnotatedType().designType("string").tags("string").annotate("db.index.plain", { name: "preset_scope_idx" }, true).annotate("db.index.unique", "preset_public_label_idx", true).annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).$type).prop("tableKey", defineAnnotatedType().designType("string").tags("string").annotate("db.index.plain", { name: "preset_scope_idx" }, true).annotate("db.index.unique", "preset_public_label_idx", true).annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 1 }).optional().$type).prop("user", defineAnnotatedType().designType("string").tags("string").annotate("db.index.plain", { name: "preset_scope_idx" }, true).annotate("db.index.plain", { name: "preset_user_idx" }, true).annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).annotate("db.default", "").$type).prop("userLabel", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).optional().$type).prop("public", defineAnnotatedType().designType("boolean").tags("boolean").annotate("db.index.plain", { name: "preset_public_idx" }, true).optional().$type).prop("label", defineAnnotatedType().designType("string").tags("string").annotate("db.index.plain", { name: "preset_label_idx" }, true).annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).optional().$type).prop("publicLabel", defineAnnotatedType().designType("string").tags("string").annotate("db.index.unique", "preset_public_label_idx", true).annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).optional().$type).prop("aspects", defineAnnotatedType("array").of(defineAnnotatedType().refTo(PresetAspect).$type).annotate("expect.array.uniqueItems", {}).optional().$type).prop("data", defineAnnotatedType("union").item(defineAnnotatedType("object").prop("label", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 128 }).annotate("expect.minLength", { length: 1 }).$type).prop("content", defineAnnotatedType("object").prop("columns", defineAnnotatedType("object").prop("columnNames", defineAnnotatedType("array").of(defineAnnotatedType().refTo(FieldPath).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 }).$type).$type).prop("columnWidths", defineAnnotatedType("array").of(defineAnnotatedType("object").prop("field", defineAnnotatedType().refTo(FieldPath).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 }).$type).prop("width", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 32 }).annotate("expect.minLength", { length: 1 }).$type).$type).optional().$type).optional().$type).prop("filters", defineAnnotatedType("array").of(defineAnnotatedType().refTo(FieldPath).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 }).$type).optional().$type).prop("filterOps", defineAnnotatedType("array").of(defineAnnotatedType("object").prop("field", defineAnnotatedType().refTo(FieldPath).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 }).$type).prop("conditions", defineAnnotatedType("array").of(defineAnnotatedType("object").prop("type", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("eq").$type).item(defineAnnotatedType().designType("string").value("ne").$type).item(defineAnnotatedType().designType("string").value("gt").$type).item(defineAnnotatedType().designType("string").value("gte").$type).item(defineAnnotatedType().designType("string").value("lt").$type).item(defineAnnotatedType().designType("string").value("lte").$type).item(defineAnnotatedType().designType("string").value("contains").$type).item(defineAnnotatedType().designType("string").value("starts").$type).item(defineAnnotatedType().designType("string").value("ends").$type).item(defineAnnotatedType().designType("string").value("bw").$type).item(defineAnnotatedType().designType("string").value("null").$type).item(defineAnnotatedType().designType("string").value("notNull").$type).item(defineAnnotatedType().designType("string").value("regex").$type).$type).prop("value", defineAnnotatedType("array").of(defineAnnotatedType("union").item(defineAnnotatedType().designType("string").tags("string").$type).item(defineAnnotatedType().designType("number").tags("number").$type).item(defineAnnotatedType().designType("boolean").tags("boolean").$type).$type).$type).$type).$type).$type).optional().$type).prop("sorters", defineAnnotatedType("array").of(defineAnnotatedType("object").prop("field", defineAnnotatedType().refTo(FieldPath).annotate("expect.maxLength", { length: 256 }).annotate("expect.minLength", { length: 1 }).$type).prop("direction", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("asc").$type).item(defineAnnotatedType().designType("string").value("desc").$type).$type).$type).optional().$type).prop("itemsPerPage", defineAnnotatedType().designType("number").tags("number").optional().$type).optional().$type).$type).item(defineAnnotatedType("object").prop("defaultPresetId", defineAnnotatedType().refTo(PresetId).annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 3 }).optional().$type).prop("favPresetIds", defineAnnotatedType("array").of(defineAnnotatedType().refTo(PresetId).annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 3 }).$type).optional().$type).$type).item(defineAnnotatedType("object").prop("appearance", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("system").$type).item(defineAnnotatedType().designType("string").value("light").$type).item(defineAnnotatedType().designType("string").value("dark").$type).optional().$type).prop("language", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 5 }).annotate("expect.minLength", { length: 2 }).optional().$type).prop("timezone", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 64 }).annotate("expect.minLength", { length: 3 }).optional().$type).prop("density", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("compact").$type).item(defineAnnotatedType().designType("string").value("cozy").$type).item(defineAnnotatedType().designType("string").value("comfortable").$type).optional().$type).prop("dateFormat", defineAnnotatedType("union").item(defineAnnotatedType().designType("string").value("iso").$type).item(defineAnnotatedType().designType("string").value("us").$type).item(defineAnnotatedType().designType("string").value("eu").$type).optional().$type).prop("firstDayOfWeek", defineAnnotatedType("union").item(defineAnnotatedType().designType("number").value(0).$type).item(defineAnnotatedType().designType("number").value(1).$type).item(defineAnnotatedType().designType("number").value(6).$type).optional().$type).prop("customJson", defineAnnotatedType().designType("string").tags("string").annotate("expect.maxLength", { length: 1024 }).optional().$type).$type).annotate("db.json", true).$type).prop("createdAt", defineAnnotatedType().designType("number").tags("number").annotate("db.default.now", true).$type).prop("updatedAt", defineAnnotatedType().designType("number").tags("number").annotate("db.default.now", true).$type).annotate("db.table", "as_presets");
+//#endregion
+export { AsCapabilitiesQuery as n, AsPresetEntry as t };

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+import { n as AsCapabilitiesQuery, t as AsPresetEntry } from "./as-preset-entry-BCmIVhgQ.mjs";
+import { AsDbController } from "@atscript/moost-db";
+import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
+import { APP_CONF_PREFIX, AppConfData, AsPresetEntryData, AsPresetsErrorCode, FilterCondition, FilterConditionType, PRESET_ASPECTS, PresetAspect, PresetCapabilities, PresetCapabilities as PresetCapabilities$1, PresetData, PresetLimitReachedBody, PresetSnapshotWire, RESERVED_ID_PREFIXES, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, UserConfData, appConfId, userConfId } from "@atscript/ui-table";
+import { FilterExpr } from "@uniqu/core";
+
+//#region src/preset-rules.d.ts
+type WriteAction = "insert" | "insertMany" | "replace" | "replaceMany" | "update" | "updateMany";
+//#endregion
+//#region src/as-presets.controller.d.ts
+declare abstract class AsPresetsController<T extends TAtscriptAnnotatedType = typeof AsPresetEntry> extends AsDbController<T> {
+  protected maxPresetsPerUser: number;
+  protected abstract getCurrentUser(): Promise<string>;
+  /** Override for tiered logic (admin / paid / free). */
+  protected getMaxPresetsPerUser(_app: string, _tableKey: string, _user: string): Promise<number>;
+  /** Override to scope public-preset creation per app/table/user. */
+  protected canPublishPresets(_app: string, _tableKey: string, _user: string): Promise<boolean>;
+  protected getUserLabel(_user: string): Promise<string | undefined>;
+  private get hooks();
+  private get presetTable();
+  capabilities(query: AsCapabilitiesQuery): Promise<PresetCapabilities$1>;
+  protected transformFilter(filter: FilterExpr): Promise<FilterExpr>;
+  protected onWrite(action: WriteAction, data: unknown): Promise<unknown>;
+  protected onRemove(id: unknown): Promise<unknown>;
+}
+//#endregion
+export { APP_CONF_PREFIX, type AppConfData, AsPresetEntry, type AsPresetEntryData, AsPresetsController, type AsPresetsErrorCode, type FilterCondition, type FilterConditionType, PRESET_ASPECTS, type PresetAspect, type PresetCapabilities, type PresetData, type PresetLimitReachedBody, type PresetSnapshotWire, RESERVED_ID_PREFIXES, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, type UserConfData, appConfId, userConfId };

package/dist/index.mjs

@@ -0,0 +1,386 @@
+import { n as AsCapabilitiesQuery, t as AsPresetEntry } from "./as-preset-entry-BCmIVhgQ.mjs";
+import { AsDbController } from "@atscript/moost-db";
+import { Get, HttpError, Query } from "@moostjs/event-http";
+import { Inherit } from "moost";
+import { APP_CONF_PREFIX, PRESET_ASPECTS, RESERVED_ID_PREFIXES, RESERVED_ID_PREFIXES as RESERVED_ID_PREFIXES$1, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, appConfId, appConfId as appConfId$1, derivePresetAspects, isSystemPresetId, userConfId, userConfId as userConfId$1 } from "@atscript/ui-table";
+import { walkFilter } from "@uniqu/core";
+//#region src/preset-rules.ts
+const IDENTITY_FIELDS = [
+	"user",
+	"app",
+	"tableKey"
+];
+const SUPPORTED_ACTIONS = new Set(["insert", "update"]);
+const ROW_TYPES = [
+	"preset",
+	"userConf",
+	"appConf"
+];
+function isRowType(t) {
+	return ROW_TYPES.includes(t);
+}
+function scrubPresetOnlyFields(row) {
+	row.public = void 0;
+	row.label = void 0;
+	row.publicLabel = void 0;
+	row.aspects = void 0;
+}
+function presetError(status, body) {
+	return new HttpError(status, body);
+}
+function requireString(value, message, code) {
+	if (typeof value !== "string" || value.length === 0) throw presetError(400, {
+		message,
+		code
+	});
+}
+function assertNotReservedId(id) {
+	if (typeof id !== "string") return;
+	for (const prefix of RESERVED_ID_PREFIXES$1) if (id.startsWith(prefix)) throw presetError(400, {
+		message: `Reserved id namespace '${prefix}'; server owns these ids`,
+		code: "reserved_id"
+	});
+}
+function assertNotSystemId(id) {
+	if (typeof id === "string" && isSystemPresetId(id)) throw presetError(400, {
+		message: "Reserved id namespace; system presets are synthetic and not persisted",
+		code: "reserved_id"
+	});
+}
+const readGateVisitor = {
+	comparison(field, op, value) {
+		if (op !== "$eq") return { isAppConf: false };
+		if (field === "type") return { isAppConf: value === "appConf" };
+		if (typeof value !== "string") return { isAppConf: false };
+		if (field === "app") return {
+			app: value,
+			isAppConf: false
+		};
+		if (field === "tableKey") return {
+			tableKey: value,
+			isAppConf: false
+		};
+		return { isAppConf: false };
+	},
+	and(children) {
+		const out = { isAppConf: false };
+		for (const c of children) {
+			if (out.app === void 0 && c.app !== void 0) out.app = c.app;
+			if (out.tableKey === void 0 && c.tableKey !== void 0) out.tableKey = c.tableKey;
+			if (c.isAppConf) out.isAppConf = true;
+		}
+		return out;
+	},
+	or: () => ({ isAppConf: false }),
+	not: () => ({ isAppConf: false })
+};
+function buildReadGate(user, filter) {
+	const probe = walkFilter(filter ?? void 0, readGateVisitor) ?? { isAppConf: false };
+	requireString(probe.app, "Preset reads must include 'app'", "missing_scope");
+	if (!probe.isAppConf) requireString(probe.tableKey, "Preset / userConf reads must include 'tableKey'", "missing_scope");
+	const gate = { $or: [{ user }, { $and: [{ type: "preset" }, { public: true }] }] };
+	return filter ? { $and: [gate, filter] } : gate;
+}
+const EXISTING_SELECT = {
+	id: 1,
+	type: 1,
+	user: 1,
+	app: 1,
+	tableKey: 1,
+	public: 1,
+	label: 1,
+	data: 1
+};
+function fetchExisting(ctx, id) {
+	return ctx.table.findOne({
+		filter: { id },
+		controls: { $select: EXISTING_SELECT }
+	});
+}
+async function processWrite(table, user, action, data, hooks) {
+	if (!SUPPORTED_ACTIONS.has(action)) throw presetError(405, {
+		message: `Action '${action}' is not supported; use insert or update one row at a time`,
+		code: "action_unsupported"
+	});
+	const ctx = {
+		table,
+		user,
+		hooks
+	};
+	const row = data;
+	if (action === "update") return processUpdateRow(ctx, row);
+	return processCreateRow(ctx, row);
+}
+async function processCreateRow(ctx, row) {
+	const { user, hooks } = ctx;
+	const next = { ...row };
+	next.user = user;
+	const userLabelPromise = hooks.getUserLabel?.(user);
+	const now = Date.now();
+	next.updatedAt = now;
+	if (typeof next.createdAt !== "number") next.createdAt = now;
+	if (!isRowType(next.type)) throw presetError(400, {
+		message: "type must be 'preset', 'userConf', or 'appConf'",
+		code: "invalid_type"
+	});
+	requireString(next.app, "'app' is required", "missing_scope");
+	if (next.type === "appConf") {
+		next.tableKey = void 0;
+		next.id = appConfId$1(user, next.app);
+		scrubPresetOnlyFields(next);
+		next.userLabel = await userLabelPromise;
+		return next;
+	}
+	requireString(next.tableKey, "'tableKey' is required for preset / userConf rows", "missing_scope");
+	if (next.type === "userConf") {
+		next.id = userConfId$1(user, next.app, next.tableKey);
+		scrubPresetOnlyFields(next);
+		await sanitiseUserConfData(ctx, next, next.app, next.tableKey);
+		next.userLabel = await userLabelPromise;
+		return next;
+	}
+	assertNotReservedId(next.id);
+	if (typeof next.id !== "string" || next.id.length === 0) next.id = globalThis.crypto.randomUUID();
+	next.label = readPresetLabel(next.data);
+	next.publicLabel = next.public === true ? next.label : void 0;
+	const capCheck = assertWithinCap(ctx, next.app, next.tableKey);
+	const publicCheck = next.public === true ? gatePublicPreset(ctx, next.app, next.tableKey, null, {
+		public: true,
+		label: next.label,
+		id: next.id
+	}) : void 0;
+	const [, , userLabel] = await Promise.all([
+		capCheck,
+		publicCheck,
+		userLabelPromise
+	]);
+	next.userLabel = userLabel;
+	next.aspects = derivePresetAspects(next.data?.content);
+	return next;
+}
+async function gatePublicPreset(ctx, app, tableKey, prev, next) {
+	if (!next.public) return;
+	const wasPublic = prev?.public === true;
+	const labelChanged = !wasPublic || prev?.label !== next.label;
+	const publishCheck = wasPublic ? void 0 : assertCanPublish(ctx, app, tableKey);
+	const labelCheck = labelChanged ? assertPublicLabelFree(ctx, app, tableKey, next.label, next.id) : void 0;
+	await Promise.all([publishCheck, labelCheck]);
+}
+const ownerError = () => presetError(404, {
+	message: "Preset not found",
+	code: "preset_not_found"
+});
+function requireOwner(existing, user) {
+	if (!existing || existing.user !== user) throw ownerError();
+}
+async function processUpdateRow(ctx, row) {
+	const { user, hooks } = ctx;
+	const next = { ...row };
+	requireString(next.id, "Update payload must include 'id'", "missing_id");
+	assertNotSystemId(next.id);
+	const existing = await fetchExisting(ctx, next.id);
+	requireOwner(existing, user);
+	const userLabelPromise = hooks.getUserLabel?.(user);
+	if (next.type !== void 0 && next.type !== existing.type) throw presetError(400, {
+		message: "Field 'type' is immutable after create",
+		code: "type_immutable"
+	});
+	for (const key of IDENTITY_FIELDS) if (next[key] !== void 0 && next[key] !== existing[key]) throw presetError(400, {
+		message: `Field '${key}' is immutable after create`,
+		code: "identity_immutable"
+	});
+	next.updatedAt = Date.now();
+	const mergedData = next.data === void 0 ? existing.data ?? null : {
+		...existing.data,
+		...next.data
+	};
+	if (next.data !== void 0) next.data = mergedData;
+	if (existing.type === "appConf") {
+		next.tableKey = void 0;
+		scrubPresetOnlyFields(next);
+		next.userLabel = await userLabelPromise;
+		return next;
+	}
+	const app = existing.app;
+	const tableKey = existing.tableKey;
+	if (existing.type === "userConf") {
+		scrubPresetOnlyFields(next);
+		if (mergedData.defaultPresetId !== existing.data?.defaultPresetId) await sanitiseUserConfData(ctx, next, app, tableKey);
+		next.userLabel = await userLabelPromise;
+		return next;
+	}
+	const wasPublic = existing.public === true;
+	const willBePublic = next.public ?? wasPublic;
+	const prevLabel = existing.label ?? readPresetLabel(existing.data);
+	const nextLabel = readPresetLabel(mergedData);
+	next.label = nextLabel;
+	next.publicLabel = willBePublic ? nextLabel : void 0;
+	const [, userLabel] = await Promise.all([gatePublicPreset(ctx, app, tableKey, {
+		public: wasPublic,
+		label: prevLabel
+	}, {
+		public: willBePublic,
+		label: nextLabel,
+		id: existing.id
+	}), userLabelPromise]);
+	next.userLabel = userLabel;
+	if (next.data !== void 0 && typeof next.data === "object" && next.data !== null && "content" in next.data) next.aspects = derivePresetAspects(mergedData?.content);
+	return next;
+}
+async function processRemove(table, id, user) {
+	requireString(id, "id must be a string", "missing_scope");
+	assertNotSystemId(id);
+	requireOwner(await table.findOne({
+		filter: { id },
+		controls: { $select: {
+			id: 1,
+			user: 1
+		} }
+	}), user);
+	return id;
+}
+async function assertPublicLabelFree(ctx, app, tableKey, label, excludingId) {
+	if (!label) return;
+	const filter = {
+		type: "preset",
+		public: true,
+		app,
+		tableKey,
+		label
+	};
+	if (excludingId) filter.id = { $ne: excludingId };
+	if (await ctx.table.findOne({
+		filter,
+		controls: { $select: { id: 1 } }
+	})) throw presetError(409, {
+		message: `Public preset "${label}" already exists`,
+		code: "public_name_conflict"
+	});
+}
+async function assertCanPublish(ctx, app, tableKey) {
+	if (!await ctx.hooks.canPublishPresets(app, tableKey, ctx.user)) throw presetError(403, {
+		message: "Forbidden — current user cannot publish presets in this scope",
+		code: "publish_forbidden"
+	});
+}
+async function buildCapabilities(app, tableKey, user, hooks) {
+	requireString(app, "'app' query param is required", "missing_scope");
+	requireString(tableKey, "'tableKey' query param is required", "missing_scope");
+	const [canPublish, presetLimit] = await Promise.all([hooks.canPublishPresets(app, tableKey, user), hooks.getMaxPresetsPerUser(app, tableKey, user)]);
+	return {
+		canPublish,
+		presetLimit,
+		userId: user
+	};
+}
+async function assertWithinCap(ctx, app, tableKey) {
+	const { table, user, hooks } = ctx;
+	const [limit, count] = await Promise.all([hooks.getMaxPresetsPerUser(app, tableKey, user), table.count({ filter: {
+		type: "preset",
+		user,
+		app,
+		tableKey
+	} })]);
+	if (count >= limit) throw presetError(409, {
+		message: `Preset limit reached (${count}/${limit})`,
+		code: "preset_limit_reached",
+		limit,
+		count
+	});
+}
+async function sanitiseUserConfData(ctx, row, app, tableKey) {
+	if (!row.data || typeof row.data !== "object") return;
+	const data = row.data;
+	const ref = data.defaultPresetId;
+	if (typeof ref !== "string" || ref.length === 0) return;
+	if (isSystemPresetId(ref)) return;
+	const { table, user } = ctx;
+	const target = await table.findOne({
+		filter: { id: ref },
+		controls: { $select: {
+			app: 1,
+			tableKey: 1,
+			type: 1,
+			user: 1,
+			public: 1
+		} }
+	});
+	if (!(target && target.app === app && target.tableKey === tableKey && target.type === "preset" && (target.user === user || target.public === true))) delete data.defaultPresetId;
+}
+function readPresetLabel(data) {
+	if (data && typeof data === "object" && "label" in data) {
+		const label = data.label;
+		if (typeof label === "string") return label;
+	}
+	return "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.115.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+//#endregion
+//#region src/as-presets.controller.ts
+var _ref;
+let AsPresetsController = class AsPresetsController extends AsDbController {
+	maxPresetsPerUser = 10;
+	/** Override for tiered logic (admin / paid / free). */
+	async getMaxPresetsPerUser(_app, _tableKey, _user) {
+		return this.maxPresetsPerUser;
+	}
+	/** Override to scope public-preset creation per app/table/user. */
+	async canPublishPresets(_app, _tableKey, _user) {
+		return true;
+	}
+	async getUserLabel(_user) {}
+	get hooks() {
+		return {
+			getMaxPresetsPerUser: this.getMaxPresetsPerUser.bind(this),
+			canPublishPresets: this.canPublishPresets.bind(this),
+			getUserLabel: this.getUserLabel.bind(this)
+		};
+	}
+	get presetTable() {
+		return this.table;
+	}
+	async capabilities(query) {
+		const user = await this.getCurrentUser();
+		return buildCapabilities(query.app, query.tableKey, user, this.hooks);
+	}
+	async transformFilter(filter) {
+		return buildReadGate(await this.getCurrentUser(), filter);
+	}
+	async onWrite(action, data) {
+		const user = await this.getCurrentUser();
+		return processWrite(this.presetTable, user, action, data, this.hooks);
+	}
+	async onRemove(id) {
+		const user = await this.getCurrentUser();
+		return processRemove(this.presetTable, id, user);
+	}
+};
+__decorate([
+	Get("capabilities"),
+	__decorateParam(0, Query()),
+	__decorateMetadata("design:type", Function),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof AsCapabilitiesQuery !== "undefined" && AsCapabilitiesQuery) === "function" ? _ref : Object]),
+	__decorateMetadata("design:returntype", Promise)
+], AsPresetsController.prototype, "capabilities", null);
+AsPresetsController = __decorate([Inherit()], AsPresetsController);
+//#endregion
+export { APP_CONF_PREFIX, AsPresetEntry, AsPresetsController, PRESET_ASPECTS, RESERVED_ID_PREFIXES, SYSTEM_PRESET_PREFIX, USER_CONF_PREFIX, appConfId, userConfId };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@atscript/moost-ui-presets",
+  "version": "0.1.58",
+  "description": "Moost controller and atscript schema for table-preset persistence — server-side persistence layer for atscript-ui table presets",
+  "keywords": [
+    "atscript",
+    "controller",
+    "metadata",
+    "moost",
+    "persistence",
+    "preset",
+    "table",
+    "typescript"
+  ],
+  "homepage": "https://github.com/moostjs/atscript-ui/tree/main/packages/moost-ui-presets#readme",
+  "bugs": {
+    "url": "https://github.com/moostjs/atscript-ui/issues"
+  },
+  "license": "MIT",
+  "author": "Artem Maltsev <artem@maltsev.nl>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moostjs/atscript-ui.git",
+    "directory": "packages/moost-ui-presets"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@atscript/core": "^0.1.54",
+    "@atscript/db": "^0.1.75",
+    "@atscript/db-sqlite": "^0.1.75",
+    "@atscript/moost-db": "^0.1.75",
+    "@atscript/typescript": "^0.1.54",
+    "@moostjs/event-http": "^0.6.9",
+    "@swc/core": "^1.15.18",
+    "@uniqu/core": "^0.1.6",
+    "@wooksjs/event-http": "^0.7.11",
+    "moost": "^0.6.9",
+    "unplugin-atscript": "^0.1.54",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
+    "@atscript/ui-table": "0.1.58"
+  },
+  "peerDependencies": {
+    "@atscript/core": "^0.1.54",
+    "@atscript/db": "^0.1.75",
+    "@atscript/moost-db": "^0.1.75",
+    "@atscript/typescript": "^0.1.54",
+    "@moostjs/event-http": "^0.6.9",
+    "moost": "^0.6.9",
+    "@atscript/ui-table": "^0.1.58"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}