@phtngyn/cms 0.2.0-beta.7 → 0.3.0

package/src/StudioErrors-T5zLGQ1M.js

@@ -0,0 +1,117 @@
+import { n as createTranslator } from "./I18n-Ckf9h0rC.js";
+import { Record, Schema } from "effect";
+//#region ../model/src/StudioErrors.ts
+/** Stable built-in failure reasons. Site-provided validation messages have no code. */
+const studioErrorMessages = {
+	"errors.request.invalid": "Please check the request and try again.",
+	"errors.request.trashPlan": "Trash plan does not match the page.",
+	"errors.request.workingVector": "A valid working state vector is required.",
+	"errors.auth.required": "Authentication required.",
+	"errors.auth.sameOrigin": "Same-origin request required.",
+	"errors.auth.editorRequired": "Editor access required.",
+	"errors.auth.administratorRequired": "Administrator access required.",
+	"errors.auth.alreadyInitialized": "Studio has already been initialized.",
+	"errors.auth.invalidSecret": "Invalid installation secret.",
+	"errors.auth.secretLength": "The installation secret must have at least 32 characters.",
+	"errors.document.notFound": "Document not found.",
+	"errors.document.changed": "Document changed; refresh and try again.",
+	"errors.document.homeReplace": "A collection home cannot be replaced or moved.",
+	"errors.document.homeMove": "A collection home cannot be moved.",
+	"errors.document.homePlacement": "Only the collection home can use the home placement.",
+	"errors.document.homeOffline": "A collection home cannot be taken offline.",
+	"errors.document.homeTrash": "A collection home cannot be moved to Trash.",
+	"errors.document.starterUnavailable": "This starter is no longer available.",
+	"errors.document.restoreEarlier": "Select an earlier revision to restore.",
+	"errors.document.translationLanguage": "Choose a configured nondefault language.",
+	"errors.document.translationLocale": "Translation language \"{locale}\" must be a configured nondefault language.",
+	"errors.document.referencedInTrash": "Unpublish or update \"{title}\" before moving its referenced page to Trash.",
+	"errors.collection.notConfigured": "Collection \"{collection}\" is not configured.",
+	"errors.collection.unavailable": "Collection is not configured.",
+	"errors.language.notConfigured": "Language \"{locale}\" is not configured.",
+	"errors.route.collection": "Collection \"{collection}\" does not exist.",
+	"errors.route.pattern": "Collection \"{collection}\" has an invalid route pattern.",
+	"errors.route.cycle": "Document placement has a cycle.",
+	"errors.route.home": "Collection has more than one home document.",
+	"errors.route.parent": "Document parent is missing or belongs to another collection.",
+	"errors.route.locale": "Public route \"{path}\" conflicts with a configured locale prefix.",
+	"errors.route.collision": "Another page uses the public address \"{path}\". Choose a different address.",
+	"errors.form.structure": "Each form needs steps with a title and at least one valid question.",
+	"errors.form.size": "This form is too large. Reduce the number or size of questions.",
+	"errors.form.identity": "Steps and questions must have unique identities.",
+	"errors.form.answerKeys": "Questions must have unique answer keys.",
+	"errors.form.answerKeyReserved": "This question answer key is reserved.",
+	"errors.form.typeUnavailable": "{label}: this question type is unavailable.",
+	"errors.form.requiredUnavailable": "{label}: making a question required is unavailable.",
+	"errors.form.minLengthUnavailable": "{label}: a minimum character limit is unavailable.",
+	"errors.form.maxLengthUnavailable": "{label}: a maximum character limit is unavailable.",
+	"errors.form.minUnavailable": "{label}: a minimum value is unavailable.",
+	"errors.form.maxUnavailable": "{label}: a maximum value is unavailable.",
+	"errors.form.textLimits": "{label}: length limits require a text question.",
+	"errors.form.numberLimits": "{label}: numeric limits require a number question.",
+	"errors.form.range": "{label}: minimum exceeds maximum.",
+	"errors.form.lengthRange": "{label}: minimum length exceeds maximum length.",
+	"errors.form.options": "{label}: choices need unique identities and at least one option.",
+	"errors.form.selectOptions": "{label}: choices require a select question.",
+	"errors.publication.duplicate": "Choose each page only once.",
+	"errors.publication.revisionMissing": "Selected revision is missing.",
+	"errors.publication.alreadyOffline": "This page is already offline.",
+	"errors.publication.reviewChanged": "Content changed while you were reviewing. Check the publication impact again.",
+	"errors.schedule.name": "Give the release a name of at most 120 characters.",
+	"errors.schedule.actor": "A scheduling actor is required.",
+	"errors.schedule.future": "Choose a future publication time.",
+	"errors.schedule.planChanged": "The publication plan changed. Check again before scheduling.",
+	"errors.schedule.notPending": "This release is no longer pending.",
+	"errors.schedule.runTime": "Invalid publication run time.",
+	"errors.schedule.conflict": "The scheduled publication conflicts with the current live page.",
+	"errors.schedule.missingPage": "A selected page is no longer available. Review and schedule publication again.",
+	"errors.schedule.alreadyScheduled": "A selected page already has an outstanding publication schedule. Cancel it before scheduling another.",
+	"errors.revisionPreview.unavailable": "Revision preview unavailable.",
+	"errors.revisionPreview.expiry": "Expiry must be a future ISO timestamp within 24 hours.",
+	"errors.revisionPreview.path": "Invalid preview path.",
+	"errors.revisionPreview.language": "The requested language is unavailable in this revision.",
+	"errors.revisionPreview.query": "Invalid document query.",
+	"errors.media.notFound": "Media asset not found.",
+	"errors.media.changed": "This media asset changed; refresh and try again.",
+	"errors.media.upload": "Invalid media upload.",
+	"errors.media.uploadConfiguration": "The media upload limit must be a positive byte count.",
+	"errors.media.uploadLimit": "Media exceeds the {limit} byte upload limit.",
+	"errors.media.sizeExceeded": "Media body exceeds its declared size.",
+	"errors.media.sizeMismatch": "Media body size does not match its declaration.",
+	"errors.media.typeMismatch": "The upload is not a supported file of its declared media type.",
+	"errors.media.checksum": "Media body checksum does not match its declaration.",
+	"errors.media.folderInvalid": "Enter a valid folder name.",
+	"errors.media.folderRequired": "Enter a folder name.",
+	"errors.media.folderExists": "A folder with this name already exists.",
+	"errors.media.inUse": "This file is used by saved content, a working document, or site SEO settings.",
+	"errors.seo.changed": "Site SEO changed; refresh and try again.",
+	"errors.seo.confirmationRequired": "Confirmation required.",
+	"errors.activity.invalidCursor": "Invalid Activity cursor.",
+	"errors.people.notFound": "Person not found.",
+	"errors.people.emailExists": "A person with this email already exists.",
+	"errors.people.ownRole": "You cannot change your own role.",
+	"errors.people.ownAccount": "You cannot remove your own account.",
+	"errors.people.invalidRole": "Person has an invalid role.",
+	"errors.people.secureRandom": "Secure random generation is unavailable.",
+	"errors.people.failed": "User administration failed.",
+	"errors.content.duplicateDocument": "Duplicate document {documentId} in content bundle.",
+	"errors.content.plannedMissing": "Planned document is missing from the import.",
+	"errors.content.unchangedMissing": "Unchanged document is missing from the installation.",
+	"errors.content.changeMissing": "Planned document has no validated change.",
+	"errors.internal": "Internal server error."
+};
+const StudioErrorCode = Schema.Literals(Record.keys(studioErrorMessages));
+const StudioErrorFields = {
+	code: Schema.optional(StudioErrorCode),
+	details: Schema.optional(Schema.Record(Schema.String, Schema.Union([Schema.String, Schema.Finite])))
+};
+const translate = createTranslator(studioErrorMessages, { fallbackLocale: "en" });
+/** Creates typed reason metadata and the readable API fallback at the failure site. */
+function studioErrorReason(code, ...args) {
+	return {
+		code,
+		details: args[0],
+		message: translate("en", code, ...args)
+	};
+}
+//#endregion
+export { studioErrorReason as i, StudioErrorFields as n, studioErrorMessages as r, StudioErrorCode as t };

package/src/StudioErrors-kq-E44lQ.d.ts

@@ -0,0 +1,104 @@
+import { Schema } from "effect";
+//#region ../model/src/StudioErrors.d.ts
+/** Stable built-in failure reasons. Site-provided validation messages have no code. */
+declare const studioErrorMessages: {
+  readonly 'errors.request.invalid': "Please check the request and try again.";
+  readonly 'errors.request.trashPlan': "Trash plan does not match the page.";
+  readonly 'errors.request.workingVector': "A valid working state vector is required.";
+  readonly 'errors.auth.required': "Authentication required.";
+  readonly 'errors.auth.sameOrigin': "Same-origin request required.";
+  readonly 'errors.auth.editorRequired': "Editor access required.";
+  readonly 'errors.auth.administratorRequired': "Administrator access required.";
+  readonly 'errors.auth.alreadyInitialized': "Studio has already been initialized.";
+  readonly 'errors.auth.invalidSecret': "Invalid installation secret.";
+  readonly 'errors.auth.secretLength': "The installation secret must have at least 32 characters.";
+  readonly 'errors.document.notFound': "Document not found.";
+  readonly 'errors.document.changed': "Document changed; refresh and try again.";
+  readonly 'errors.document.homeReplace': "A collection home cannot be replaced or moved.";
+  readonly 'errors.document.homeMove': "A collection home cannot be moved.";
+  readonly 'errors.document.homePlacement': "Only the collection home can use the home placement.";
+  readonly 'errors.document.homeOffline': "A collection home cannot be taken offline.";
+  readonly 'errors.document.homeTrash': "A collection home cannot be moved to Trash.";
+  readonly 'errors.document.starterUnavailable': "This starter is no longer available.";
+  readonly 'errors.document.restoreEarlier': "Select an earlier revision to restore.";
+  readonly 'errors.document.translationLanguage': "Choose a configured nondefault language.";
+  readonly 'errors.document.translationLocale': "Translation language \"{locale}\" must be a configured nondefault language.";
+  readonly 'errors.document.referencedInTrash': "Unpublish or update \"{title}\" before moving its referenced page to Trash.";
+  readonly 'errors.collection.notConfigured': "Collection \"{collection}\" is not configured.";
+  readonly 'errors.collection.unavailable': "Collection is not configured.";
+  readonly 'errors.language.notConfigured': "Language \"{locale}\" is not configured.";
+  readonly 'errors.route.collection': "Collection \"{collection}\" does not exist.";
+  readonly 'errors.route.pattern': "Collection \"{collection}\" has an invalid route pattern.";
+  readonly 'errors.route.cycle': "Document placement has a cycle.";
+  readonly 'errors.route.home': "Collection has more than one home document.";
+  readonly 'errors.route.parent': "Document parent is missing or belongs to another collection.";
+  readonly 'errors.route.locale': "Public route \"{path}\" conflicts with a configured locale prefix.";
+  readonly 'errors.route.collision': "Another page uses the public address \"{path}\". Choose a different address.";
+  readonly 'errors.form.structure': "Each form needs steps with a title and at least one valid question.";
+  readonly 'errors.form.size': "This form is too large. Reduce the number or size of questions.";
+  readonly 'errors.form.identity': "Steps and questions must have unique identities.";
+  readonly 'errors.form.answerKeys': "Questions must have unique answer keys.";
+  readonly 'errors.form.answerKeyReserved': "This question answer key is reserved.";
+  readonly 'errors.form.typeUnavailable': "{label}: this question type is unavailable.";
+  readonly 'errors.form.requiredUnavailable': "{label}: making a question required is unavailable.";
+  readonly 'errors.form.minLengthUnavailable': "{label}: a minimum character limit is unavailable.";
+  readonly 'errors.form.maxLengthUnavailable': "{label}: a maximum character limit is unavailable.";
+  readonly 'errors.form.minUnavailable': "{label}: a minimum value is unavailable.";
+  readonly 'errors.form.maxUnavailable': "{label}: a maximum value is unavailable.";
+  readonly 'errors.form.textLimits': "{label}: length limits require a text question.";
+  readonly 'errors.form.numberLimits': "{label}: numeric limits require a number question.";
+  readonly 'errors.form.range': "{label}: minimum exceeds maximum.";
+  readonly 'errors.form.lengthRange': "{label}: minimum length exceeds maximum length.";
+  readonly 'errors.form.options': "{label}: choices need unique identities and at least one option.";
+  readonly 'errors.form.selectOptions': "{label}: choices require a select question.";
+  readonly 'errors.publication.duplicate': "Choose each page only once.";
+  readonly 'errors.publication.revisionMissing': "Selected revision is missing.";
+  readonly 'errors.publication.alreadyOffline': "This page is already offline.";
+  readonly 'errors.publication.reviewChanged': "Content changed while you were reviewing. Check the publication impact again.";
+  readonly 'errors.schedule.name': "Give the release a name of at most 120 characters.";
+  readonly 'errors.schedule.actor': "A scheduling actor is required.";
+  readonly 'errors.schedule.future': "Choose a future publication time.";
+  readonly 'errors.schedule.planChanged': "The publication plan changed. Check again before scheduling.";
+  readonly 'errors.schedule.notPending': "This release is no longer pending.";
+  readonly 'errors.schedule.runTime': "Invalid publication run time.";
+  readonly 'errors.schedule.conflict': "The scheduled publication conflicts with the current live page.";
+  readonly 'errors.schedule.missingPage': "A selected page is no longer available. Review and schedule publication again.";
+  readonly 'errors.schedule.alreadyScheduled': "A selected page already has an outstanding publication schedule. Cancel it before scheduling another.";
+  readonly 'errors.revisionPreview.unavailable': "Revision preview unavailable.";
+  readonly 'errors.revisionPreview.expiry': "Expiry must be a future ISO timestamp within 24 hours.";
+  readonly 'errors.revisionPreview.path': "Invalid preview path.";
+  readonly 'errors.revisionPreview.language': "The requested language is unavailable in this revision.";
+  readonly 'errors.revisionPreview.query': "Invalid document query.";
+  readonly 'errors.media.notFound': "Media asset not found.";
+  readonly 'errors.media.changed': "This media asset changed; refresh and try again.";
+  readonly 'errors.media.upload': "Invalid media upload.";
+  readonly 'errors.media.uploadConfiguration': "The media upload limit must be a positive byte count.";
+  readonly 'errors.media.uploadLimit': "Media exceeds the {limit} byte upload limit.";
+  readonly 'errors.media.sizeExceeded': "Media body exceeds its declared size.";
+  readonly 'errors.media.sizeMismatch': "Media body size does not match its declaration.";
+  readonly 'errors.media.typeMismatch': "The upload is not a supported file of its declared media type.";
+  readonly 'errors.media.checksum': "Media body checksum does not match its declaration.";
+  readonly 'errors.media.folderInvalid': "Enter a valid folder name.";
+  readonly 'errors.media.folderRequired': "Enter a folder name.";
+  readonly 'errors.media.folderExists': "A folder with this name already exists.";
+  readonly 'errors.media.inUse': "This file is used by saved content, a working document, or site SEO settings.";
+  readonly 'errors.seo.changed': "Site SEO changed; refresh and try again.";
+  readonly 'errors.seo.confirmationRequired': "Confirmation required.";
+  readonly 'errors.activity.invalidCursor': "Invalid Activity cursor.";
+  readonly 'errors.people.notFound': "Person not found.";
+  readonly 'errors.people.emailExists': "A person with this email already exists.";
+  readonly 'errors.people.ownRole': "You cannot change your own role.";
+  readonly 'errors.people.ownAccount': "You cannot remove your own account.";
+  readonly 'errors.people.invalidRole': "Person has an invalid role.";
+  readonly 'errors.people.secureRandom': "Secure random generation is unavailable.";
+  readonly 'errors.people.failed': "User administration failed.";
+  readonly 'errors.content.duplicateDocument': "Duplicate document {documentId} in content bundle.";
+  readonly 'errors.content.plannedMissing': "Planned document is missing from the import.";
+  readonly 'errors.content.unchangedMissing': "Unchanged document is missing from the installation.";
+  readonly 'errors.content.changeMissing': "Planned document has no validated change.";
+  readonly 'errors.internal': "Internal server error.";
+};
+declare const StudioErrorCode: Schema.Literals<("errors.request.invalid" | "errors.request.trashPlan" | "errors.request.workingVector" | "errors.auth.required" | "errors.auth.sameOrigin" | "errors.auth.editorRequired" | "errors.auth.administratorRequired" | "errors.auth.alreadyInitialized" | "errors.auth.invalidSecret" | "errors.auth.secretLength" | "errors.document.notFound" | "errors.document.changed" | "errors.document.homeReplace" | "errors.document.homeMove" | "errors.document.homePlacement" | "errors.document.homeOffline" | "errors.document.homeTrash" | "errors.document.starterUnavailable" | "errors.document.restoreEarlier" | "errors.document.translationLanguage" | "errors.document.translationLocale" | "errors.document.referencedInTrash" | "errors.collection.notConfigured" | "errors.collection.unavailable" | "errors.language.notConfigured" | "errors.route.collection" | "errors.route.pattern" | "errors.route.cycle" | "errors.route.home" | "errors.route.parent" | "errors.route.locale" | "errors.route.collision" | "errors.form.structure" | "errors.form.size" | "errors.form.identity" | "errors.form.answerKeys" | "errors.form.answerKeyReserved" | "errors.form.typeUnavailable" | "errors.form.requiredUnavailable" | "errors.form.minLengthUnavailable" | "errors.form.maxLengthUnavailable" | "errors.form.minUnavailable" | "errors.form.maxUnavailable" | "errors.form.textLimits" | "errors.form.numberLimits" | "errors.form.range" | "errors.form.lengthRange" | "errors.form.options" | "errors.form.selectOptions" | "errors.publication.duplicate" | "errors.publication.revisionMissing" | "errors.publication.alreadyOffline" | "errors.publication.reviewChanged" | "errors.schedule.name" | "errors.schedule.actor" | "errors.schedule.future" | "errors.schedule.planChanged" | "errors.schedule.notPending" | "errors.schedule.runTime" | "errors.schedule.conflict" | "errors.schedule.missingPage" | "errors.schedule.alreadyScheduled" | "errors.revisionPreview.unavailable" | "errors.revisionPreview.expiry" | "errors.revisionPreview.path" | "errors.revisionPreview.language" | "errors.revisionPreview.query" | "errors.media.notFound" | "errors.media.changed" | "errors.media.upload" | "errors.media.uploadConfiguration" | "errors.media.uploadLimit" | "errors.media.sizeExceeded" | "errors.media.sizeMismatch" | "errors.media.typeMismatch" | "errors.media.checksum" | "errors.media.folderInvalid" | "errors.media.folderRequired" | "errors.media.folderExists" | "errors.media.inUse" | "errors.seo.changed" | "errors.seo.confirmationRequired" | "errors.activity.invalidCursor" | "errors.people.notFound" | "errors.people.emailExists" | "errors.people.ownRole" | "errors.people.ownAccount" | "errors.people.invalidRole" | "errors.people.secureRandom" | "errors.people.failed" | "errors.content.duplicateDocument" | "errors.content.plannedMissing" | "errors.content.unchangedMissing" | "errors.content.changeMissing" | "errors.internal")[]>;
+type StudioErrorCode = typeof StudioErrorCode.Type;
+//#endregion
+export { studioErrorMessages as n, StudioErrorCode as t };

package/src/StudioServer.d.ts

@@ -0,0 +1,20 @@
+import "./StudioErrors-kq-E44lQ.js";
+import "./Database-DSsNCGft.js";
+import { Context, Crypto, Effect, Layer, Schema } from "effect";
+import { RequestEvent } from "nuxt/server";
+//#region ../model/src/People.d.ts
+declare const Role: Schema.Literals<readonly ["administrator", "editor", "viewer"]>;
+type Role = typeof Role.Type;
+//#endregion
+//#region ../server/src/Authentication.d.ts
+interface Actor {
+  readonly id: string;
+  readonly name: string;
+  readonly email: string;
+  readonly role: Role;
+}
+//#endregion
+//#region src/StudioServer.d.ts
+/** Authenticate a site-owned Studio endpoint with the CMS session. */
+export declare function requireCmsStudioUser(event: RequestEvent, access?: 'administrator' | 'signed-in'): Promise<Actor>;
+//#endregion

package/src/StudioServer.js

@@ -0,0 +1,34 @@
+import { n as fetchCmsRequest } from "./plugin-DTYuDaQu.js";
+import { o as Role } from "./People-DvNZauWw.js";
+import { Result, Schema } from "effect";
+import { createError, getRequestHeader, getRequestURL } from "nuxt/server";
+//#region src/StudioServer.ts
+const StudioActor = Schema.Struct({
+	id: Schema.NonEmptyString,
+	name: Schema.NonEmptyString,
+	email: Schema.NonEmptyString,
+	role: Role
+});
+/** Authenticate a site-owned Studio endpoint with the CMS session. */
+async function requireCmsStudioUser(event, access = "signed-in") {
+	const url = new URL("/_cms/api/session", getRequestURL(event));
+	const cookie = getRequestHeader(event, "cookie");
+	const request = new Request(url, { headers: cookie ? { cookie } : void 0 });
+	const response = await fetchCmsRequest(request);
+	if (!response.ok) throw createError({
+		statusCode: response.status === 401 ? 401 : 503,
+		statusMessage: "Studio session unavailable."
+	});
+	const decoded = Schema.decodeUnknownResult(StudioActor)(await response.json());
+	if (Result.isFailure(decoded)) throw createError({
+		statusCode: 503,
+		statusMessage: "Invalid Studio session."
+	});
+	if (access === "administrator" && decoded.success.role !== "administrator") throw createError({
+		statusCode: 403,
+		statusMessage: "Administrator access required."
+	});
+	return decoded.success;
+}
+//#endregion
+export { requireCmsStudioUser };

package/src/answers-DcTg0Xv2.js

@@ -0,0 +1,41 @@
+import { u as formAnswerKey } from "./contracts-rprW3ZOB.js";
+import { Predicate } from "effect";
+//#region ../model/src/internal/forms/answers.ts
+function validateFormValues(fields, values) {
+	return Object.fromEntries(fields.flatMap((field) => {
+		const key = formAnswerKey(field);
+		const issue = fieldIssue(field, Object.hasOwn(values, key) ? values[key] : void 0);
+		return issue ? [[key, issue]] : [];
+	}));
+}
+function fieldIssue(field, value) {
+	if (value === void 0 || value === null || value === "" || Predicate.isString(value) && !value.trim()) return field.required ? { code: "required" } : void 0;
+	if (field.type === "checkbox") return !Predicate.isBoolean(value) ? { code: "boolean" } : field.required && !value ? { code: "unchecked" } : void 0;
+	if (field.type === "number") {
+		if (!Predicate.isNumber(value) || !Number.isFinite(value)) return { code: "number" };
+		if (field.min !== void 0 && value < field.min) return {
+			code: "min",
+			limit: field.min
+		};
+		if (field.max !== void 0 && value > field.max) return {
+			code: "max",
+			limit: field.max
+		};
+		return;
+	}
+	if (!Predicate.isString(value)) return { code: "text" };
+	if (field.type === "select" && !field.options.some((option) => option.id === value)) return { code: "option" };
+	if (field.type === "email" && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/u.test(value)) return { code: "email" };
+	if (field.type === "text" || field.type === "email" || field.type === "textarea") {
+		if (field.minLength !== void 0 && value.length < field.minLength) return {
+			code: "minLength",
+			limit: field.minLength
+		};
+		if (field.maxLength !== void 0 && value.length > field.maxLength) return {
+			code: "maxLength",
+			limit: field.maxLength
+		};
+	}
+}
+//#endregion
+export { validateFormValues as t };