@stackbox/cms 0.0.4 → 0.0.5

package/dist/stackbox/context.js

@@ -0,0 +1,165 @@
+function parseCookieHeader(header) {
+    const cookies = {};
+    for (const part of header.split(";")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq === -1)
+            continue;
+        const name = trimmed.slice(0, eq).trim();
+        const value = trimmed.slice(eq + 1).trim();
+        if (name)
+            cookies[name] = decodeURIComponent(value);
+    }
+    return cookies;
+}
+function serializeCookie(name, value, options) {
+    let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+    if (options?.maxAge !== undefined)
+        cookie += `; Max-Age=${options.maxAge}`;
+    if (options?.domain)
+        cookie += `; Domain=${options.domain}`;
+    if (options?.path)
+        cookie += `; Path=${options.path}`;
+    else
+        cookie += "; Path=/";
+    if (options?.expires)
+        cookie += `; Expires=${options.expires.toUTCString()}`;
+    if (options?.httpOnly)
+        cookie += "; HttpOnly";
+    if (options?.secure)
+        cookie += "; Secure";
+    if (options?.sameSite === true)
+        cookie += "; SameSite=Strict";
+    else if (options?.sameSite) {
+        const s = options.sameSite === "strict" ? "Strict" : "Lax";
+        cookie += `; SameSite=${s}`;
+    }
+    return cookie;
+}
+function createCookies(req, responseHeaders, parsed) {
+    return {
+        _req: req,
+        _responseHeaders: responseHeaders,
+        _parsedCookies: parsed,
+        _encrypt: undefined,
+        _decrypt: undefined,
+        get(name) {
+            return parsed[name];
+        },
+        set(name, value, options) {
+            if (!responseHeaders)
+                return;
+            parsed[name] = value;
+            responseHeaders.append("Set-Cookie", serializeCookie(name, value, options));
+        },
+        delete(name) {
+            if (!responseHeaders)
+                return;
+            delete parsed[name];
+            responseHeaders.append("Set-Cookie", serializeCookie(name, "", { maxAge: 0, path: "/" }));
+        },
+    };
+}
+function buildResponse(res, body, init = {}) {
+    const headers = new Headers(init.headers);
+    res.headers.forEach((value, key) => {
+        if (!headers.has(key))
+            headers.set(key, value);
+    });
+    for (const value of res.headers.getSetCookie?.() ?? []) {
+        headers.append("Set-Cookie", value);
+    }
+    if (body !== null && !headers.has("Content-Type") && typeof body === "string") {
+        headers.set("Content-Type", "text/plain; charset=utf-8");
+    }
+    const status = init.status ?? res.status ?? 200;
+    return new globalThis.Response(body, { ...init, status, headers });
+}
+function createStackboxResponse(reqCookies) {
+    const headers = new Headers();
+    const resCookies = createCookies(reqCookies._req, headers, { ...reqCookies._parsedCookies });
+    const res = {
+        cookies: resCookies,
+        headers,
+        status: undefined,
+        async html(html, options = {}) {
+            res.status = options.status ?? 200;
+            const outHeaders = new Headers(options.headers);
+            if (!outHeaders.has("Content-Type")) {
+                outHeaders.set("Content-Type", "text/html; charset=utf-8");
+            }
+            return buildResponse(res, html, { ...options, headers: outHeaders });
+        },
+        async json(json, options = {}) {
+            res.status = options.status ?? 200;
+            const outHeaders = new Headers(options.headers);
+            if (!outHeaders.has("Content-Type")) {
+                outHeaders.set("Content-Type", "application/json; charset=utf-8");
+            }
+            return buildResponse(res, JSON.stringify(json), {
+                ...options,
+                headers: outHeaders,
+            });
+        },
+        async text(text, options = {}) {
+            res.status = options.status ?? 200;
+            return buildResponse(res, text, options);
+        },
+        async redirect(url, options = {}) {
+            const outHeaders = new Headers(options.headers);
+            outHeaders.set("Location", url);
+            res.status = options.status ?? 302;
+            return buildResponse(res, null, { ...options, headers: outHeaders });
+        },
+        async error(error, options = {}) {
+            res.status = options.status ?? 500;
+            return buildResponse(res, error.message, options);
+        },
+        async notFound(options = {}) {
+            res.status = options.status ?? 400 + 4;
+            return buildResponse(res, "Not Found", { ...options, status: res.status });
+        },
+        async merge(response) {
+            const merged = new Headers(response.headers);
+            res.headers.forEach((value, key) => {
+                if (!merged.has(key))
+                    merged.set(key, value);
+            });
+            for (const value of res.headers.getSetCookie?.() ?? []) {
+                merged.append("Set-Cookie", value);
+            }
+            return new globalThis.Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: merged,
+            });
+        },
+    };
+    return res;
+}
+export function createContext(raw, env = {}) {
+    const url = new URL(raw.url);
+    const parsed = parseCookieHeader(raw.headers.get("Cookie") ?? "");
+    const reqHeaders = new Headers(raw.headers);
+    const reqCookies = createCookies(raw, undefined, parsed);
+    const req = {
+        url,
+        raw,
+        method: raw.method.toUpperCase(),
+        headers: reqHeaders,
+        query: url.searchParams,
+        cookies: reqCookies,
+        text: () => raw.text(),
+        json: () => raw.json(),
+        formData: () => raw.formData(),
+        urlencoded: async () => {
+            const text = await raw.text();
+            return new URLSearchParams(text);
+        },
+    };
+    const res = createStackboxResponse(reqCookies);
+    return { env, req, res };
+}
+//# sourceMappingURL=context.js.map

package/dist/stackbox/context.js.map

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

package/dist/templates.d.ts

@@ -0,0 +1,63 @@
+import { type HSHtml } from "@hyperspan/html";
+import type { z } from "zod";
+import { type SiteConfig } from "./site.js";
+import type { PageRenderView } from "./pages.js";
+import { type TemplateSlotsFrom } from "./slot-handle.js";
+export type SlotOptions = {
+    required?: boolean;
+    primary?: true;
+    schema?: z.ZodTypeAny;
+};
+export type SlotDefinition = {
+    name: string;
+    options?: SlotOptions;
+};
+export type SlotMeta = {
+    isDefault: boolean;
+    required: boolean;
+    schema?: z.ZodTypeAny;
+};
+export type TemplateRenderContext<S extends readonly SlotDefinition[] = readonly SlotDefinition[]> = {
+    head?: HSHtml;
+    siteConfig: SiteConfig;
+    page: PageRenderView;
+    slots: TemplateSlotsFrom<S>;
+};
+/** Widened render signature stored on descriptors at runtime. */
+export type TemplateRenderFn = (ctx: {
+    head?: HSHtml;
+    siteConfig: SiteConfig;
+    page: PageRenderView;
+    slots: Record<string, import("./slot-handle.js").Slot>;
+}) => HSHtml;
+export type TemplateDescriptor<Slots extends string = string, RequiredSlots extends Slots = never, Definitions extends readonly SlotDefinition[] = readonly SlotDefinition[]> = {
+    readonly __kind: "template";
+    siteConfig: SiteConfig;
+    formatPageTitle: (title: string) => string;
+    render: TemplateRenderFn;
+    slots: Record<Slots, SlotMeta>;
+    requiredSlots: readonly RequiredSlots[];
+    readonly __definitions?: Definitions;
+};
+export type SlotNamesFrom<S extends readonly SlotDefinition[]> = S[number]["name"];
+export type RequiredSlotNamesFrom<S extends readonly SlotDefinition[]> = Extract<S[number], {
+    options: {
+        required: true;
+    };
+} | {
+    options: {
+        primary: true;
+    };
+}>["name"];
+export declare function isTemplate(value: unknown): value is TemplateDescriptor;
+export declare class TemplateBuildError extends Error {
+    constructor(message: string);
+}
+export declare function createTemplate<const S extends readonly SlotDefinition[]>(def: {
+    siteConfig: SiteConfig;
+    slots: S;
+    title?: (pageTitle: string, siteConfig: SiteConfig) => string;
+    render: (ctx: TemplateRenderContext<S>) => HSHtml;
+}): TemplateDescriptor<SlotNamesFrom<S>, RequiredSlotNamesFrom<S>, S>;
+export type { Slot, TemplateSlotsFrom } from "./slot-handle.js";
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,SAAS,cAAc,EAAE,GAAG,SAAS,cAAc,EAAE,IAC7D;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,IAAI,CAAC,CAAC;CACxD,KAAK,MAAM,CAAC;AAEb,MAAM,MAAM,kBAAkB,CAC5B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,aAAa,SAAS,KAAK,GAAG,KAAK,EACnC,WAAW,SAAS,SAAS,cAAc,EAAE,GAAG,SAAS,cAAc,EAAE,IACvE;IACF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/B,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,IAC3D,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpB,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,IACnE,OAAO,CACL,CAAC,CAAC,MAAM,CAAC,EACT;IAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,CACjE,CAAC,MAAM,CAAC,CAAC;AAEZ,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAYtE;AAiBD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAgED,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,EACtE,GAAG,EAAE;IACH,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC;IAC9D,MAAM,EAAE,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;CACnD,GACA,kBAAkB,CACnB,aAAa,CAAC,CAAC,CAAC,EAChB,qBAAqB,CAAC,CAAC,CAAC,EACxB,CAAC,CACF,CAmDA;AAED,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/templates.js

@@ -0,0 +1,106 @@
+import { render } from "@hyperspan/html";
+import { isSiteConfig } from "./site.js";
+import { buildStubSlots, slotSentinel, } from "./slot-handle.js";
+export function isTemplate(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__kind === "template" &&
+        isSiteConfig(value.siteConfig) &&
+        typeof value.formatPageTitle === "function" &&
+        typeof value.render === "function" &&
+        typeof value.slots === "object" &&
+        value.slots !== null &&
+        Array.isArray(value.requiredSlots));
+}
+function defaultFormatPageTitle(pageTitle, siteConfig) {
+    const suffix = siteConfig.config.titleSuffix;
+    return typeof suffix === "string" ? pageTitle + suffix : pageTitle;
+}
+export class TemplateBuildError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TemplateBuildError";
+    }
+}
+function validateSlotDefinitions(definitions) {
+    if (definitions.length === 0) {
+        throw new TemplateBuildError("template must define at least one slot");
+    }
+    const entries = [];
+    const seen = new Set();
+    let primaryCount = 0;
+    for (const def of definitions) {
+        if (!def.name || def.name.length === 0) {
+            throw new TemplateBuildError("slot name must be non-empty");
+        }
+        if (seen.has(def.name)) {
+            throw new TemplateBuildError(`duplicate slot name "${def.name}"`);
+        }
+        seen.add(def.name);
+        const opts = def.options ?? {};
+        const isDefault = opts.primary === true;
+        if (isDefault) {
+            primaryCount++;
+        }
+        entries.push({
+            name: def.name,
+            isDefault,
+            required: opts.required === true || opts.primary === true,
+            schema: opts.schema,
+        });
+    }
+    if (primaryCount !== 1) {
+        throw new TemplateBuildError(`exactly one slot must have options.primary: true; found ${primaryCount}`);
+    }
+    return entries;
+}
+function validateRenderOutput(html, slotNames) {
+    for (const name of slotNames) {
+        if (!html.includes(slotSentinel(name))) {
+            throw new TemplateBuildError(`slot "${name}" must be rendered via slots.${name}.render()`);
+        }
+    }
+}
+const stubPage = {
+    __kind: "page",
+    path: "/",
+    title: "Template validation",
+};
+export function createTemplate(def) {
+    if (!isSiteConfig(def.siteConfig)) {
+        throw new TemplateBuildError("createTemplate({ siteConfig }): siteConfig must be from createSiteConfig()");
+    }
+    const formatPageTitle = def.title
+        ? (pageTitle) => def.title(pageTitle, def.siteConfig)
+        : (pageTitle) => defaultFormatPageTitle(pageTitle, def.siteConfig);
+    const entries = validateSlotDefinitions(def.slots);
+    const stubSlots = buildStubSlots(def.slots);
+    const validationHtml = render(def.render({
+        siteConfig: def.siteConfig,
+        page: stubPage,
+        slots: stubSlots,
+    }));
+    validateRenderOutput(validationHtml, entries.map((entry) => entry.name));
+    const slots = {};
+    const requiredSlots = [];
+    for (const entry of entries) {
+        slots[entry.name] = {
+            isDefault: entry.isDefault,
+            required: entry.required,
+            schema: entry.schema,
+        };
+        if (entry.required) {
+            requiredSlots.push(entry.name);
+        }
+    }
+    return {
+        __kind: "template",
+        siteConfig: def.siteConfig,
+        formatPageTitle,
+        render: def.render,
+        slots,
+        requiredSlots,
+        __definitions: def.slots,
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackbox/cms",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Stackbox CMS engine",
   "type": "module",
   "license": "BSD-3-Clause",
@@ -12,6 +12,11 @@
     "type": "git",
     "url": "git+https://github.com/stackboxcms/cms.git"
   },
+  "files": [
+    "dist",
+    "AGENTS.md",
+    "src/plugins"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -34,7 +39,7 @@
     "build": "tsc -p tsconfig.json && node scripts/copy-plugin-assets.mjs",
     "test": "npm run build && node --import tsx --test test/*.test.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "prepublishOnly": "npm run build"
+    "prepack": "npm run build"
   },
   "dependencies": {
     "@hyperspan/html": "^1.0.3",

package/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(node -e \"import\\('@hyperspan/html'\\).then\\(m => console.log\\('html export:', typeof m.html\\)\\)\")",
-      "Bash(npm run *)"
-    ]
-  }
-}

package/scripts/copy-plugin-assets.mjs

@@ -1,30 +0,0 @@
-import { cpSync, existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-const pluginsDir = join(root, "src/plugins");
-
-if (!existsSync(pluginsDir)) {
-  process.exit(0);
-}
-
-for (const name of readdirSync(pluginsDir)) {
-  const pluginDir = join(pluginsDir, name);
-  if (!statSync(pluginDir).isDirectory()) {
-    continue;
-  }
-
-  const publicAssets = join(pluginDir, "public_assets");
-  if (!existsSync(publicAssets)) {
-    continue;
-  }
-
-  const publicDest = join(root, "dist/public/_sb/plugins", name);
-  mkdirSync(dirname(publicDest), { recursive: true });
-  cpSync(publicAssets, publicDest, { recursive: true });
-
-  const importDest = join(root, "dist/plugins", name, "public_assets");
-  mkdirSync(dirname(importDest), { recursive: true });
-  cpSync(publicAssets, importDest, { recursive: true });
-}

package/src/blocks.ts

@@ -1,58 +0,0 @@
-import type { RenderContext } from "./pages.js";
-import type { HSHtml } from "@hyperspan/html";
-
-export type BlockRenderResult = HSHtml | Promise<HSHtml>;
-
-export type Block = {
-  readonly __kind: "block";
-  readonly name: string;
-  render(ctx: RenderContext): BlockRenderResult;
-};
-
-type BlockDef<TOptions = undefined> = {
-  name: string;
-  render(options: TOptions, ctx?: RenderContext): BlockRenderResult;
-};
-
-export type BlockOptionsOf<F> = F extends (options?: infer O) => unknown
-  ? [O] extends [undefined]
-    ? undefined
-    : O
-  : never;
-
-export type BlockFactory<TOptions = undefined> = (
-  options?: TOptions,
-) => Block;
-
-function validateBlockName(name: string): void {
-  if (!name || name.length === 0) {
-    throw new Error("createBlock(def): name is required");
-  }
-}
-
-export function createBlock<TOptions = undefined>(
-  def: BlockDef<TOptions>,
-): BlockFactory<TOptions> {
-  validateBlockName(def.name);
-
-  if (typeof def.render !== "function") {
-    throw new Error("createBlock(def): render is required");
-  }
-
-  return ((options?: TOptions) => ({
-    __kind: "block" as const,
-    name: def.name,
-    render: (ctx: RenderContext) => def.render(options as TOptions, ctx),
-  })) as BlockFactory<TOptions>;
-}
-
-export function isBlock(value: unknown): value is Block {
-  return (
-    typeof value === "object" &&
-    value !== null &&
-    (value as Block).__kind === "block" &&
-    typeof (value as Block).name === "string" &&
-    (value as Block).name.length > 0 &&
-    typeof (value as Block).render === "function"
-  );
-}

package/src/index.ts

@@ -1,67 +0,0 @@
-export { html } from "@hyperspan/html";
-export {
-  createBlock,
-  isBlock,
-  type Block,
-  type BlockFactory,
-  type BlockOptionsOf,
-  type BlockRenderResult,
-} from "./blocks.js";
-export {
-  createPage,
-  isPage,
-  PageValidationError,
-  toPageRenderView,
-  validateSlotContentItem,
-  type Page,
-  type PageMeta,
-  type PageRenderView,
-  type RenderContext,
-  type SitePage,
-} from "./pages.js";
-export { renderStandardHead } from "./render-head.js";
-export { renderPage, RenderError } from "./render-page.js";
-export { matchPagePath, normalizePathname } from "./routing.js";
-export {
-  createSite,
-  createSiteConfig,
-  isSite,
-  isSiteConfig,
-  SiteError,
-  type Site,
-  type SiteConfig,
-} from "./site.js";
-export { createContext, Stackbox } from "./stackbox/context.js";
-export {
-  anySlotContentSchema,
-  blockSlotContentSchema,
-  slotHasContent,
-  SlotContentValidationError,
-  stringSlotContentSchema,
-  type DefaultSlotContent,
-  type PageSlotsInput,
-  type SlotContentFromDefinition,
-} from "./slot-content.js";
-export {
-  buildPageSlots,
-  buildStubSlots,
-  renderSlotContent,
-  slotSentinel,
-  SLOT_SENTINEL_PREFIX,
-  type Slot,
-  type SlotRenderValue,
-  type TemplateSlotsFrom,
-} from "./slot-handle.js";
-export {
-  createTemplate,
-  isTemplate,
-  TemplateBuildError,
-  type RequiredSlotNamesFrom,
-  type SlotDefinition,
-  type SlotMeta,
-  type SlotNamesFrom,
-  type SlotOptions,
-  type TemplateDescriptor,
-  type TemplateRenderContext,
-  type TemplateRenderFn,
-} from "./templates.js";