Ryth Azhur
b2f990b4e5
8-expert review identified 3 bugs in shipped code (Vary header hallucination, fn/function wire key mismatch, max-age=0 defeating PSR) — all fixed with tests updated across Python and TypeScript. Added: manifest version field, affects validation, wire format convention, origin-side cache module (HMAC key derivation, MemoryCache + RedisCache backends, reverse index for scoped invalidation, executor integration). 16 known issues documented in cache/KNOWN_ISSUES.md from expert review — critical items (user_id not passed, purge race condition, no Redis error handling) to be fixed in follow-up. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
92 lines
3.2 KiB
TypeScript
92 lines
3.2 KiB
TypeScript
/**
|
|
* Edge Manifest Generator
|
|
*
|
|
* Produces the same JSON format as mizan-django. One Edge Worker.
|
|
* Two backend languages. Same manifest.
|
|
*/
|
|
|
|
import type { EdgeManifest } from './types'
|
|
import { getAllFunctions, getContextGroups, getContextParamNames } from './registry'
|
|
|
|
// Both camelCase and snake_case forms included for cross-language matching.
|
|
// Wire format is snake_case (protocol rule); camelCase is the TS-local convention.
|
|
const USER_SCOPED_PARAMS = new Set(['userId', 'user', 'ownerId', 'accountId', 'user_id', 'owner_id', 'account_id'])
|
|
|
|
export function generateManifest(baseUrl = '/api/mizan'): EdgeManifest {
|
|
const groups = getContextGroups()
|
|
const allFunctions = getAllFunctions()
|
|
const manifest: EdgeManifest = { version: 1, contexts: {}, mutations: {} }
|
|
|
|
// Contexts
|
|
for (const [ctxName, fnNames] of Object.entries(groups)) {
|
|
const paramNames = new Set<string>()
|
|
const functions: Array<{ name: string; path: 'rpc' | 'view'; route?: string; methods?: string[] }> = []
|
|
const pageRoutes: string[] = []
|
|
|
|
for (const fnName of fnNames) {
|
|
const entry = allFunctions.get(fnName)
|
|
if (!entry) continue
|
|
|
|
for (const p of entry.params) paramNames.add(p.name)
|
|
|
|
const fnEntry: any = { name: fnName, path: entry.viewPath ? 'view' : 'rpc' }
|
|
if (entry.route) {
|
|
fnEntry.route = entry.route
|
|
fnEntry.methods = entry.methods || ['GET']
|
|
pageRoutes.push(entry.route)
|
|
}
|
|
functions.push(fnEntry)
|
|
}
|
|
|
|
const sortedParams = [...paramNames].sort()
|
|
const userScoped = [...paramNames].some(p => USER_SCOPED_PARAMS.has(p))
|
|
|
|
const ctxEntry: EdgeManifest['contexts'][string] = {
|
|
functions,
|
|
endpoints: [`${baseUrl}/ctx/${ctxName}/`],
|
|
params: sortedParams,
|
|
user_scoped: userScoped,
|
|
render_strategy: userScoped ? 'dynamic_cached' : 'psr',
|
|
}
|
|
|
|
if (pageRoutes.length > 0) {
|
|
ctxEntry.page_routes = pageRoutes
|
|
}
|
|
|
|
manifest.contexts[ctxName] = ctxEntry
|
|
}
|
|
|
|
// Mutations
|
|
for (const [fnName, entry] of allFunctions) {
|
|
if (!entry.affects) continue
|
|
|
|
const affectedContexts = [...new Set(entry.affects.map(a => a.name))]
|
|
|
|
// Auto-scoped params
|
|
const fnParamNames = new Set(entry.params.map(p => p.name))
|
|
const autoScoped: string[] = []
|
|
for (const ctxName of affectedContexts) {
|
|
const ctxParams = getContextParamNames(ctxName)
|
|
for (const p of fnParamNames) {
|
|
if (ctxParams.has(p) && !autoScoped.includes(p)) {
|
|
autoScoped.push(p)
|
|
}
|
|
}
|
|
}
|
|
|
|
const mutation: EdgeManifest['mutations'][string] = {
|
|
affects: affectedContexts,
|
|
}
|
|
if (autoScoped.length > 0) mutation.auto_scoped_params = autoScoped.sort()
|
|
if (entry.private) mutation.private = true
|
|
if (entry.route) {
|
|
mutation.route = entry.route
|
|
mutation.methods = entry.methods || ['POST']
|
|
}
|
|
|
|
manifest.mutations[fnName] = mutation
|
|
}
|
|
|
|
return manifest
|
|
}
|