hubspot-cms-sync 0.1.0 → 0.3.0

package/examples/minimal-site/content/blog/container.json

@@ -0,0 +1,6 @@
+{
+  "slug": "blog",
+  "name": "Example Blog",
+  "itemTemplatePath": "example-theme/templates/blog-post.html",
+  "listingTemplatePath": "example-theme/templates/blog.html"
+}

package/examples/minimal-site/content/blog/posts/blog__hello-world.json

@@ -0,0 +1,13 @@
+{
+  "slug": "blog/hello-world",
+  "blogSlug": "blog",
+  "name": "Hello World",
+  "htmlTitle": "Hello World",
+  "publishDate": "2026-01-01T12:00:00.000Z",
+  "postBody": "<p>Hello from git.</p><img src=\"@asset:hero.svg\" alt=\"Example\">",
+  "postSummary": "<p>A minimal post.</p>",
+  "authorSlug": null,
+  "authorName": null,
+  "tagSlugs": [],
+  "tagNames": []
+}

package/examples/minimal-site/content/forms/contact.json

@@ -0,0 +1,18 @@
+{
+  "key": "contact",
+  "name": "Website: Contact (general)",
+  "fields": [
+    {
+      "name": "firstname",
+      "label": "First name",
+      "fieldType": "text",
+      "required": false
+    },
+    {
+      "name": "email",
+      "label": "Work email",
+      "fieldType": "text",
+      "required": true
+    }
+  ]
+}

package/examples/minimal-site/content/forms/properties.json

@@ -0,0 +1,7 @@
+[
+  {
+    "name": "topic",
+    "label": "Inquiry topic",
+    "fieldType": "text"
+  }
+]

package/examples/minimal-site/content/pages/about.json

@@ -0,0 +1,9 @@
+{
+  "slug": "about",
+  "name": "About",
+  "htmlTitle": "About Example",
+  "metaDescription": "A minimal hcms about page.",
+  "language": "en",
+  "templatePath": "example-theme/templates/page.html",
+  "desiredState": "draft"
+}

package/examples/minimal-site/content/pages/home.json

@@ -0,0 +1,9 @@
+{
+  "slug": "",
+  "name": "Home",
+  "htmlTitle": "Example Home",
+  "metaDescription": "A minimal hcms homepage.",
+  "language": "en",
+  "templatePath": "example-theme/templates/home.html",
+  "desiredState": "publish"
+}

package/examples/minimal-site/content/pages/home.widgets.json

@@ -0,0 +1,17 @@
+{
+  "slug": "",
+  "widgets": {
+    "hero": {
+      "body": {
+        "headline": "Ship HubSpot CMS from git",
+        "image": "@asset:hero.svg",
+        "form_id": "@form:contact"
+      },
+      "name": "hero",
+      "type": "module",
+      "label": "Hero",
+      "css": {},
+      "child_css": {}
+    }
+  }
+}

package/examples/minimal-site/css/main.css

@@ -0,0 +1,3 @@
+.hero {
+  padding: 3rem 0;
+}

package/examples/minimal-site/fields.json

@@ -0,0 +1,11 @@
+[
+  {
+    "name": "brand_color",
+    "label": "Brand color",
+    "type": "color",
+    "default": {
+      "color": "#2f6fed",
+      "opacity": 100
+    }
+  }
+]

package/examples/minimal-site/hubspot-cms-sync.config.mjs

@@ -0,0 +1,27 @@
+export default {
+  accountsFile: 'sync/accounts.json',
+  keyDirEnv: 'HUBSPOT_KEY_DIR',
+  contentDir: 'content',
+  syncStateDir: '.sync-state',
+  manifestPath: 'site.manifest.json',
+  redirectsFile: 'sync/redirects.csv',
+  readOnlyPortalIds: ['999999'],
+  knownPortalIds: ['123456'],
+  theme: {
+    name: 'example-theme',
+    dirs: ['templates', 'modules', 'css', 'js', 'images'],
+    files: ['theme.json', 'fields.json']
+  },
+  blog: {
+    slug: 'blog',
+    itemTemplate: 'example-theme/templates/blog-post.html',
+    listingTemplate: 'example-theme/templates/blog.html'
+  },
+  uiGated: ['blogContainerCreate', 'domainConnect'],
+  verification: {
+    baseUrlEnv: 'SITE_BASE_URL',
+    commands: {
+      corpus: 'hcms corpus'
+    }
+  }
+};

package/examples/minimal-site/js/hs-forms.js

@@ -0,0 +1 @@
+window.EXAMPLE_PORTAL_ID = '@portal';

package/examples/minimal-site/modules/hero.module/fields.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": "headline",
+    "label": "Headline",
+    "type": "text",
+    "default": "Ship HubSpot CMS from git"
+  },
+  {
+    "name": "form_id",
+    "label": "Contact form",
+    "type": "form",
+    "default": "@form:contact"
+  }
+]

package/examples/minimal-site/modules/hero.module/module.html

@@ -0,0 +1,4 @@
+<section class="hero">
+  <h1>{{ module.headline }}</h1>
+  {% form form_to_use="{{ module.form_id }}" %}
+</section>

package/examples/minimal-site/site.manifest.json

@@ -0,0 +1,29 @@
+{
+  "theme": {
+    "name": "example-theme"
+  },
+  "pages": [
+    {
+      "slug": "",
+      "templatePath": "example-theme/templates/home.html",
+      "desiredState": "publish"
+    },
+    {
+      "slug": "about",
+      "templatePath": "example-theme/templates/page.html",
+      "desiredState": "draft"
+    }
+  ],
+  "blog": {
+    "slug": "blog",
+    "itemTemplate": "example-theme/templates/blog-post.html",
+    "listingTemplate": "example-theme/templates/blog.html"
+  },
+  "forms": [
+    "contact"
+  ],
+  "uiGated": [
+    "blogContainerCreate",
+    "domainConnect"
+  ]
+}

package/examples/minimal-site/sync/accounts.json

@@ -0,0 +1,10 @@
+{
+  "dev": {
+    "portalId": "123456",
+    "label": "example dev portal"
+  },
+  "prod": {
+    "portalId": "999999",
+    "label": "example production portal"
+  }
+}

package/examples/minimal-site/sync/redirects.csv

@@ -0,0 +1,2 @@
+routePrefix,destination,redirectStyle,isOnlyAfterNotFound
+/old-about,/about,301,false

package/examples/minimal-site/templates/blog-post.html

@@ -0,0 +1,8 @@
+<!--
+  templateType: blog_post
+  label: Example Blog Post
+-->
+<article>
+  <h1>{{ content.name }}</h1>
+  {{ content.post_body }}
+</article>

package/examples/minimal-site/templates/blog.html

@@ -0,0 +1,9 @@
+<!--
+  templateType: blog_listing
+  label: Example Blog Listing
+-->
+<main>
+  {% for content in contents %}
+    <article><a href="{{ content.absolute_url }}">{{ content.name }}</a></article>
+  {% endfor %}
+</main>

package/examples/minimal-site/templates/home.html

@@ -0,0 +1,5 @@
+<!--
+  templateType: page
+  label: Example Home
+-->
+{% module "hero" path="../modules/hero.module" %}

package/examples/minimal-site/templates/page.html

@@ -0,0 +1,7 @@
+<!--
+  templateType: page
+  label: Example Page
+-->
+<main>
+  <h1>{{ content.name }}</h1>
+</main>

package/examples/minimal-site/theme.json

@@ -0,0 +1,4 @@
+{
+  "label": "Example Theme",
+  "preview_path": "./templates/home.html"
+}

package/package.json

@@ -1,16 +1,24 @@
 {
   "name": "hubspot-cms-sync",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Git-backed bidirectional sync for HubSpot CMS themes, content, blogs, forms, and assets.",
   "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7thsense/hubspot-cms-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/7thsense/hubspot-cms-sync/issues"
+  },
+  "homepage": "https://github.com/7thsense/hubspot-cms-sync#readme",
   "engines": {
     "node": ">=20.10.0",
     "npm": ">=10"
   },
   "bin": {
-    "hubspot-cms-sync": "./bin/hubspot-cms-sync.mjs",
-    "hcms": "./bin/hubspot-cms-sync.mjs"
+    "hubspot-cms-sync": "bin/hubspot-cms-sync.mjs",
+    "hcms": "bin/hubspot-cms-sync.mjs"
   },
   "exports": {
     ".": "./src/index.mjs",
@@ -18,6 +26,7 @@
     "./lib/*": "./src/lib/*.mjs",
     "./manifest": "./src/manifest.mjs",
     "./preflight": "./src/preflight.mjs",
+    "./redirects": "./src/redirects.mjs",
     "./cta-inventory": "./src/cta-inventory.mjs",
     "./corpus-scan": "./src/corpus-scan.mjs"
   },
@@ -37,5 +46,10 @@
     "lint": "node --check bin/hubspot-cms-sync.mjs && node bin/hubspot-cms-sync.mjs --help >/dev/null",
     "prepare": "npm run lint",
     "prepublishOnly": "npm test && npm run lint && npm pack --dry-run"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "js-yaml": "^4.2.0",
+    "nunjucks": "^3.2.4"
   }
 }

package/skill/references/commands.md

@@ -35,11 +35,15 @@ hcms corpus
 hcms preflight <target>
 hcms push <target> --dry-run
 hcms push <target> --publish
+hcms redirects <target>
+hcms redirects <target> --apply
 the consuming repo verification commands
 ```
 
 Stop before `push` if preflight or plan output indicates a read-only portal,
 unresolved dependency, missing credential, or unexpected destructive change.
+Run `hcms redirects` without `--apply` first when redirects are part of the
+deployment surface.
 
 ## Republish
 

package/skill/references/config.md

@@ -9,6 +9,7 @@ Key fields:
 - `contentDir`: local CMS content directory.
 - `syncStateDir`: local sync state directory; do not edit by hand.
 - `manifestPath`: path to `site.manifest.json`.
+- `redirectsFile`: optional CSV or JSON file for repo-managed URL redirects.
 - `readOnlyPortalIds`: portals that must never receive writes.
 - `knownPortalIds`: expected portal allowlist.
 - `assetHosts`: host canonicalization policy for HubSpot assets.
@@ -19,7 +20,10 @@ Key fields:
 - `verification`: base URL environment variable and repo-specific test commands.
 
 `site.manifest.json` is the deployment surface for theme, blog, forms, pages,
-and UI-gated operations. If the manifest and config disagree, stop and ask for
-the intended source of truth.
+and UI-gated operations. Redirects are managed separately through
+`redirectsFile`. If the manifest and config disagree, stop and ask for the
+intended source of truth.
 
 Use paths relative to the repo root unless the config explicitly says otherwise.
+See `docs/CONTENT_LAYOUT.md` for the expected repository layout and minimal
+sample tree.

package/src/config.mjs

@@ -14,6 +14,7 @@ export function defaultConfig(root = process.cwd()) {
     contentDir: 'content',
     syncStateDir: '.sync-state',
     manifestPath: 'site.manifest.json',
+    redirectsFile: null,
     readOnlyPortalIds: [],
     knownPortalIds: [],
     assetHosts: {
@@ -67,6 +68,7 @@ export function resolveConfigPaths(cfg) {
     contentDirPath: abs(cfg.contentDir),
     syncStateDirPath: abs(cfg.syncStateDir),
     manifestFilePath: abs(cfg.manifestPath),
+    redirectsFilePath: cfg.redirectsFile ? abs(cfg.redirectsFile) : null,
   };
 }
 
@@ -94,6 +96,9 @@ export function validateConfig(cfg) {
   if (!cfg.contentDir) errors.push('missing contentDir');
   if (!cfg.syncStateDir) errors.push('missing syncStateDir');
   if (!cfg.manifestPath) errors.push('missing manifestPath');
+  if (cfg.redirectsFile != null && typeof cfg.redirectsFile !== 'string') {
+    errors.push('redirectsFile must be a string when set');
+  }
   if (!Array.isArray(cfg.readOnlyPortalIds)) errors.push('readOnlyPortalIds must be an array');
   if (!Array.isArray(cfg.knownPortalIds)) errors.push('knownPortalIds must be an array');
   if (!cfg.theme?.name) errors.push('theme.name is required');

package/src/index.mjs

@@ -1,3 +1,4 @@
 export { loadConfig } from './config.mjs';
 export { pull } from './pull.mjs';
 export { push, preflightRefs } from './push.mjs';
+export { syncRedirects, planRedirects, parseRedirectCsv } from './redirects.mjs';

package/src/lib/content-view.mjs

@@ -0,0 +1,168 @@
+// src/lib/content-view.mjs — NEUTRAL content projection.
+//
+// THE BOUNDARY. The on-disk canonical store is HubSpot's CMS WIRE FORMAT: pages
+// carry `widgets.<name>.body.<field>` editor carriers (with load-bearing empty
+// `css`/`child_css`/`label` objects that HubSpot's replace-not-merge PATCH
+// requires — see lib/canonical.mjs), blog posts use HubSpot Blog API field names
+// (`postBody`, `useFeaturedImage`, `blogSlug`, `state:"PUBLISHED"`), and module
+// `fields.json` files carry server-assigned GUIDs and `content_types` enums.
+//
+// None of that belongs in a GENERIC publishing toolkit. This module projects the
+// wire format into a small, target-agnostic VIEW that the renderer and any future
+// non-HubSpot target consume. The renderer NEVER reaches into `.widgets.x.body`,
+// reads a field GUID, or knows the string "PUBLISHED" — it sees only this view.
+//
+// Identity portability (@asset:/@portal/@form: refs) was already solved by
+// lib/refs.mjs. This is the same idea extended to SCHEMA portability: the HubSpot
+// blob is one target's codec output, not the canonical truth. Today the view is
+// derived from the blob on read; later the view's shape could become the on-disk
+// format and a HubSpot codec could reconstruct the blob — the seam is the same.
+//
+// PURE except for the explicit fs reads in load*(). The project*() transforms are
+// pure functions over parsed JSON so they unit-test without a fixture tree.
+
+import { readFile, readdir } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+
+// ---------------------------------------------------------------------------
+// Status vocabulary. HubSpot speaks `desiredState` (page) and `state` (post):
+// publish|draft|archive|ignore / PUBLISHED|DRAFT. The view speaks one neutral
+// enum so a target never branches on a HubSpot string.
+// ---------------------------------------------------------------------------
+const STATUS = { published: 'published', draft: 'draft', archived: 'archived' };
+
+function neutralStatus(raw) {
+  if (!raw) return STATUS.draft;
+  const s = String(raw).toLowerCase();
+  if (s === 'publish' || s === 'published') return STATUS.published;
+  if (s === 'archive' || s === 'archived' || s === 'ignore') return STATUS.archived;
+  return STATUS.draft;
+}
+
+// ---------------------------------------------------------------------------
+// projectPost(raw, authorsByName) -> neutral post view
+//
+// Maps HubSpot Blog API field names onto neutral names and JOINS the author
+// record by name. `body`/`summary` stay as raw HTML strings (still carrying
+// @asset: refs for the target to resolve). `featuredImage` is left as its
+// logical ref — ref resolution is the TARGET's job, not the view's.
+// ---------------------------------------------------------------------------
+export function projectPost(raw, authorsByName = {}) {
+  const author = authorsByName[raw.authorName] || (raw.authorName ? { name: raw.authorName } : null);
+  return {
+    kind: 'post',
+    // Routing: HubSpot stores `slug` as "blog/<slug>"; the route is absolute.
+    slug: raw.slug,
+    route: '/' + String(raw.slug || '').replace(/^\/+/, ''),
+    status: neutralStatus(raw.state),
+    title: raw.name,
+    htmlTitle: raw.htmlTitle || raw.name,
+    metaDescription: raw.metaDescription || '',
+    body: raw.postBody || '',
+    summary: raw.postSummary || '',
+    publishDate: raw.publishDate || null,
+    tags: Array.isArray(raw.tagNames) ? raw.tagNames.slice() : [],
+    author,
+    featuredImage: raw.useFeaturedImage ? raw.featuredImage || null : null,
+    featuredImageAlt: raw.featuredImageAltText || '',
+    blogSlug: raw.blogSlug || 'blog',
+  };
+}
+
+// ---------------------------------------------------------------------------
+// projectPage(raw) -> neutral page view
+//
+// The crux of the schema-portability argument. HubSpot nests per-module field
+// values under `widgets.<instanceName>.body.<field>`, wrapped in editor cruft
+// (`css`, `child_css`, `label`, `type:"module"`) that is inert at render time.
+// The view flattens each carrier to `modules[instanceName] = {<field>: value}`
+// and drops the cruft. The renderer keys modules by instance name; it never sees
+// `body` or the empty style objects the HubSpot target round-trips.
+// ---------------------------------------------------------------------------
+export function projectPage(raw) {
+  const modules = {};
+  const widgets = raw.widgets || {};
+  for (const [name, carrier] of Object.entries(widgets)) {
+    if (!carrier || carrier.type !== 'module') continue;
+    modules[name] = { ...(carrier.body || {}) };
+  }
+  // `templatePath` is "<theme>/templates/<file>.html"; the view keeps the file
+  // path relative to the theme so the renderer's loader resolves it.
+  const tpl = String(raw.templatePath || '');
+  const templateRel = tpl.replace(/^[^/]+\//, ''); // drop leading "<theme>/"
+  return {
+    kind: 'page',
+    slug: raw.slug ?? '',
+    route: '/' + String(raw.slug ?? '').replace(/^\/+/, ''),
+    status: neutralStatus(raw.desiredState),
+    title: raw.name,
+    htmlTitle: raw.htmlTitle || raw.name,
+    metaDescription: raw.metaDescription || '',
+    language: raw.language || 'en',
+    template: templateRel,
+    modules,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Loaders. The only I/O in this module.
+// ---------------------------------------------------------------------------
+async function readJson(file) {
+  return JSON.parse(await readFile(file, 'utf8'));
+}
+
+/** loadAuthors(blogDir) -> { [displayName|name]: neutralAuthor } */
+export async function loadAuthors(blogDir) {
+  const byName = {};
+  try {
+    const authors = await readJson(join(blogDir, 'authors.json'));
+    for (const a of authors) {
+      const neutral = {
+        name: a.displayName || a.fullName || a.name,
+        bio: a.bio || '',
+        avatar: a.avatar || null,
+        slug: a.slug || null,
+      };
+      for (const key of [a.displayName, a.fullName, a.name]) {
+        if (key) byName[key] = neutral;
+      }
+    }
+  } catch {
+    /* authors.json optional */
+  }
+  return byName;
+}
+
+/** loadPosts(contentDir) -> neutralPostView[] (newest first) */
+export async function loadPosts(contentDir) {
+  const blogDir = join(contentDir, 'blog');
+  const postsDir = join(blogDir, 'posts');
+  const authorsByName = await loadAuthors(blogDir);
+  const files = (await readdir(postsDir)).filter((f) => f.endsWith('.json'));
+  const posts = [];
+  for (const f of files.sort()) {
+    posts.push(projectPost(await readJson(join(postsDir, f)), authorsByName));
+  }
+  posts.sort((a, b) => String(b.publishDate || '').localeCompare(String(a.publishDate || '')));
+  return posts;
+}
+
+/** loadPages(contentDir) -> neutralPageView[] */
+export async function loadPages(contentDir) {
+  const pagesDir = join(contentDir, 'pages');
+  const files = (await readdir(pagesDir)).filter((f) => f.endsWith('.json'));
+  const pages = [];
+  for (const f of files.sort()) {
+    pages.push(projectPage(await readJson(join(pagesDir, f))));
+  }
+  return pages;
+}
+
+/** loadSite(siteDir) -> { posts, pages } against a theme repo root. */
+export async function loadSite(siteDir, { contentDir = 'content' } = {}) {
+  const cdir = join(siteDir, contentDir);
+  const [posts, pages] = await Promise.all([loadPosts(cdir), loadPages(cdir)]);
+  return { posts, pages };
+}
+
+export { basename, STATUS };

package/src/lib/posts-format.mjs

@@ -0,0 +1,90 @@
+// src/lib/posts-format.mjs — lossless codec between a blog post's HubSpot WIRE
+// JSON and a human-readable frontmatter+body FILE.
+//
+// HubSpot stays the PRIMARY target, so this reshaping must never lose a field the
+// blog push depends on. The contract is strict: fileToWire(wireToFile(x)) deep-
+// equals x for every post in the corpus (proven by scripts/posts-roundtrip.mjs and
+// the unit test). Losslessness is by CONSTRUCTION — known fields get pretty,
+// neutral names; every other field passes through verbatim, so nothing is ever
+// silently dropped. The pretty layer is cosmetic; the passthrough layer is the
+// safety net.
+//
+// Why frontmatter: every post in the corpus is flat scalars + one array + two HTML
+// blobs, the textbook frontmatter shape. The body becomes readable HTML; the diff
+// becomes prose instead of an escaped JSON string; and Git-CMS tools (Keystatic /
+// Tina / Decap) can later edit it directly. Templates and the page format are
+// untouched — this is the light-touch slice.
+//
+// YAML note: js-yaml's DEFAULT_SCHEMA coerces ISO timestamps to Date objects, which
+// would corrupt `publishDate` on round-trip. CORE_SCHEMA has no timestamp type, so
+// every scalar stays the string it was. lineWidth:-1 disables line folding so long
+// HTML/strings survive byte-for-byte.
+
+import yaml from 'js-yaml';
+
+const SCHEMA = yaml.CORE_SCHEMA;
+const DUMP_OPTS = { schema: SCHEMA, lineWidth: -1, noRefs: true, quotingType: '"' };
+
+// Wire field -> pretty frontmatter key (bijective). `state` and `postBody` are
+// handled specially (status transform / body extraction); everything NOT listed
+// here passes through under its own wire name, so the codec can never drop a field.
+const TO_PRETTY = {
+  name: 'title',
+  authorName: 'author',
+  tagNames: 'tags',
+  featuredImageAltText: 'featuredImageAlt',
+  postSummary: 'summary',
+};
+const TO_WIRE = Object.fromEntries(Object.entries(TO_PRETTY).map(([w, p]) => [p, w]));
+
+const STATE_TO_STATUS = { PUBLISHED: 'published', DRAFT: 'draft' };
+const STATUS_TO_STATE = Object.fromEntries(Object.entries(STATE_TO_STATUS).map(([s, t]) => [t, s]));
+
+// Frontmatter key order: authored fields first (readability), passthrough/sync
+// metadata last. Keys not listed keep insertion order after these.
+const KEY_ORDER = ['title', 'htmlTitle', 'slug', 'status', 'publishDate', 'author',
+  'tags', 'featuredImage', 'featuredImageAlt', 'useFeaturedImage', 'metaDescription', 'summary'];
+
+function orderKeys(obj) {
+  const out = {};
+  for (const k of KEY_ORDER) if (k in obj) out[k] = obj[k];
+  for (const k of Object.keys(obj)) if (!(k in out)) out[k] = obj[k];
+  return out;
+}
+
+/**
+ * wireToFile(post) -> string  (frontmatter + HTML body)
+ * `postBody` becomes the body; every other field becomes frontmatter, renamed to
+ * its pretty key when one exists, otherwise passed through verbatim.
+ */
+export function wireToFile(post) {
+  const fm = {};
+  let body = '';
+  for (const [k, v] of Object.entries(post)) {
+    if (k === 'postBody') { body = v ?? ''; continue; }
+    if (k === 'state') { fm.status = STATE_TO_STATUS[v] ?? v; continue; }
+    fm[TO_PRETTY[k] ?? k] = v;
+  }
+  const front = yaml.dump(orderKeys(fm), DUMP_OPTS);
+  return `---\n${front}---\n${body}`;
+}
+
+const FENCE_RE = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+
+/**
+ * fileToWire(str) -> post  (inverse of wireToFile)
+ * Restores `postBody` from the body and inverts the pretty renames / status map;
+ * passthrough keys return under their original wire names unchanged.
+ */
+export function fileToWire(str) {
+  const m = FENCE_RE.exec(str);
+  if (!m) throw new Error('posts-format: missing or malformed frontmatter fence');
+  const fm = yaml.load(m[1], { schema: SCHEMA }) || {};
+  const post = {};
+  for (const [k, v] of Object.entries(fm)) {
+    if (k === 'status') { post.state = STATUS_TO_STATE[v] ?? v; continue; }
+    post[TO_WIRE[k] ?? k] = v;
+  }
+  post.postBody = m[2];
+  return post;
+}