mizchi/sol/isr - mooncakes.io

README
U
ActionRegistry
U
ApiHandler
U
ApiResponse
U
CacheStrategy
U
PageHandler
U
PageProps
U
RawHandler
U
RouteManifestEntry
U
RouteManifestMatchKind
U
RouteManifestMethod
U
RouteManifestOwner
U
RouteOwnershipManifest
U
RouterConfig
U
SolRoutes
- ::newBundleConfig::new
- ::with_formatBundleConfig::with_format
- ::with_minifyBundleConfig::with_minify
- ::with_sourcemapBundleConfig::with_sourcemap
T
BundleResult
- ::newIslandConfig::new
- ::with_contentIslandConfig::with_content
- ::with_ssr_htmlIslandConfig::with_ssr_html
- ::with_stateIslandConfig::with_state
- ::with_state_refIslandConfig::with_state_ref
- ::with_state_urlIslandConfig::with_state_url
- ::with_triggerIslandConfig::with_trigger
T
IslandManifest
T
IslandManifestEntry
- ::to_stringOutputFormat::to_string
- ::as_anyRolldownChunk::as_any
- ::codeRolldownChunk::code
- ::file_nameRolldownChunk::file_name
- ::is_entryRolldownChunk::is_entry
- ::as_anyRolldownOutput::as_any
- ::outputRolldownOutput::output
- ::newStaticDirServeConfig::new
- ::defaultStaticFileConfig::default
- ::devStaticFileConfig::dev
- ::with_mappingStaticFileConfig::with_mapping
V
api_delete
V
api_get
V
api_patch
V
api_post
V
api_put
V
assets
V
bad_request
V
build
V
build_from_manifest
V
build_from_manifest_file
V
bundle_islands
V
bundle_islands_prod
V
bundle_islands_result
V
create_app
V
default_loader_url
V
default_wc_loader_url
V
error_response
V
forbidden
V
generate_island_manifest
V
generate_state_script
V
island
V
island_page
V
island_raw
V
island_with
V
island_with_raw
V
json_array_to_any
V
json_obj
V
json_to_any
V
nodes
V
not_found_response
V
ok
V
optional
V
optional_query
V
page
V
parse_island_manifest
V
raw_delete
V
raw_get
V
raw_patch
V
raw_post
V
raw_put
V
redirect_permanent_to
V
redirect_to
V
render_fragment
V
render_island
V
render_island_page
V
render_island_with_state_script
V
render_node
V
render_page
V
render_page_with_preloads
V
render_streaming_page
V
render_with_island_preloads
V
require
V
require_int
V
require_query
V
route
V
route_ownership_manifest
V
run
V
run_app
V
serve_default_favicon
V
serve_sol_assets
V
serve_static
V
serve_static_dir
V
server_island
V
server_island_typed
V
server_nodes
V
streaming_page
V
unauthorized
V
wc_island_raw
V
wc_island_with_raw
V
wc_page
V
with_assets
V
with_mw
V
with_script
V
with_style
V
wrap

mizchi/sol/isr does not have a README file

ISRManifest

using @mizchi/astra/isr { type ISRManifest }

ISR manifest loaded from _luna/isr.json

ISRPageMeta

source

using @mizchi/astra/isr { type ISRPageMeta }

ISR page entry from manifest

ISRCache

source

pub(open) trait ISRCache {
  fn get(Self, String) -> CacheEntry?
  fn put(Self, String, CacheEntry) -> Unit
  fn delete(Self, String) -> Unit
  fn schedule_revalidation(Self, async () -> Unit) -> Unit
}

ISR cache storage abstraction Implement this trait for different backends (Memory, KV, Redis, etc.)

CDNCacheStrategy

source

pub(all) enum CDNCacheStrategy {
  CdnSwr(Int)
  Hybrid(Int, Int)
  AppIsr
}

CDN cache strategy for ISR pages. Controls how CDN-level caching (e.g., Cloudflare async SWR) interacts with app-level ISR caching.

CDNCacheStrategy::cache_control

source

fn CDNCacheStrategy::cache_control(self : CDNCacheStrategy, revalidate : Int) -> String

Generate Cache-Control header value for a given strategy and revalidate interval.

CDNCacheStrategy::header_value

source

fn CDNCacheStrategy::header_value(self : CDNCacheStrategy) -> String

Get the X-Sol-CDN-Cache header value describing this strategy.

CacheEntry

source

pub struct CacheEntry {
  html : String
  generated_at : Int64
  revalidate : Int
}

ISR cache entry containing rendered HTML and metadata

CacheEntry::new

source

fn CacheEntry::new(html : String, generated_at : Int64, revalidate : Int) -> CacheEntry

Create a new cache entry

CacheStatus

source

pub enum CacheStatus {
  Fresh
  Stale
  Miss
}

Cache status for SWR (Stale-While-Revalidate) pattern

ISRConfig

source

pub struct ISRConfig {
  enabled : Bool
  default_revalidate : Int
}

ISR configuration

ISRConfig::default

source

fn ISRConfig::default() -> ISRConfig

Default ISR configuration

ISRHandler

source

pub struct ISRHandler[Cache] {
  cache : Cache
  manifest : @mizchi/astra/isr.ISRManifest
ISRManifest
  dist_dir : String
}

ISR handler that wraps cache and manifest

ISRHandler::handle

source

async fn[Cache : ISRCache] ISRHandler::handle(self : ISRHandler[Cache], path : String) -> (String?, Bool)

Handle ISR request Returns (html, needs_revalidation)

ISRHandler::new

source

fn[Cache] ISRHandler::new(cache : Cache, manifest : @mizchi/astra/isr.ISRManifest
ISRManifest, dist_dir : String) -> ISRHandler[Cache]

Create new ISR handler

ISRHandler::update_cache

source

fn[Cache : ISRCache] ISRHandler::update_cache(self : ISRHandler[Cache], path : String, html : String) -> Unit

Update cache after revalidation

ISRMiddlewareConfig

source

pub struct ISRMiddlewareConfig {
  dist_dir : String
  enabled : Bool
}

ISR middleware configuration

ISRMiddlewareConfig::default

source

fn ISRMiddlewareConfig::default() -> ISRMiddlewareConfig

Default ISR middleware configuration

MemoryCache

source

pub struct MemoryCache {
  store : @moonbitlang/core/ref.Ref
Ref[Map[String, CacheEntry]]
}

In-memory ISR cache implementation Suitable for development and single-instance deployments Uses Ref to ensure shared state when handler is copied

impl ISRCache for MemoryCache

fn delete(self : MemoryCache, key : String) -> Unit

source

fn get(self : MemoryCache, key : String) -> CacheEntry?

source

fn put(self : MemoryCache, key : String, entry : CacheEntry) -> Unit

source

fn schedule_revalidation(_self : MemoryCache, task : async () -> Unit) -> Unit

source

MemoryCache::new

source

fn MemoryCache::new() -> MemoryCache

Create a new empty MemoryCache

cache_key

source

fn cache_key(path : String, query : Array[(String, String)]) -> String

Generate cache key from path and query parameters Key format: "isr:{path}?{sorted_query}"

check_status

source

fn check_status(entry : CacheEntry?, now_ms : Int64) -> CacheStatus

Check cache status based on entry and current time

create_isr_middleware

source

async fn create_isr_middleware(dist_dir : String) -> ((@mizchi/npm_typed/hono.Context
Context[Unit, Unit]) -> @mizchi/js/core.Promise
Promise[Unit]?)

Create ISR handler for Hono Returns a function that can be used as Hono middleware

get_isr_handler

source

fn get_isr_handler() -> ISRHandler[MemoryCache]?

Get the global ISR handler

handle_isr_request

source

async fn handle_isr_request(path : String) -> (String?, Bool)

Handle ISR for a request path Returns Some(html) if ISR handled, None otherwise

init_isr

source

async fn init_isr(dist_dir : String) -> ISRHandler[MemoryCache]

Initialize ISR handler (call once at server startup)

load_manifest

source

async fn load_manifest(dist_dir : String) -> @mizchi/astra/isr.ISRManifest
ISRManifest

Load ISR manifest from _luna/isr.json

now_ms

source

fn now_ms() -> Int64

Get current time in milliseconds (Unix timestamp).

schedule_revalidation

source

fn schedule_revalidation(path : String) -> Unit

Schedule background revalidation for a path

Source Files

Site source Report issue Packages Build queue Skills Statistics

#ISRManifest

#ISRPageMeta

#ISRCache

#CDNCacheStrategy

#CDNCacheStrategy::cache_control

#CDNCacheStrategy::header_value

#CacheEntry

#CacheEntry::new

#CacheStatus

#ISRConfig

#ISRConfig::default

#ISRHandler

#ISRHandler::handle

#ISRHandler::new

#ISRHandler::update_cache

#ISRMiddlewareConfig

#ISRMiddlewareConfig::default

#MemoryCache

#MemoryCache::new

#cache_key

#check_status

#create_isr_middleware

#get_isr_handler

#handle_isr_request

#init_isr

#load_manifest

#now_ms

#schedule_revalidation

Source Files

ISRManifest

ISRPageMeta

ISRCache

CDNCacheStrategy

CDNCacheStrategy::cache_control

CDNCacheStrategy::header_value

CacheEntry

CacheEntry::new

CacheStatus

ISRConfig

ISRConfig::default

ISRHandler

ISRHandler::handle

ISRHandler::new

ISRHandler::update_cache

ISRMiddlewareConfig

ISRMiddlewareConfig::default

MemoryCache

MemoryCache::new

cache_key

check_status

create_isr_middleware

get_isr_handler

handle_isr_request

init_isr

load_manifest

now_ms

schedule_revalidation