@assemora/pages 0.1.0

package/dist/module.js

@@ -0,0 +1,80 @@
+/**
+ * The `.blocks()` facet and the `pages()` module (SPEC.md §13, §114).
+ */
+import { defineModuleFacet, module, registerRestorer } from '@assemora/core';
+import { UNSPECIFIED_LOCALE } from '@assemora/data';
+import { emptyTree } from '@assemora/schema';
+import { describeBlock, registerBlock } from './block.js';
+import { pageCommands } from './commands.js';
+import { Page, pageModels } from './models.js';
+import { pageQueries } from './queries.js';
+let defined = false;
+export const defineBlockFacet = () => {
+    if (defined)
+        return;
+    defineModuleFacet('blocks', (internals, args) => {
+        internals.addRegistration((context) => {
+            for (const candidate of args) {
+                const declared = candidate;
+                if (declared?.node !== 'block')
+                    continue;
+                registerBlock(declared);
+                context.registry.register('blocks', describeBlock(declared, internals.name));
+            }
+        });
+    });
+    defined = true;
+};
+defineBlockFacet();
+export const pages = (options = {}) => module('pages')
+    .models(...pageModels)
+    .commands(...pageCommands)
+    .queries(...pageQueries)
+    .blocks(...(options.blocks ?? []))
+    .boot(() => {
+    // How a page goes back to an earlier state. `@assemora/revisions` calls this
+    // and never learns what a page is (SPEC.md §65).
+    registerRestorer('pages', async (entityId, state) => {
+        const existing = await Page.find(entityId);
+        const replaced = existing === null ? null : existing.toJSON();
+        // `null` means the page did not exist then. Undoing a creation is an ordinary
+        // restore, and so is putting back something that was deleted (SPEC.md §65).
+        if (state === null || state === undefined) {
+            if (existing !== null)
+                await existing.delete();
+            return { replaced, version: 0 };
+        }
+        const snapshot = state;
+        if (existing === null) {
+            const recreated = await Page.create({
+                id: entityId,
+                slug: String(snapshot.slug ?? entityId),
+                title: String(snapshot.title ?? 'Restored page'),
+                status: (snapshot.status ?? 'draft'),
+                draftTree: (snapshot.draftTree ?? emptyTree()),
+                publishedTree: (snapshot.publishedTree ?? null),
+                meta: (snapshot.meta ?? {}),
+                version: 1,
+                // From the revision, not from the operation restoring it: a page put back is
+                // the page it was, in the language it was written in (SPEC.md §131).
+                locale: String(snapshot.locale ?? UNSPECIFIED_LOCALE),
+                translationOf: (snapshot.translationOf ?? null),
+                publishedAt: null,
+            });
+            return { replaced, version: recreated.version, tree: recreated.draftTree };
+        }
+        await existing.update({
+            title: String(snapshot.title ?? existing.title),
+            slug: String(snapshot.slug ?? existing.slug),
+            status: (snapshot.status ?? existing.status),
+            draftTree: (snapshot.draftTree ?? existing.draftTree),
+            publishedTree: (snapshot.publishedTree ?? existing.publishedTree),
+            meta: (snapshot.meta ?? existing.meta),
+            version: existing.version + 1,
+        });
+        // The caller needs both: its next command carries `expectedVersion`, and an
+        // editor has to draw what the undo produced without reading the page again.
+        return { replaced, version: existing.version, tree: existing.draftTree };
+    });
+});
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"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"}

package/dist/queries.d.ts

@@ -0,0 +1,162 @@
+export type PageMode = 'draft' | 'published';
+export declare const ListPages: import("@assemora/core").QueryDefinition<{
+    status: import("@assemora/schema").OptionalSchema<"archived" | "draft" | "published">;
+    search: import("@assemora/schema").OptionalSchema<string>;
+    page: import("@assemora/schema").OptionalSchema<number>;
+    perPage: import("@assemora/schema").OptionalSchema<number>;
+}, {
+    readonly data: readonly {
+        readonly id: string;
+        readonly locale: string;
+        readonly publishedAt: Date | null;
+        readonly slug: string;
+        readonly status: "archived" | "draft" | "published";
+        readonly title: string;
+        readonly translationOf: string | null;
+        readonly updatedAt: Date;
+        readonly version: number;
+    }[];
+    readonly lastPage: number;
+    readonly page: number;
+    readonly perPage: number;
+    readonly total: number;
+}>;
+export declare const GetPage: import("@assemora/core").QueryDefinition<{
+    id: import("@assemora/schema").OptionalSchema<string>;
+    slug: import("@assemora/schema").OptionalSchema<string>;
+    mode: import("@assemora/schema").OptionalSchema<"draft" | "published">;
+}, {
+    readonly hasUnpublishedChanges: boolean;
+    readonly id: string;
+    readonly locale: string;
+    readonly meta: {
+        readonly title?: string;
+        readonly description?: string;
+        readonly image?: string;
+        readonly noIndex?: boolean;
+    };
+    readonly mode: "draft" | "published";
+    readonly publishedAt: Date | null;
+    readonly slug: string;
+    readonly status: "archived" | "draft" | "published";
+    readonly title: string;
+    readonly translationOf: string | null;
+    readonly tree: {
+        readonly blocks: readonly {
+            readonly id: string;
+            readonly type: string;
+            readonly version: number;
+            readonly props: {
+                readonly [x: string]: unknown;
+            };
+            readonly children: readonly /*elided*/ any[];
+            readonly hidden?: boolean;
+            readonly design?: {
+                readonly spacingTop?: import("@assemora/schema").SpacingScale;
+                readonly spacingBottom?: import("@assemora/schema").SpacingScale;
+                readonly width?: import("@assemora/schema").BlockWidth;
+                readonly align?: import("@assemora/schema").BlockAlignment;
+                readonly background?: string;
+                readonly backgroundImage?: string;
+                readonly container?: import("@assemora/schema").ContainerWidth;
+                readonly hiddenOn?: readonly ("desktop" | "mobile" | "tablet")[];
+            };
+        }[];
+    };
+    readonly updatedAt: Date;
+    readonly updatedBy: string | null;
+    readonly version: number;
+}>;
+export declare const ListPageTranslations: import("@assemora/core").QueryDefinition<{
+    id: import("@assemora/schema").StringSchema;
+}, {
+    readonly translations: readonly {
+        readonly id: string;
+        readonly isOriginal: boolean;
+        readonly locale: string;
+        readonly slug: string;
+        readonly stale: boolean | null;
+        readonly status: "archived" | "draft" | "published";
+        readonly updatedAt: Date;
+    }[];
+}>;
+export declare const pageQueries: readonly [import("@assemora/core").QueryDefinition<{
+    status: import("@assemora/schema").OptionalSchema<"archived" | "draft" | "published">;
+    search: import("@assemora/schema").OptionalSchema<string>;
+    page: import("@assemora/schema").OptionalSchema<number>;
+    perPage: import("@assemora/schema").OptionalSchema<number>;
+}, {
+    readonly data: readonly {
+        readonly id: string;
+        readonly locale: string;
+        readonly publishedAt: Date | null;
+        readonly slug: string;
+        readonly status: "archived" | "draft" | "published";
+        readonly title: string;
+        readonly translationOf: string | null;
+        readonly updatedAt: Date;
+        readonly version: number;
+    }[];
+    readonly lastPage: number;
+    readonly page: number;
+    readonly perPage: number;
+    readonly total: number;
+}>, import("@assemora/core").QueryDefinition<{
+    id: import("@assemora/schema").OptionalSchema<string>;
+    slug: import("@assemora/schema").OptionalSchema<string>;
+    mode: import("@assemora/schema").OptionalSchema<"draft" | "published">;
+}, {
+    readonly hasUnpublishedChanges: boolean;
+    readonly id: string;
+    readonly locale: string;
+    readonly meta: {
+        readonly title?: string;
+        readonly description?: string;
+        readonly image?: string;
+        readonly noIndex?: boolean;
+    };
+    readonly mode: "draft" | "published";
+    readonly publishedAt: Date | null;
+    readonly slug: string;
+    readonly status: "archived" | "draft" | "published";
+    readonly title: string;
+    readonly translationOf: string | null;
+    readonly tree: {
+        readonly blocks: readonly {
+            readonly id: string;
+            readonly type: string;
+            readonly version: number;
+            readonly props: {
+                readonly [x: string]: unknown;
+            };
+            readonly children: readonly /*elided*/ any[];
+            readonly hidden?: boolean;
+            readonly design?: {
+                readonly spacingTop?: import("@assemora/schema").SpacingScale;
+                readonly spacingBottom?: import("@assemora/schema").SpacingScale;
+                readonly width?: import("@assemora/schema").BlockWidth;
+                readonly align?: import("@assemora/schema").BlockAlignment;
+                readonly background?: string;
+                readonly backgroundImage?: string;
+                readonly container?: import("@assemora/schema").ContainerWidth;
+                readonly hiddenOn?: readonly ("desktop" | "mobile" | "tablet")[];
+            };
+        }[];
+    };
+    readonly updatedAt: Date;
+    readonly updatedBy: string | null;
+    readonly version: number;
+}>, import("@assemora/core").QueryDefinition<{
+    id: import("@assemora/schema").StringSchema;
+}, {
+    readonly translations: readonly {
+        readonly id: string;
+        readonly isOriginal: boolean;
+        readonly locale: string;
+        readonly slug: string;
+        readonly stale: boolean | null;
+        readonly status: "archived" | "draft" | "published";
+        readonly updatedAt: Date;
+    }[];
+}>];
+//# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAA;AAqC5C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;EAkDpB,CAAA;AAEF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DlB,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAoD/B,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAsD,CAAA"}

package/dist/queries.js

@@ -0,0 +1,195 @@
+/**
+ * Reading pages (SPEC.md §15, §53).
+ *
+ * A page is read through the Query Bus, so the same validation, authorization and
+ * naming apply as to everything else and no layer above needs to depend on this one
+ * (ADR-0014). A browser reaches these through `server.mountQueries()`.
+ */
+import { NotFoundError, query } from '@assemora/core';
+import { array, blockTree, boolean, emptyTree, enumOf, json, number, object, string, timestamp, uuid, } from '@assemora/schema';
+import { Page } from './models.js';
+/**
+ * What a reader gets: one tree, already chosen.
+ *
+ * Handing back both trees would make every caller decide which one it meant, and a
+ * visitor's renderer would be one mistake away from showing an unpublished draft.
+ */
+const project = (page, mode) => ({
+    id: page.id,
+    slug: page.slug,
+    title: page.title,
+    status: page.status,
+    /**
+     * Which language this page is actually written in, and which page it is one language
+     * of (SPEC.md §131).
+     *
+     * Beside the id for the reason a resource read carries them: a reader that cannot tell
+     * a translation from a fallback has been handed the wrong answer without being told,
+     * and a link to another language needs the entry rather than the row.
+     */
+    locale: page.locale,
+    translationOf: page.translationOf,
+    mode,
+    tree: (mode === 'draft' ? page.draftTree : (page.publishedTree ?? emptyTree())),
+    meta: page.meta,
+    /** Every mutation echoes this back as `expectedVersion` (SPEC.md §66). */
+    version: page.version,
+    /** True when the draft has moved on from what visitors see. */
+    hasUnpublishedChanges: page.publishedTree === null ||
+        JSON.stringify(page.draftTree) !== JSON.stringify(page.publishedTree),
+    publishedAt: page.publishedAt,
+    updatedAt: page.updatedAt,
+    updatedBy: page.updatedBy,
+});
+export const ListPages = query('pages.list', {
+    description: 'A page of pages, most recently changed first',
+    input: {
+        status: enumOf('draft', 'published', 'archived').optional(),
+        search: string().optional(),
+        page: number().integer().optional(),
+        perPage: number().integer().optional(),
+    },
+    output: {
+        data: array(object({
+            id: uuid(),
+            slug: string(),
+            title: string(),
+            status: enumOf('draft', 'published', 'archived'),
+            locale: string(),
+            translationOf: uuid().nullable(),
+            version: number(),
+            publishedAt: timestamp().nullable(),
+            updatedAt: timestamp(),
+        })),
+        total: number(),
+        page: number(),
+        perPage: number(),
+        lastPage: number(),
+    },
+    handle: async ({ status, search, page, perPage }) => {
+        let found = Page.orderBy('updatedAt', 'desc');
+        if (status !== undefined)
+            found = found.where('status', status);
+        if (search !== undefined && search !== '')
+            found = found.whereLike('title', `%${search}%`);
+        const listed = await found.paginate(page ?? 1, Math.min(perPage ?? 20, 100));
+        return {
+            ...listed,
+            data: listed.data.map((item) => ({
+                id: item.id,
+                slug: item.slug,
+                title: item.title,
+                status: item.status,
+                locale: item.locale,
+                translationOf: item.translationOf,
+                version: item.version,
+                publishedAt: item.publishedAt,
+                updatedAt: item.updatedAt,
+            })),
+        };
+    },
+});
+export const GetPage = query('pages.get', {
+    description: 'One page, with the draft tree or the published one',
+    input: {
+        id: uuid().optional(),
+        slug: string().optional(),
+        mode: enumOf('draft', 'published').optional(),
+    },
+    output: {
+        id: uuid(),
+        slug: string(),
+        title: string(),
+        status: enumOf('draft', 'published', 'archived'),
+        locale: string(),
+        translationOf: uuid().nullable(),
+        mode: enumOf('draft', 'published'),
+        tree: blockTree(),
+        meta: json(),
+        version: number(),
+        hasUnpublishedChanges: boolean(),
+        publishedAt: timestamp().nullable(),
+        updatedAt: timestamp(),
+        updatedBy: uuid().nullable(),
+    },
+    handle: async ({ id, slug, mode }) => {
+        const found = id !== undefined
+            ? await Page.find(id)
+            : slug === undefined
+                ? null
+                : await Page.where('slug', slug).first();
+        if (found === null)
+            throw new NotFoundError('page', id ?? slug ?? '');
+        /**
+         * A translation nobody has published yet is not what a visitor gets (SPEC.md §131).
+         *
+         * `pages.translate` copies the original's blocks so a translator has something to
+         * work on, and leaves the copy unpublished — so between making it and finishing it,
+         * this row exists, has no published tree, and would answer a visitor with an empty
+         * page. Worse than the fallback it replaced: before the translation existed, the
+         * reader got the original.
+         *
+         * So a request for the published page steps back to the original, which is what the
+         * site showed a minute earlier and what it should go on showing until somebody says
+         * the translation is ready.
+         */
+        if ((mode ?? 'published') === 'published' && found.publishedTree === null) {
+            const original = found.translationOf === null ? null : await Page.find(found.translationOf);
+            if (original !== null && original.publishedTree !== null) {
+                return project(original, 'published');
+            }
+        }
+        // Published by default: a visitor's renderer must never show a draft because a
+        // parameter was forgotten.
+        return project(found, mode ?? 'published');
+    },
+});
+export const ListPageTranslations = query('pages.translations', {
+    description: 'Which languages a page is written in, and which of them are out of date',
+    input: { id: uuid() },
+    output: {
+        translations: array(object({
+            id: uuid(),
+            locale: string(),
+            slug: string(),
+            status: enumOf('draft', 'published', 'archived'),
+            isOriginal: boolean(),
+            updatedAt: timestamp(),
+            stale: boolean().nullable(),
+        })),
+    },
+    handle: async ({ id }, context) => {
+        const named = await Page.find(id);
+        if (named === null)
+            throw new NotFoundError('page', id);
+        // The page itself decides who may be told about its other languages, the way
+        // `revisions.list` asks about the entity it is the history of (ADR-0015).
+        await context.authorize('pages', 'read', named.toJSON());
+        const entry = named.translationOf ?? named.id;
+        const every = await Page.allLocales().get();
+        const rows = every.filter((one) => (one.translationOf ?? one.id) === entry);
+        const original = rows.find((one) => one.translationOf === null);
+        return {
+            translations: rows.map((one) => ({
+                id: one.id,
+                locale: one.locale,
+                slug: one.slug,
+                status: one.status,
+                isOriginal: one.translationOf === null,
+                updatedAt: one.updatedAt,
+                /**
+                 * Written before the original last changed.
+                 *
+                 * A page stamps `updatedAt` on every write, so unlike a resource this is always
+                 * answerable — and it is the question a translator's screen is made of: which of
+                 * these has the original moved on from.
+                 */
+                stale: one.translationOf === null || original === undefined
+                    ? null
+                    : new Date(one.updatedAt).getTime() < new Date(original.updatedAt).getTime(),
+            })),
+        };
+    },
+});
+export const pageQueries = [ListPages, GetPage, ListPageTranslations];
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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"}

package/dist/tree.d.ts

@@ -0,0 +1,52 @@
+import { type BlockDesignPatch, type BlockTree, type Issue } from '@assemora/schema';
+export type Placement = {
+    /** The block to nest under. Omitted means the top level. */
+    readonly parentId?: string;
+    /** Where among the siblings. Appended when omitted. */
+    readonly index?: number;
+};
+export type AddBlock = Placement & {
+    readonly type: string;
+    readonly props?: Readonly<Record<string, unknown>>;
+};
+export declare const addBlock: (tree: BlockTree, request: AddBlock) => {
+    tree: BlockTree;
+    id: string;
+};
+export declare const updateBlockProps: (tree: BlockTree, id: string, props: Readonly<Record<string, unknown>>) => BlockTree;
+/**
+ * Sets the universal design controls of SPEC.md §61.
+ *
+ * They are merged, not replaced: a properties panel sends the one control that
+ * changed, not the whole set. `null` for a control clears it, because "no spacing"
+ * and "the theme decides" are different answers.
+ */
+export declare const setBlockDesign: (tree: BlockTree, id: string, design: BlockDesignPatch) => BlockTree;
+export declare const setBlockHidden: (tree: BlockTree, id: string, hidden: boolean) => BlockTree;
+export declare const removeBlock: (tree: BlockTree, id: string) => BlockTree;
+export declare const moveBlock: (tree: BlockTree, id: string, placement: Placement) => BlockTree;
+export declare const duplicateBlock: (tree: BlockTree, id: string) => {
+    tree: BlockTree;
+    id: string;
+};
+/**
+ * Every block that is not yet fit to be seen (SPEC.md §55, §60).
+ *
+ * A draft may hold an unfinished block; a published page may not. This is what
+ * publishing checks, and it names the block so an editor can go and fix it.
+ */
+export declare const unfinishedBlocks: (tree: BlockTree) => Issue[];
+/** The id of the block that holds this one, or `null` at the top level. */
+export declare const parentOf: (tree: BlockTree, id: string) => string | null;
+/**
+ * Where a block sits: whose child it is, and where among that parent's children.
+ *
+ * The two travel together. A placement that carries the parent and forgets the index
+ * is not "beside" anything — it is the bottom of the list, which is the one place an
+ * editor never means.
+ */
+export declare const positionOf: (tree: BlockTree, id: string) => {
+    readonly parentId: string | null;
+    readonly index: number;
+};
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAGd,KAAK,KAAK,EACX,MAAM,kBAAkB,CAAA;AAIzB,MAAM,MAAM,SAAS,GAAG;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAiFD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACnD,CAAA;AAED,eAAO,MAAM,QAAQ,SAAU,SAAS,WAAW,QAAQ,KAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAkB1F,CAAA;AAED,eAAO,MAAM,gBAAgB,SACrB,SAAS,MACX,MAAM,SACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACvC,SAYF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,SACnB,SAAS,MACX,MAAM,UACF,gBAAgB,KACvB,SAoBF,CAAA;AAED,eAAO,MAAM,cAAc,SAAU,SAAS,MAAM,MAAM,UAAU,OAAO,KAAG,SAM7E,CAAA;AAED,eAAO,MAAM,WAAW,SAAU,SAAS,MAAM,MAAM,KAAG,SAIzD,CAAA;AAED,eAAO,MAAM,SAAS,SAAU,SAAS,MAAM,MAAM,aAAa,SAAS,KAAG,SAU7E,CAAA;AASD,eAAO,MAAM,cAAc,SAAU,SAAS,MAAM,MAAM,KAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAoBzF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,SAAU,SAAS,KAAG,KAAK,EA0BvD,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,SAAU,SAAS,MAAM,MAAM,KAAG,MAAM,GAAG,IAiB/D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,SACf,SAAS,MACX,MAAM,KACT;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAK5D,CAAA"}