@traiwa/cms-client 0.11.0 → 0.11.1

package/README.md

@@ -57,10 +57,15 @@ const { data: posts } = await cms.listContent({ type: "article", limit: 20 });
 | Method | Endpoint | Returns |
 |---|---|---|
 | `getPage(slug)` | `GET /api/public/pages/:slug` | `SitePage` (with `sections: PageSection[]`) |
+| `getPageJsonLd(slug)` | `GET /api/public/pages/:slug/jsonld` | Pre-computed JSON-LD object |
 | `listPages()` | `GET /api/public/pages` | `{ data: SitePageSummary[], count: number }` |
+| `getPackage(slug)` | `GET /api/public/packages/:slug` | `Package` (with `sections: PageSection[]`) |
+| `getPackageJsonLd(slug)` | `GET /api/public/packages/:slug/jsonld` | Pre-computed JSON-LD object |
+| `listPackages(query?)` | `GET /api/public/packages?...` | `{ data: PackageSummary[], count: number }` |
 | `getSettings()` | `GET /api/public/settings` | `SiteSettings` |
 | `getContent(slug)` | `GET /api/public/content/:slug` | `Article` |
 | `listContent(query?)` | `GET /api/public/content?...` | `{ data: Article[], count: number }` |
+| `getSitemap()` | `GET /api/public/sitemap.xml` | `string` (raw XML) |
 | `listBlogs()` | `GET /api/blogs` | `Blog[]` |
 | `getBlog(id)` | `GET /api/blogs/:id` | `Blog` |
 | `getBlogBySlug(slug)` | `GET /api/blogs/slug/:slug` | `Blog` |
@@ -79,10 +84,27 @@ import type { PageSection } from "@traiwa/cms-client";
 function renderSection(section: PageSection) {
   switch (section.type) {
     case "hero": return <Hero {...section} />;
+    case "singleImage": return <SingleImage {...section} />;
     case "packages": return <PackageCollection {...section} />;
     case "testimonials": return <TestimonialCollection {...section} />;
     case "faq": return <FAQSection {...section} />;
     case "stats": return <StatsSection {...section} />;
+    case "destinations": return <Destinations {...section} />;
+    case "features": return <Features {...section} />;
+    case "checklist": return <Checklist {...section} />;
+    case "richText": return <RichText {...section} />;
+    case "enquiryForm": return <EnquiryForm {...section} />;
+    case "categoryGrid": return <CategoryGrid {...section} />;
+    case "team": return <Team {...section} />;
+    case "specCards": return <SpecCards {...section} />;
+    case "splitContent": return <SplitContent {...section} />;
+    case "timeline": return <Timeline {...section} />;
+    case "cta": return <Cta {...section} />;
+    case "logoGrid": return <LogoGrid {...section} />;
+    case "blogGrid": return <BlogGrid {...section} />;
+    case "itinerary": return <Itinerary {...section} />;
+    case "inclusions": return <Inclusions {...section} />;
+    case "locationMap": return <LocationMap {...section} />;
   }
 }
 ```
@@ -202,6 +224,128 @@ await admin.admin.updateBlog(post.id, { title: "Updated title" });
 await admin.admin.deleteBlog(post.id);
 ```
 
+### Packages
+
+Package detail pages share the exact same section model as site pages (`sections: PageSection[]`) — anything that works for `page.sections` works for `pkg.sections` too.
+
+Reads are public (no token needed); writes require an admin token.
+
+```ts
+const cms = createClient({ baseUrl: "https://cms.example.com" });
+
+// Detail page — only `status: published` packages resolve
+const pkg = await cms.getPackage("munnar-honeymoon-tour");
+
+// Pre-computed JSON-LD for the detail page's <script type="application/ld+json">
+const jsonLd = await cms.getPackageJsonLd("munnar-honeymoon-tour");
+
+// Related packages — same category, current package excluded
+const { data: related } = await cms.listPackages({
+  category: pkg.category,
+  exclude: pkg.slug,
+  limit: 4,
+});
+```
+
+```ts
+const admin = createClient({
+  baseUrl: "https://cms.example.com",
+  token: process.env.CMS_ADMIN_TOKEN!,
+});
+
+const all = await admin.admin.listPackages(); // every status, full sections
+const created = await admin.admin.createPackage({
+  title: "Munnar Honeymoon Tour",
+  price: "₹24,999",
+  image: "/api/media/file/munnar-hero.jpg",
+  category: "honeymoon",
+});
+await admin.admin.updatePackage(created.id, { status: "published" });
+const copy = await admin.admin.duplicatePackage(created.id); // "(Copy)", draft, new slug
+await admin.admin.deletePackage(copy.id);
+
+// One-off, idempotent migration: link legacy hand-typed `packages`-block cards
+// (from before the Package collection existed) to a real Package doc, creating
+// one from the card's own fields when no match exists yet. Safe to re-run —
+// already-linked cards are left untouched.
+const result = await admin.admin.backfillPackageLinks();
+```
+
+### Site Pages (admin)
+
+Public reads use `getPage` / `listPages` / `getPageJsonLd` (see the Methods table above). Writes require an admin token.
+
+```ts
+const admin = createClient({
+  baseUrl: "https://cms.example.com",
+  token: process.env.CMS_ADMIN_TOKEN!,
+});
+
+const all = await admin.admin.listPages(); // every status, full sections
+const page = await admin.admin.createPage({ title: "New Destination", sections: [] });
+await admin.admin.updatePage(page.id, { status: "published" });
+const copy = await admin.admin.duplicatePage(page.id); // "(Copy)", draft, new slug
+await admin.admin.deletePage(copy.id);
+```
+
+### Block Types & Custom Blocks
+
+Two separate admin-only registries that back the page builder:
+
+- **Block types** (`admin.*BlockType*`) — which section `kind`s are enabled and how they're labeled in the builder UI.
+- **Custom blocks** (`admin.*Block`, no "Type") — reusable, pre-filled section presets an author can drop onto any page.
+
+```ts
+const admin = createClient({
+  baseUrl: "https://cms.example.com",
+  token: process.env.CMS_ADMIN_TOKEN!,
+});
+
+// Block types
+const types = await admin.admin.listBlockTypes();
+await admin.admin.createBlockType({ label: "Itinerary", kind: "itinerary" });
+await admin.admin.updateBlockType("itinerary", { label: "Trip Itinerary", enabled: true });
+await admin.admin.deleteBlockType("itinerary"); // disables it
+
+// Custom block presets
+const presets = await admin.admin.listBlocks();
+const preset = await admin.admin.createBlock({
+  name: "Standard FAQ",
+  section: { type: "faq", kind: "faq", title: "FAQ", items: [] },
+});
+await admin.admin.updateBlock(preset.id, { description: "Default FAQ shell" });
+await admin.admin.deleteBlock(preset.id);
+```
+
+### AI / SEO proxy
+
+Admin-only helpers that proxy to the AxoraConsole LLM and validate structured data before publish.
+
+```ts
+const admin = createClient({
+  baseUrl: "https://cms.example.com",
+  token: process.env.CMS_ADMIN_TOKEN!,
+});
+
+const translated = await admin.admin.translate({
+  text: "Book your Munnar honeymoon package today.",
+  target_language: "hi",
+});
+
+const summary = await admin.admin.summarize({
+  text: longArticleBody,
+  style: "bullets",
+  max_bullets: 5,
+});
+
+// Validate JSON-LD (single object or array) against Google Rich Results rules
+// before writing it into PageSEO.schemas.
+const report = await admin.admin.validateJsonLd(jsonLdPayload);
+if (report.overall === "fail") {
+  console.error(report.results.filter((r) => r.status === "fail"));
+}
+```
+
 ### Contact / Enquiry forms
 
 `sendEmail` accepts either the package-enquiry shape (`ContactFormData`) or the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traiwa/cms-client",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Tiny typed client for the FlexCMS / Traiwa Page Builder API. Fetch pages, list published slugs, and load site settings in any TypeScript/JavaScript app.",
   "type": "module",
   "main": "./dist/index.js",