Content, money, and orders

A grab-bag of the remaining surface: the server-only content API, money formatting, and order status lookup.

`content`

@replohq/sdk/content

`ContentCollectionEntry`

One entry’s slot in a collection listing.

import type { ContentCollectionEntry } from "@replohq/sdk/content";

Field	Type	Required
`coverImage`	`string`	Yes
`coverImageAlt`	`string`	Yes
`excerpt`	`string`	Yes
`publishedAt`	`string`	Yes
`slug`	`string`	Yes
`status`	`"draft" \| "published"`	Yes
`title`	`string`	Yes

`ContentEntryJsonLd`

Structured data for an entry as a JSON-LD script tag. Serialization is script-safe (< escaped) so entry content can never break out of the tag. The type is a deliberately neutral WebPage; collections have no schema type of their own.

import { ContentEntryJsonLd } from "@replohq/sdk/content";

ContentEntryJsonLd: ({ entry }: { entry: ContentEntry; }) => JSX.Element

`ContentField`

Public name for the shared collection-field contract.

import type { ContentField } from "@replohq/sdk/content";

Field	Type	Required
`builtin`	`boolean`	Yes
`enabled`	`boolean`	Yes
`helpText`	`string`	No
`id`	`string`	Yes
`label`	`string`	Yes
`required`	`boolean`	Yes
`type`	`"boolean" \| "date" \| "url" \| "image" \| "status" \| "tags" \| "short-text" \| "long-text" \| "rich-text" \| "related"`	Yes

`ContentFieldWithValue`

An ordered content field paired with this entry’s value for it.

import type { ContentFieldWithValue } from "@replohq/sdk/content";

Field	Type	Required	Description
`field`	`{ id: string; label: string; type: "boolean" \| "date" \| "url" \| "image" \| "status" \| "tags" \| "short-text" \| "long-text" \| "rich-text" \| "related"; required: boolean; enabled: boolean; builtin: boolean; helpText?: string; }`	Yes
`value`	`unknown`	Yes

`ContentRelatedLink`

A related entry resolved to a public link; unresolvable refs stay plain text.

import type { ContentRelatedLink } from "@replohq/sdk/content";

Field	Type	Required	Description
`href`	`string`	Yes
`title`	`string`	Yes

`getContentCollection`

A collection and its renderable entries for a listing page. Uses the not-found contract when the collection is missing or archived.

import { getContentCollection } from "@replohq/sdk/content";

getContentCollection: ({ collection, ...contentOptions }: { collection: string; } & ContentOptions) => Promise<ContentCollection>

`getContentCollectionStaticParams`

Static params for one collection’s [slug] detail route.

import { getContentCollectionStaticParams } from "@replohq/sdk/content";

getContentCollectionStaticParams: ({ collection, ...contentOptions }: { collection: string; } & ContentOptions) => Promise<{ slug: string; }[]>

`getContentEntryMetadata`

Per-entry head metadata (title/description/OpenGraph/Twitter) from the entry’s SEO fields with content fallbacks. Returns an empty object when the entry is not renderable, so generateMetadata can call it unconditionally.

import { getContentEntryMetadata } from "@replohq/sdk/content";

getContentEntryMetadata: ({ collection, slug, ...contentOptions }: { collection: string; slug: string; } & ContentOptions) => Promise<Metadata>

`getContentFields`

The entry’s renderable content fields in collection-settings order, paired with values. This is the published half of the shared ordering contract in schemas/contentCollection; empty values are omitted so templates never render bare labels.

import { getContentFields } from "@replohq/sdk/content";

getContentFields: (entry: ContentEntry) => ContentFieldWithValue[]

`getContentSitemapEntries`

Absolute sitemap entries for every collection listing and renderable entry. origin comes from the caller (e.g. the request’s platform-validated Host) because site origins are not fixed at build time.

import { getContentSitemapEntries } from "@replohq/sdk/content";

getContentSitemapEntries: ({ origin, ...contentOptions }: { origin: string; } & ContentOptions) => Promise<ContentSitemapEntry[]>

`getContentSitemapXml`

The full sitemap XML document for a site’s content (home, collection listings, entries). Kept here so the generated sitemap route stays a tiny, restylable-free shell around one call.

import { getContentSitemapXml } from "@replohq/sdk/content";

getContentSitemapXml: ({ origin, ...contentOptions }: { origin: string; } & ContentOptions) => Promise<string>

Also exported

Export	Kind	Type
`ContentCollection`	type	`{ description: string; entries: ContentCollectionEntry[]; name: string; slug: string }`
`ContentEntry`	type	`{ body: string; collection: { name: string; description: string; slug: string; }; fields: { id: string; label: string; type: "boolean" \| "date" \| "url" \| "image" \| "status" \| "tags" \| "short-text" \| "long-text" \| "rich-text" \| "related"; required: boolean; enabled: boolean; builtin: boolean; helpText?: string; }[]; slug: string; values: Record<string, unknown> }`
`ContentFieldValue`	component	`({ field, value, }: { field: ContentField; value: unknown; }) => ReactNode`
`ContentSitemapEntry`	type	`{ lastModified?: Date; url: string }`
`ContentSource`	type	`{ listCollections: () => Promise<string[]>; listEntries: (collection: string) => Promise<string[]>; read: (relativePath: string) => Promise<string \| null> }`
`createContentSource`	function	`({ contentDirectory, contentManifest, }?: { contentDirectory?: string; contentManifest?: ContentManifest; }) => ContentSource`
`getContentEntry`	function	`({ collection, slug, ...contentOptions }: { collection: string; slug: string; } & ContentOptions) => Promise<ContentEntry>`

`money`

@replohq/sdk/money

`formatAmount`

Formats integer minor units for display, e.g. 1999 -> “$19.99” (USD), “¥1,999” (JPY).

import { formatAmount } from "@replohq/sdk/money";

formatAmount: ({ amount, currencyCode, locale, }: { amount: number; currencyCode: string; locale?: string; }) => string

`fromMajorUnitsToMinorUnits`

Converts a decimal major-unit amount (e.g. “19.99”, 19.99) into integer minor units (1999) using the currency’s Stripe exponent. Half-away-from-zero rounding for the non-negative amounts this domain uses (prices, totals), matching Stripe. Throws on non-numeric input.

import { fromMajorUnitsToMinorUnits } from "@replohq/sdk/money";

fromMajorUnitsToMinorUnits: ({ amount, currencyCode, }: { amount: number | string; currencyCode: string; }) => number

`fromMinorUnitsToMajorUnits`

Converts integer minor units (1999) back into a decimal major-unit number (19.99). Only for true decimal boundaries: display, analytics events, and third-party APIs that speak major units.

import { fromMinorUnitsToMajorUnits } from "@replohq/sdk/money";

fromMinorUnitsToMajorUnits: ({ amount, currencyCode, }: { amount: number; currencyCode: string; }) => number

`fromMinorUnitsToMajorUnitsString`

Renders integer minor units as a plain decimal string for providers that speak decimal money (e.g. Printful retail_price): 1999 -> “19.99” (USD), “1999” (JPY), “1.999” (KWD).

import { fromMinorUnitsToMajorUnitsString } from "@replohq/sdk/money";

fromMinorUnitsToMajorUnitsString: ({ amount, currencyCode, }: { amount: number; currencyCode: string; }) => string

`orders/order-status`

@replohq/sdk/orders/order-status

`getOrderStatus`

Resolve an order-status reference (an order’s statusToken, or a cs_ Stripe Checkout Session id straight after checkout) into what the order status page renders. Every failure — network, non-200, contract drift — maps to { state: "unavailable" }: a broken status lookup must degrade to the page’s no-data state, never take the storefront down.

import { getOrderStatus } from "@replohq/sdk/orders/order-status";

getOrderStatus: ({ reference, }: { reference: string; }) => Promise<OrderStatusResult>

`orders/order-status-schema`

@replohq/sdk/orders/order-status-schema Exports

Export	Kind	Type
`CheckoutSessionSummary`	type	`{ paymentStatus: "paid" \| "unpaid" \| "no_payment_required"; items: { title: string; quantity: number; lineTotal: number; unitPrice?: number; }[]; currencyCode?: string; subtotalAmount?: number; totalAmount?: number; }`
`checkoutSessionSummarySchema`	const	—
`orderFinancialStatusSchema`	const	`z.ZodEnum<{ pending: "pending"; paid: "paid"; failed: "failed"; refunded: "refunded"; partiallyRefunded: "partiallyRefunded"; }>`
`OrderStatusAddress`	type	`{ line1: string; city: string; postalCode: string; country: string; name?: string; line2?: string; state?: string; }`
`orderStatusAddressSchema`	const	`z.ZodObject<{ name: z.ZodNullable<z.ZodString>; line1: z.ZodString; line2: z.ZodNullable<z.ZodString>; city: z.ZodString; state: z.ZodNullable<z.ZodString>; postalCode: z.ZodString; country: z.ZodString; }, z.core.$strip>`
`OrderStatusItem`	type	`{ title: string; quantity: number; unitPrice: number; lineTotal: number; imageUrl?: string; }`
`orderStatusItemSchema`	const	`z.ZodObject<{ title: z.ZodString; imageUrl: z.ZodNullable<z.ZodString>; quantity: z.ZodNumber; unitPrice: z.ZodNumber; lineTotal: z.ZodNumber; }, z.core.$strip>`
`OrderStatusResult`	type	—
`orderStatusResultSchema`	const	—
`OrderStatusShipment`	type	`{ shippedAt: string; carrier?: string; trackingNumber?: string; trackingUrl?: string; }`
`orderStatusShipmentSchema`	const	`z.ZodObject<{ carrier: z.ZodNullable<z.ZodString>; trackingNumber: z.ZodNullable<z.ZodString>; trackingUrl: z.ZodNullable<z.ZodString>; shippedAt: z.ZodString; }, z.core.$strip>`
`OrderStatusSummary`	type	{ currencyCode: string; customerEmail?: string; discountAmount: number; emailExpected: boolean; financialStatus: "pending" \| "paid" \| "failed" \| "refunded" \| "partiallyRefunded"; items: { title: string; quantity: number; unitPrice: number; lineTotal: number; imageUrl?: string; }[]; orderNumber: string; placedAt: string; refundedAmount: number; shipments: { shippedAt: string; carrier?: string; trackingNumber?: string; trackingUrl?: string; }[]; shippingAddress?: { line1: string; city: string; postalCode: string; country: string; name?: string; line2?: string; state?: string; }; shippingAmount: number; statusToken: string; subtotalAmount: number; taxAmount: number; totalAmount: number }
`orderStatusSummarySchema`	const	—

Overview

Reference

Content, money, and orders

`content`

`ContentCollectionEntry`

`ContentEntryJsonLd`

`ContentField`

`ContentFieldWithValue`

`ContentRelatedLink`

`getContentCollection`

`getContentCollectionStaticParams`

`getContentEntryMetadata`

`getContentFields`

`getContentSitemapEntries`

`getContentSitemapXml`

`money`

`formatAmount`

`fromMajorUnitsToMinorUnits`

`fromMinorUnitsToMajorUnits`

`fromMinorUnitsToMajorUnitsString`

`orders/order-status`

`getOrderStatus`

`orders/order-status-schema`

​content

​ContentCollectionEntry

​ContentEntryJsonLd

​ContentField

​ContentFieldWithValue

​ContentRelatedLink

​getContentCollection

​getContentCollectionStaticParams

​getContentEntryMetadata

​getContentFields

​getContentSitemapEntries

​getContentSitemapXml

​money

​formatAmount

​fromMajorUnitsToMinorUnits

​fromMinorUnitsToMajorUnits

​fromMinorUnitsToMajorUnitsString

​orders/order-status

​getOrderStatus

​orders/order-status-schema

`content`

`ContentCollectionEntry`

`ContentEntryJsonLd`

`ContentField`

`ContentFieldWithValue`

`ContentRelatedLink`

`getContentCollection`

`getContentCollectionStaticParams`

`getContentEntryMetadata`

`getContentFields`

`getContentSitemapEntries`

`getContentSitemapXml`

`money`

`formatAmount`

`fromMajorUnitsToMinorUnits`

`fromMinorUnitsToMajorUnits`

`fromMinorUnitsToMajorUnitsString`

`orders/order-status`

`getOrderStatus`

`orders/order-status-schema`