[{"data":1,"prerenderedAt":2268},["ShallowReactive",2],{"navigation":3,"\u002Fextensions\u002Froutes-and-writes":340,"\u002Fextensions\u002Froutes-and-writes-surround":2263},{"3.x":4,"2.x":236},[5,32,61,103,125,151,169,207],{"title":6,"icon":7,"path":8,"stem":9,"children":10,"page":31},"Getting Started","i-heroicons-star","\u002Fgetting-started","1.getting-started",[11,15,19,23,27],{"title":12,"path":13,"stem":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":16,"path":17,"stem":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":20,"path":21,"stem":22},"Quick start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":24,"path":25,"stem":26},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F4.configuration",{"title":28,"path":29,"stem":30},"Upgrade guide","\u002Fgetting-started\u002Fupgrade-guide","1.getting-started\u002F5.upgrade-guide",false,{"title":33,"icon":34,"path":35,"stem":36,"children":37,"page":31},"Resources","i-heroicons-document-text","\u002Fresources","2.resources",[38,41,45,49,53,57],{"title":33,"path":39,"stem":40},"\u002Fresources\u002Fresources","2.resources\u002F1.resources",{"title":42,"path":43,"stem":44},"Fields","\u002Fresources\u002Ffields","2.resources\u002F2.fields",{"title":46,"path":47,"stem":48},"Relationships","\u002Fresources\u002Frelations","2.resources\u002F3.relations",{"title":50,"path":51,"stem":52},"Validation","\u002Fresources\u002Fvalidation","2.resources\u002F4.validation",{"title":54,"path":55,"stem":56},"Perimeter","\u002Fresources\u002Fperimeter","2.resources\u002F5.perimeter",{"title":58,"path":59,"stem":60},"Limits","\u002Fresources\u002Flimits","2.resources\u002F6.limits",{"title":62,"icon":63,"path":64,"stem":65,"children":66,"page":31},"Search","i-heroicons-magnifying-glass","\u002Fsearch","3.search",[67,71,75,79,83,87,91,95,99],{"title":68,"path":69,"stem":70},"Search overview","\u002Fsearch\u002Foverview","3.search\u002F1.overview",{"title":72,"path":73,"stem":74},"Search filters","\u002Fsearch\u002Ffilters","3.search\u002F2.filters",{"title":76,"path":77,"stem":78},"Sorts and selects","\u002Fsearch\u002Fsorts-and-selects","3.search\u002F3.sorts-and-selects",{"title":80,"path":81,"stem":82},"Includes and aggregates","\u002Fsearch\u002Fincludes-and-aggregates","3.search\u002F4.includes-and-aggregates",{"title":84,"path":85,"stem":86},"Scopes and instructions","\u002Fsearch\u002Fscopes-and-instructions","3.search\u002F5.scopes-and-instructions",{"title":88,"path":89,"stem":90},"Text search","\u002Fsearch\u002Ftext-search","3.search\u002F6.text-search",{"title":92,"path":93,"stem":94},"Search engines","\u002Fsearch\u002Fsearch-engines","3.search\u002F7.search-engines",{"title":96,"path":97,"stem":98},"Searching outside HTTP","\u002Fsearch\u002Foutside-http","3.search\u002F8.outside-http",{"title":100,"path":101,"stem":102},"Totals","\u002Fsearch\u002Ftotals","3.search\u002F9.totals",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":31},"Writing","i-heroicons-pencil-square","\u002Fwriting","4.writing",[109,113,117,121],{"title":110,"path":111,"stem":112},"Mutate","\u002Fwriting\u002Fmutate","4.writing\u002F1.mutate",{"title":114,"path":115,"stem":116},"Writing relations","\u002Fwriting\u002Frelations","4.writing\u002F2.relations",{"title":118,"path":119,"stem":120},"Versioned rows","\u002Fwriting\u002Fversioned-rows","4.writing\u002F3.versioned-rows",{"title":122,"path":123,"stem":124},"Deleting and restoring","\u002Fwriting\u002Fdeleting","4.writing\u002F4.deleting",{"title":126,"icon":127,"path":128,"stem":129,"children":130,"page":31},"Actions and Metrics","i-heroicons-bolt","\u002Factions-and-metrics","5.actions-and-metrics",[131,135,139,143,147],{"title":132,"path":133,"stem":134},"Actions","\u002Factions-and-metrics\u002Factions","5.actions-and-metrics\u002F1.actions",{"title":136,"path":137,"stem":138},"Queued Actions","\u002Factions-and-metrics\u002Fqueued-actions","5.actions-and-metrics\u002F2.queued-actions",{"title":140,"path":141,"stem":142},"Confirmation","\u002Factions-and-metrics\u002Fconfirmation","5.actions-and-metrics\u002F3.confirmation",{"title":144,"path":145,"stem":146},"Metrics","\u002Factions-and-metrics\u002Fmetrics","5.actions-and-metrics\u002F4.metrics",{"title":148,"path":149,"stem":150},"Exports","\u002Factions-and-metrics\u002Fexports","5.actions-and-metrics\u002F5.exports",{"title":152,"icon":153,"path":154,"stem":155,"children":156,"page":31},"Authorization","i-heroicons-lock-closed","\u002Fauthorization","6.authorization",[157,161,165],{"title":158,"path":159,"stem":160},"Policies","\u002Fauthorization\u002Fpolicies","6.authorization\u002F1.policies",{"title":162,"path":163,"stem":164},"Gates","\u002Fauthorization\u002Fgates","6.authorization\u002F2.gates",{"title":166,"path":167,"stem":168},"Decision Cache","\u002Fauthorization\u002Fdecision-cache","6.authorization\u002F3.decision-cache",{"title":170,"icon":171,"path":172,"stem":173,"children":174,"page":31},"Digging Deeper","i-heroicons-list-bullet","\u002Fdigging-deeper","7.digging-deeper",[175,179,183,187,191,195,199,203],{"title":176,"path":177,"stem":178},"Details","\u002Fdigging-deeper\u002Fdetails","7.digging-deeper\u002F1.details",{"title":180,"path":181,"stem":182},"Events and Hooks","\u002Fdigging-deeper\u002Fevents-and-hooks","7.digging-deeper\u002F2.events-and-hooks",{"title":184,"path":185,"stem":186},"Custom Responses","\u002Fdigging-deeper\u002Fresponses","7.digging-deeper\u002F3.responses",{"title":188,"path":189,"stem":190},"OpenAPI Documentation","\u002Fdigging-deeper\u002Fopenapi","7.digging-deeper\u002F4.openapi",{"title":192,"path":193,"stem":194},"Precognition","\u002Fdigging-deeper\u002Fprecognition","7.digging-deeper\u002F5.precognition",{"title":196,"path":197,"stem":198},"Artisan Commands","\u002Fdigging-deeper\u002Fartisan","7.digging-deeper\u002F6.artisan",{"title":200,"path":201,"stem":202},"Use with AI","\u002Fdigging-deeper\u002Fai-skill","7.digging-deeper\u002F7.ai-skill",{"title":204,"path":205,"stem":206},"Translations","\u002Fdigging-deeper\u002Ftranslations","7.digging-deeper\u002F8.translations",{"title":208,"icon":209,"path":210,"stem":211,"children":212,"page":31},"Extensions","i-heroicons-puzzle-piece","\u002Fextensions","8.extensions",[213,216,220,224,228,232],{"title":208,"path":214,"stem":215},"\u002Fextensions\u002Foverview","8.extensions\u002F1.overview",{"title":217,"path":218,"stem":219},"Query extensions","\u002Fextensions\u002Fqueries","8.extensions\u002F2.queries",{"title":221,"path":222,"stem":223},"Engine extensions","\u002Fextensions\u002Fengines","8.extensions\u002F3.engines",{"title":225,"path":226,"stem":227},"Authorization extensions","\u002Fextensions\u002Fauthorization","8.extensions\u002F4.authorization",{"title":229,"path":230,"stem":231},"Route and write extensions","\u002Fextensions\u002Froutes-and-writes","8.extensions\u002F5.routes-and-writes",{"title":233,"path":234,"stem":235},"Response and check extensions","\u002Fextensions\u002Fresponses-and-checks","8.extensions\u002F6.responses-and-checks",[237,248,270,293,330],{"title":6,"icon":7,"path":238,"stem":239,"children":240,"page":31},"\u002F2.x\u002Fgetting-started","2.x\u002F1.getting-started",[241,244],{"title":16,"path":242,"stem":243},"\u002F2.x\u002Fgetting-started\u002Finstallation","2.x\u002F1.getting-started\u002F1.installation",{"title":245,"path":246,"stem":247},"Upgrade Guide","\u002F2.x\u002Fgetting-started\u002Fupgrade-guide","2.x\u002F1.getting-started\u002F2.upgrade-guide",{"title":249,"icon":250,"path":251,"stem":252,"children":253,"page":31},"Endpoints","i-heroicons-arrow-uturn-left","\u002F2.x\u002Fendpoints","2.x\u002F2.endpoints",[254,257,260,263,266],{"title":176,"path":255,"stem":256},"\u002F2.x\u002Fendpoints\u002Fdetails","2.x\u002F2.endpoints\u002F1.details",{"title":62,"path":258,"stem":259},"\u002F2.x\u002Fendpoints\u002Fsearch","2.x\u002F2.endpoints\u002F2.search",{"title":110,"path":261,"stem":262},"\u002F2.x\u002Fendpoints\u002Fmutate","2.x\u002F2.endpoints\u002F3.mutate",{"title":132,"path":264,"stem":265},"\u002F2.x\u002Fendpoints\u002Factions","2.x\u002F2.endpoints\u002F4.actions",{"title":267,"path":268,"stem":269},"Delete","\u002F2.x\u002Fendpoints\u002Fdelete","2.x\u002F2.endpoints\u002F5.delete",{"title":33,"icon":34,"path":271,"stem":272,"children":273,"page":31},"\u002F2.x\u002Fresources","2.x\u002F3.resources",[274,278,282,285,289],{"title":275,"path":276,"stem":277},"Basics","\u002F2.x\u002Fresources\u002Fbasics","2.x\u002F3.resources\u002F1.basics",{"title":279,"path":280,"stem":281},"Exposed Data","\u002F2.x\u002Fresources\u002Fexposed-data","2.x\u002F3.resources\u002F2.exposed-data",{"title":46,"path":283,"stem":284},"\u002F2.x\u002Fresources\u002Frelationships","2.x\u002F3.resources\u002F3.relationships",{"title":286,"path":287,"stem":288},"Validations","\u002F2.x\u002Fresources\u002Fvalidations","2.x\u002F3.resources\u002F4.validations",{"title":290,"path":291,"stem":292},"Interactions","\u002F2.x\u002Fresources\u002Finteractions","2.x\u002F3.resources\u002F5.interactions",{"title":170,"icon":171,"path":294,"stem":295,"children":296,"page":31},"\u002F2.x\u002Fdigging-deeper","2.x\u002F4.digging-deeper",[297,300,304,307,311,315,319,323,327],{"title":132,"path":298,"stem":299},"\u002F2.x\u002Fdigging-deeper\u002Factions","2.x\u002F4.digging-deeper\u002F1.actions",{"title":301,"path":302,"stem":303},"Hooks","\u002F2.x\u002Fdigging-deeper\u002Fhooks","2.x\u002F4.digging-deeper\u002F2.hooks",{"title":162,"path":305,"stem":306},"\u002F2.x\u002Fdigging-deeper\u002Fgates","2.x\u002F4.digging-deeper\u002F3.gates",{"title":308,"path":309,"stem":310},"Authorizations","\u002F2.x\u002Fdigging-deeper\u002Fauthorizations","2.x\u002F4.digging-deeper\u002F4.authorizations",{"title":312,"path":313,"stem":314},"Full Text Search","\u002F2.x\u002Fdigging-deeper\u002Ffull-text-search","2.x\u002F4.digging-deeper\u002F5.full-text-search",{"title":316,"path":317,"stem":318},"Instructions","\u002F2.x\u002Fdigging-deeper\u002Finstructions","2.x\u002F4.digging-deeper\u002F6.instructions",{"title":320,"path":321,"stem":322},"Responses","\u002F2.x\u002Fdigging-deeper\u002Fresponses","2.x\u002F4.digging-deeper\u002F7.responses",{"title":324,"path":325,"stem":326},"Documentation","\u002F2.x\u002Fdigging-deeper\u002Fdocumentation","2.x\u002F4.digging-deeper\u002F8.documentation",{"title":192,"path":328,"stem":329},"\u002F2.x\u002Fdigging-deeper\u002Fprecognition","2.x\u002F4.digging-deeper\u002F9.precognition",{"title":331,"icon":332,"path":333,"stem":334,"children":335,"page":31},"Integrations","i-lucide-puzzle","\u002F2.x\u002Fintegrations","2.x\u002F5.integrations",[336],{"title":337,"path":338,"stem":339},"Flutter","\u002F2.x\u002Fintegrations\u002Fflutter","2.x\u002F5.integrations\u002F1.flutter",{"id":341,"title":229,"body":342,"description":2255,"extension":2256,"links":2257,"meta":2258,"navigation":508,"path":230,"seo":2259,"sitemap":2260,"stem":231,"updatedAt":2261,"__hash__":2262},"docs3x\u002F8.extensions\u002F5.routes-and-writes.md",{"type":343,"value":344,"toc":2245},"minimark",[345,369,374,380,712,781,795,812,816,822,1116,1149,1244,1249,1334,1338,1341,1392,1397,1401,1441,1445,1451,1745,1827,1856,1860,1869,2139,2201,2241],[346,347,348,349,353,354,353,357,360,361,364,365,368],"p",{},"Four kinds act on routes, writes and reads: ",[350,351,352],"code",{},"AddsRouteMiddleware",", ",[350,355,356],{},"GuardsWrites",[350,358,359],{},"ObservesWrites"," and ",[350,362,363],{},"ObservesReads",". See ",[366,367,208],"a",{"href":214}," for registering an extension.",[370,371,373],"h2",{"id":372},"adding-route-middleware","Adding route middleware",[346,375,376,379],{},[350,377,378],{},"AddsRouteMiddleware::routeMiddleware(RouteMiddlewareContext $context)"," returns middleware for the routes of an endpoint:",[381,382,388],"pre",{"className":383,"code":384,"filename":385,"language":386,"meta":387,"style":387},"language-php shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","use Lomkit\\Rest\\Extensions\\Contexts\\RouteMiddlewareContext;\nuse Lomkit\\Rest\\Extensions\\Extension;\nuse Lomkit\\Rest\\Extensions\\Kinds\\AddsRouteMiddleware;\nuse Lomkit\\Rest\\Http\\Routing\\Endpoint;\n\nfinal class PlanRoutesExtension extends Extension implements AddsRouteMiddleware\n{\n    #[\\Override]\n    public static function name(): string\n    {\n        return 'plans';\n    }\n\n    #[\\Override]\n    public function routeMiddleware(RouteMiddlewareContext $context): array\n    {\n        return $context->endpoint === Endpoint::Search ? ['throttle:searches'] : [];\n    }\n}\n","Vendor\u002FPlans\u002FPlanRoutesExtension.php","php","",[350,389,390,427,449,475,503,510,536,542,553,575,581,600,606,611,620,647,652,701,706],{"__ignoreMap":387},[391,392,395,399,403,407,410,412,414,416,419,421,424],"span",{"class":393,"line":394},"line",1,[391,396,398],{"class":397},"sbssI","use",[391,400,402],{"class":401},"sTEyZ"," Lomkit",[391,404,406],{"class":405},"sMK4o","\\",[391,408,409],{"class":401},"Rest",[391,411,406],{"class":405},[391,413,208],{"class":401},[391,415,406],{"class":405},[391,417,418],{"class":401},"Contexts",[391,420,406],{"class":405},[391,422,423],{"class":401},"RouteMiddlewareContext",[391,425,426],{"class":405},";\n",[391,428,430,432,434,436,438,440,442,444,447],{"class":393,"line":429},2,[391,431,398],{"class":397},[391,433,402],{"class":401},[391,435,406],{"class":405},[391,437,409],{"class":401},[391,439,406],{"class":405},[391,441,208],{"class":401},[391,443,406],{"class":405},[391,445,446],{"class":401},"Extension",[391,448,426],{"class":405},[391,450,452,454,456,458,460,462,464,466,469,471,473],{"class":393,"line":451},3,[391,453,398],{"class":397},[391,455,402],{"class":401},[391,457,406],{"class":405},[391,459,409],{"class":401},[391,461,406],{"class":405},[391,463,208],{"class":401},[391,465,406],{"class":405},[391,467,468],{"class":401},"Kinds",[391,470,406],{"class":405},[391,472,352],{"class":401},[391,474,426],{"class":405},[391,476,478,480,482,484,486,488,491,493,496,498,501],{"class":393,"line":477},4,[391,479,398],{"class":397},[391,481,402],{"class":401},[391,483,406],{"class":405},[391,485,409],{"class":401},[391,487,406],{"class":405},[391,489,490],{"class":401},"Http",[391,492,406],{"class":405},[391,494,495],{"class":401},"Routing",[391,497,406],{"class":405},[391,499,500],{"class":401},"Endpoint",[391,502,426],{"class":405},[391,504,506],{"class":393,"line":505},5,[391,507,509],{"emptyLinePlaceholder":508},true,"\n",[391,511,513,517,520,524,527,530,533],{"class":393,"line":512},6,[391,514,516],{"class":515},"spNyl","final",[391,518,519],{"class":515}," class",[391,521,523],{"class":522},"sBMFI"," PlanRoutesExtension",[391,525,526],{"class":515}," extends",[391,528,529],{"class":522}," Extension",[391,531,532],{"class":515}," implements",[391,534,535],{"class":522}," AddsRouteMiddleware\n",[391,537,539],{"class":393,"line":538},7,[391,540,541],{"class":405},"{\n",[391,543,545,548,550],{"class":393,"line":544},8,[391,546,547],{"class":401},"    #[",[391,549,406],{"class":405},[391,551,552],{"class":401},"Override]\n",[391,554,556,559,562,565,569,572],{"class":393,"line":555},9,[391,557,558],{"class":515},"    public",[391,560,561],{"class":515}," static",[391,563,564],{"class":515}," function",[391,566,568],{"class":567},"s2Zo4"," name",[391,570,571],{"class":405},"():",[391,573,574],{"class":397}," string\n",[391,576,578],{"class":393,"line":577},10,[391,579,580],{"class":405},"    {\n",[391,582,584,588,591,595,598],{"class":393,"line":583},11,[391,585,587],{"class":586},"s7zQu","        return",[391,589,590],{"class":405}," '",[391,592,594],{"class":593},"sfazB","plans",[391,596,597],{"class":405},"'",[391,599,426],{"class":405},[391,601,603],{"class":393,"line":602},12,[391,604,605],{"class":405},"    }\n",[391,607,609],{"class":393,"line":608},13,[391,610,509],{"emptyLinePlaceholder":508},[391,612,614,616,618],{"class":393,"line":613},14,[391,615,547],{"class":401},[391,617,406],{"class":405},[391,619,552],{"class":401},[391,621,623,625,627,630,633,635,638,641,644],{"class":393,"line":622},15,[391,624,558],{"class":515},[391,626,564],{"class":515},[391,628,629],{"class":567}," routeMiddleware",[391,631,632],{"class":405},"(",[391,634,423],{"class":522},[391,636,637],{"class":405}," $",[391,639,640],{"class":401},"context",[391,642,643],{"class":405},"):",[391,645,646],{"class":397}," array\n",[391,648,650],{"class":393,"line":649},16,[391,651,580],{"class":405},[391,653,655,657,659,661,664,667,670,673,676,679,682,685,687,690,692,695,698],{"class":393,"line":654},17,[391,656,587],{"class":586},[391,658,637],{"class":405},[391,660,640],{"class":401},[391,662,663],{"class":405},"->",[391,665,666],{"class":401},"endpoint ",[391,668,669],{"class":405},"===",[391,671,672],{"class":522}," Endpoint",[391,674,675],{"class":405},"::",[391,677,678],{"class":401},"Search ",[391,680,681],{"class":405},"?",[391,683,684],{"class":405}," [",[391,686,597],{"class":405},[391,688,689],{"class":593},"throttle:searches",[391,691,597],{"class":405},[391,693,694],{"class":405},"]",[391,696,697],{"class":405}," :",[391,699,700],{"class":405}," [];\n",[391,702,704],{"class":393,"line":703},18,[391,705,605],{"class":405},[391,707,709],{"class":393,"line":708},19,[391,710,711],{"class":405},"}\n",[713,714,715,732,735,749,764,774],"ul",{},[716,717,718,719,353,722,353,725,360,728,731],"li",{},"It receives ",[350,720,721],{},"$context->resource",[350,723,724],{},"$context->endpoint",[350,726,727],{},"$context->controller",[350,729,730],{},"$context->routeName",", no user, once per endpoint when the routes register.",[716,733,734],{},"Its middleware comes after the package, resource and endpoint middleware and before the middleware of an action or a metric, in extension name order, each middleware once. The routes of the actions and metrics of an endpoint get it too.",[716,736,737,738,353,741,744,745,748],{},"An extension can only add. ",[350,739,740],{},"withoutMiddleware()",[350,742,743],{},"withoutMiddlewareFor()"," and the ",[350,746,747],{},"$withoutMiddleware"," of an action still remove its middleware.",[716,750,751,752,755,756,759,760,763],{},"An ",[350,753,754],{},"auth"," middleware that it adds makes the OpenAPI document list the ",[350,757,758],{},"401",", and ",[350,761,762],{},"rest:check"," counts the route as authenticated.",[716,765,766,767,769,770,773],{},"Use a named limiter, such as ",[350,768,689],{},": two unnamed ",[350,771,772],{},"throttle"," middleware count each request twice. Route middleware also runs on Precognition requests.",[716,775,776,777,780],{},"A list item that is not a non-empty string throws ",[350,778,779],{},"Lomkit\\Rest\\Exceptions\\InvalidRouteExtensionException",", which names the extension, the resource and the endpoint.",[782,783,784],"warning",{},[346,785,786,787,790,791,794],{},"The middleware is written into the routes when they register. Run ",[350,788,789],{},"php artisan route:cache"," again after you add, remove or change an extension. A test suite with ",[350,792,793],{},"WithCachedRoutes"," keeps the middleware of its first test: a test that configures other extensions extends a base test case without the trait.",[346,796,797,798,801,802,805,806,808,809,811],{},"When the routes register, the package builds only the enabled extensions whose class implements this kind or is bound in the container, once for all ",[350,799,800],{},"Rest::resource()"," calls, and skips the classes of ",[350,803,804],{},"disabled_extensions",". The name of any other entry is not read there, so an invalid extension of another kind does not stop the routes, migrations or ",[350,807,762],{},": the request that needs it refuses it. An invalid ",[350,810,352],{}," class, or a name that two of these classes share, stops the registration. Keep the constructors of route extensions light.",[370,813,815],{"id":814},"refusing-writes","Refusing writes",[346,817,818,821],{},[350,819,820],{},"GuardsWrites::guardWrite(WriteGuardContext $context)"," can refuse a write:",[381,823,826],{"className":383,"code":824,"filename":825,"language":386,"meta":387,"style":387},"use Lomkit\\Rest\\Extensions\\Contexts\\WriteGuardContext;\nuse Lomkit\\Rest\\Extensions\\Extension;\nuse Lomkit\\Rest\\Extensions\\Kinds\\GuardsWrites;\n\nfinal class WriteQuotaExtension extends Extension implements GuardsWrites\n{\n    public function __construct(private readonly WriteQuota $quota) {}\n\n    #[\\Override]\n    public static function name(): string\n    {\n        return 'write_quota';\n    }\n\n    #[\\Override]\n    public function guardWrite(WriteGuardContext $context): void\n    {\n        if ($this->quota->exhausted($context->user)) {\n            $context->refuse('The monthly quota is reached.', 429);\n        }\n    }\n}\n","Vendor\u002FPlans\u002FWriteQuotaExtension.php",[350,827,828,853,873,897,901,919,923,954,958,966,980,984,997,1001,1005,1013,1035,1039,1070,1100,1106,1111],{"__ignoreMap":387},[391,829,830,832,834,836,838,840,842,844,846,848,851],{"class":393,"line":394},[391,831,398],{"class":397},[391,833,402],{"class":401},[391,835,406],{"class":405},[391,837,409],{"class":401},[391,839,406],{"class":405},[391,841,208],{"class":401},[391,843,406],{"class":405},[391,845,418],{"class":401},[391,847,406],{"class":405},[391,849,850],{"class":401},"WriteGuardContext",[391,852,426],{"class":405},[391,854,855,857,859,861,863,865,867,869,871],{"class":393,"line":429},[391,856,398],{"class":397},[391,858,402],{"class":401},[391,860,406],{"class":405},[391,862,409],{"class":401},[391,864,406],{"class":405},[391,866,208],{"class":401},[391,868,406],{"class":405},[391,870,446],{"class":401},[391,872,426],{"class":405},[391,874,875,877,879,881,883,885,887,889,891,893,895],{"class":393,"line":451},[391,876,398],{"class":397},[391,878,402],{"class":401},[391,880,406],{"class":405},[391,882,409],{"class":401},[391,884,406],{"class":405},[391,886,208],{"class":401},[391,888,406],{"class":405},[391,890,468],{"class":401},[391,892,406],{"class":405},[391,894,356],{"class":401},[391,896,426],{"class":405},[391,898,899],{"class":393,"line":477},[391,900,509],{"emptyLinePlaceholder":508},[391,902,903,905,907,910,912,914,916],{"class":393,"line":505},[391,904,516],{"class":515},[391,906,519],{"class":515},[391,908,909],{"class":522}," WriteQuotaExtension",[391,911,526],{"class":515},[391,913,529],{"class":522},[391,915,532],{"class":515},[391,917,918],{"class":522}," GuardsWrites\n",[391,920,921],{"class":393,"line":512},[391,922,541],{"class":405},[391,924,925,927,929,932,934,937,940,943,945,948,951],{"class":393,"line":538},[391,926,558],{"class":515},[391,928,564],{"class":515},[391,930,931],{"class":567}," __construct",[391,933,632],{"class":405},[391,935,936],{"class":515},"private",[391,938,939],{"class":515}," readonly",[391,941,942],{"class":522}," WriteQuota",[391,944,637],{"class":405},[391,946,947],{"class":401},"quota",[391,949,950],{"class":405},")",[391,952,953],{"class":405}," {}\n",[391,955,956],{"class":393,"line":544},[391,957,509],{"emptyLinePlaceholder":508},[391,959,960,962,964],{"class":393,"line":555},[391,961,547],{"class":401},[391,963,406],{"class":405},[391,965,552],{"class":401},[391,967,968,970,972,974,976,978],{"class":393,"line":577},[391,969,558],{"class":515},[391,971,561],{"class":515},[391,973,564],{"class":515},[391,975,568],{"class":567},[391,977,571],{"class":405},[391,979,574],{"class":397},[391,981,982],{"class":393,"line":583},[391,983,580],{"class":405},[391,985,986,988,990,993,995],{"class":393,"line":602},[391,987,587],{"class":586},[391,989,590],{"class":405},[391,991,992],{"class":593},"write_quota",[391,994,597],{"class":405},[391,996,426],{"class":405},[391,998,999],{"class":393,"line":608},[391,1000,605],{"class":405},[391,1002,1003],{"class":393,"line":613},[391,1004,509],{"emptyLinePlaceholder":508},[391,1006,1007,1009,1011],{"class":393,"line":622},[391,1008,547],{"class":401},[391,1010,406],{"class":405},[391,1012,552],{"class":401},[391,1014,1015,1017,1019,1022,1024,1026,1028,1030,1032],{"class":393,"line":649},[391,1016,558],{"class":515},[391,1018,564],{"class":515},[391,1020,1021],{"class":567}," guardWrite",[391,1023,632],{"class":405},[391,1025,850],{"class":522},[391,1027,637],{"class":405},[391,1029,640],{"class":401},[391,1031,643],{"class":405},[391,1033,1034],{"class":397}," void\n",[391,1036,1037],{"class":393,"line":654},[391,1038,580],{"class":405},[391,1040,1041,1044,1047,1049,1051,1054,1057,1059,1061,1064,1067],{"class":393,"line":703},[391,1042,1043],{"class":586},"        if",[391,1045,1046],{"class":405}," ($this->",[391,1048,947],{"class":401},[391,1050,663],{"class":405},[391,1052,1053],{"class":567},"exhausted",[391,1055,1056],{"class":405},"($",[391,1058,640],{"class":401},[391,1060,663],{"class":405},[391,1062,1063],{"class":401},"user",[391,1065,1066],{"class":405},"))",[391,1068,1069],{"class":405}," {\n",[391,1071,1072,1075,1077,1079,1082,1084,1086,1089,1091,1094,1097],{"class":393,"line":708},[391,1073,1074],{"class":405},"            $",[391,1076,640],{"class":401},[391,1078,663],{"class":405},[391,1080,1081],{"class":567},"refuse",[391,1083,632],{"class":405},[391,1085,597],{"class":405},[391,1087,1088],{"class":593},"The monthly quota is reached.",[391,1090,597],{"class":405},[391,1092,1093],{"class":405},",",[391,1095,1096],{"class":397}," 429",[391,1098,1099],{"class":405},");\n",[391,1101,1103],{"class":393,"line":1102},20,[391,1104,1105],{"class":405},"        }\n",[391,1107,1109],{"class":393,"line":1108},21,[391,1110,605],{"class":405},[391,1112,1114],{"class":393,"line":1113},22,[391,1115,711],{"class":405},[381,1117,1122],{"className":1118,"code":1119,"filename":1120,"language":1121,"meta":387,"style":387},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\"message\": \"The monthly quota is reached.\"}\n","429 Too Many Requests","json",[350,1123,1124],{"__ignoreMap":387},[391,1125,1126,1129,1132,1135,1137,1140,1143,1145,1147],{"class":393,"line":394},[391,1127,1128],{"class":405},"{",[391,1130,1131],{"class":405},"\"",[391,1133,1134],{"class":515},"message",[391,1136,1131],{"class":405},[391,1138,1139],{"class":405},":",[391,1141,1142],{"class":405}," \"",[391,1144,1088],{"class":593},[391,1146,1131],{"class":405},[391,1148,711],{"class":405},[713,1150,1151,1165,1205,1225,1228],{},[716,1152,1153,1156,1157,1160,1161,1164],{},[350,1154,1155],{},"refuse($message, $status = 403, $headers = [])"," rolls the transaction back and does not run it again: nothing is written and no write event is dispatched. The client gets ",[350,1158,1159],{},"{\"message\": \"...\"}"," with the status and the headers, such as ",[350,1162,1163],{},"$context->refuse('The archive is under maintenance.', 503, ['Retry-After' => '600'])",".",[716,1166,1167,1168,1171,1172,1175,1176,1179,1180,1183,1184,1187,1188,1191,1192,353,1195,360,1198,1201,1202,1164],{},"The status is ",[350,1169,1170],{},"403",", another client error status from ",[350,1173,1174],{},"400"," to ",[350,1177,1178],{},"499",", such as ",[350,1181,1182],{},"423"," or ",[350,1185,1186],{},"429",", or ",[350,1189,1190],{},"503",". ",[350,1193,1194],{},"409",[350,1196,1197],{},"422",[350,1199,1200],{},"428",", which the package answers with another body, and any other status throw ",[350,1203,1204],{},"Lomkit\\Rest\\Exceptions\\InvalidWriteExtensionException",[716,1206,1207,1210,1211,1191,1214,1217,1218,1221,1222],{},[350,1208,1209],{},"refuse()"," throws ",[350,1212,1213],{},"Lomkit\\Rest\\Exceptions\\WriteRefused",[350,1215,1216],{},"$extension"," holds the extension name and ",[350,1219,1220],{},"$reason"," the text of the client. Its exception message is ",[350,1223,1224],{},"The [write_quota] extension refused the write.",[716,1226,1227],{},"Extensions run in name order, and the first refusal answers.",[716,1229,1230,1231,1233,1234,1237,1238,1164],{},"A ",[350,1232,1170],{}," already matches the documented ",[350,1235,1236],{},"RestForbidden",". Document another status with ",[366,1239,1241],{"href":1240},"\u002Fextensions\u002Fresponses-and-checks#documenting-an-extension",[350,1242,1243],{},"DocumentsExtension",[1245,1246,1248],"h3",{"id":1247},"the-context","The context",[1250,1251,1252,1265],"table",{},[1253,1254,1255],"thead",{},[1256,1257,1258,1262],"tr",{},[1259,1260,1261],"th",{},"Property",[1259,1263,1264],{},"Value",[1266,1267,1268,1290,1308,1318],"tbody",{},[1256,1269,1270,1280],{},[1271,1272,1273,353,1275,353,1277],"td",{},[350,1274,721],{},[350,1276,724],{},[350,1278,1279],{},"$context->user",[1271,1281,1282,1283,1285,1286,1289],{},"The resource, the ",[350,1284,500],{}," and the user, ",[350,1287,1288],{},"null"," for a guest, the user of the job in a worker",[1256,1291,1292,1297],{},[1271,1293,1294],{},[350,1295,1296],{},"$context->entries",[1271,1298,1299,1300,1303,1304,1307],{},"The ",[350,1301,1302],{},"MutationNode"," list of a ",[350,1305,1306],{},"mutate"," that write or link rows of the resource",[1256,1309,1310,1315],{},[1271,1311,1312],{},[350,1313,1314],{},"$context->rows",[1271,1316,1317],{},"Copies of the stored rows of the transaction: the rows of the chunk for an action",[1256,1319,1320,1328],{},[1271,1321,1322,353,1325],{},[350,1323,1324],{},"$context->action",[350,1326,1327],{},"$context->fields",[1271,1329,1330,1331],{},"The action and its ",[350,1332,1333],{},"ActionFields",[1245,1335,1337],{"id":1336},"when-it-runs","When it runs",[346,1339,1340],{},"It runs at the head of each write transaction, after the entry checks, the row checks and the confirmation:",[713,1342,1343,1356,1371,1389],{},[716,1344,1345,1347,1348,1351,1352,1355],{},[350,1346,1306],{},": before ",[350,1349,1350],{},"mutatingAll()",", once for each resource that the request reaches, the resource of the endpoint first, with the entries and stored rows of that resource, the rows that a ",[350,1353,1354],{},"sync"," detaches included. An extension that applies only to a related resource refuses a nested write too.",[716,1357,1358,353,1361,360,1364,1347,1367,1370],{},[350,1359,1360],{},"destroy",[350,1362,1363],{},"restore",[350,1365,1366],{},"forceDestroy",[350,1368,1369],{},"destroyingAll()"," and its twins.",[716,1372,1373,1374,1377,1378,1381,1382,1385,1386,1164],{},"An action: at the head of each transaction, each chunk, or each row with ",[350,1375,1376],{},"ActionTransaction::Row",", in the request or in the queued worker; before each chunk of a ",[350,1379,1380],{},"Whole"," run, inside its transaction; before each ",[350,1383,1384],{},"handle()"," with ",[350,1387,1388],{},"ActionTransaction::None",[716,1390,1391],{},"Never under Precognition.",[346,1393,1394,1395,1164],{},"The link checks of a row that a mutation creates need its key and run later, so a refusal answers before their ",[350,1396,1170],{},[1245,1398,1400],{"id":1399},"rules","Rules",[713,1402,1403,1406,1417,1432],{},[716,1404,1405],{},"No side effects. A deadlock retry runs the guard again with a new context: it reads and decides, and writes nothing.",[716,1407,1408,1409,1412,1413,1416],{},"The rows are copies that the package never saves, but ",[350,1410,1411],{},"save()"," on a copy writes it. They can hold columns that the response does not render, such as the columns of fields that ",[350,1414,1415],{},"NarrowsFields"," hides: keep them out of what the extension sends elsewhere.",[716,1418,1419,1420,1422,1423,1425,1426,353,1428,1431],{},"The chunks or rows of an action committed before a refusal stay written, and so do the ",[350,1421,1384],{}," calls that ran before it with ",[350,1424,1388],{},". With ",[350,1427,1376],{},[350,1429,1430],{},"beforeRow()"," runs before the guard, outside the transaction.",[716,1433,1434,1435,364,1438,1164],{},"A queued action is guarded in the request for each chunk, and its jobs are queued only once every chunk passed: a refusal queues nothing. Each job is guarded again in the worker, where a refusal fails the job without a retry, whatever its ",[350,1436,1437],{},"$tries",[366,1439,1440],{"href":137},"Queued actions",[370,1442,1444],{"id":1443},"observing-writes","Observing writes",[346,1446,1447,1450],{},[350,1448,1449],{},"ObservesWrites::observeWrite(WriteObservationContext $context)"," is notified once after the commit of each write transaction:",[381,1452,1455],{"className":383,"code":1453,"filename":1454,"language":386,"meta":387,"style":387},"use Lomkit\\Rest\\Extensions\\Contexts\\WriteObservationContext;\nuse Lomkit\\Rest\\Extensions\\Extension;\nuse Lomkit\\Rest\\Extensions\\Kinds\\ObservesWrites;\n\nfinal class WriteHistoryExtension extends Extension implements ObservesWrites\n{\n    public function __construct(private readonly HistoryStore $history) {}\n\n    #[\\Override]\n    public static function name(): string\n    {\n        return 'history';\n    }\n\n    #[\\Override]\n    public function observeWrite(WriteObservationContext $context): void\n    {\n        $this->history->record($context->resource::class, $context->endpoint->value, $context->user?->getAuthIdentifier(), $context->operations ?? []);\n    }\n}\n","Vendor\u002FHistory\u002FWriteHistoryExtension.php",[350,1456,1457,1482,1502,1526,1530,1548,1552,1578,1582,1590,1604,1608,1620,1624,1628,1636,1657,1661,1737,1741],{"__ignoreMap":387},[391,1458,1459,1461,1463,1465,1467,1469,1471,1473,1475,1477,1480],{"class":393,"line":394},[391,1460,398],{"class":397},[391,1462,402],{"class":401},[391,1464,406],{"class":405},[391,1466,409],{"class":401},[391,1468,406],{"class":405},[391,1470,208],{"class":401},[391,1472,406],{"class":405},[391,1474,418],{"class":401},[391,1476,406],{"class":405},[391,1478,1479],{"class":401},"WriteObservationContext",[391,1481,426],{"class":405},[391,1483,1484,1486,1488,1490,1492,1494,1496,1498,1500],{"class":393,"line":429},[391,1485,398],{"class":397},[391,1487,402],{"class":401},[391,1489,406],{"class":405},[391,1491,409],{"class":401},[391,1493,406],{"class":405},[391,1495,208],{"class":401},[391,1497,406],{"class":405},[391,1499,446],{"class":401},[391,1501,426],{"class":405},[391,1503,1504,1506,1508,1510,1512,1514,1516,1518,1520,1522,1524],{"class":393,"line":451},[391,1505,398],{"class":397},[391,1507,402],{"class":401},[391,1509,406],{"class":405},[391,1511,409],{"class":401},[391,1513,406],{"class":405},[391,1515,208],{"class":401},[391,1517,406],{"class":405},[391,1519,468],{"class":401},[391,1521,406],{"class":405},[391,1523,359],{"class":401},[391,1525,426],{"class":405},[391,1527,1528],{"class":393,"line":477},[391,1529,509],{"emptyLinePlaceholder":508},[391,1531,1532,1534,1536,1539,1541,1543,1545],{"class":393,"line":505},[391,1533,516],{"class":515},[391,1535,519],{"class":515},[391,1537,1538],{"class":522}," WriteHistoryExtension",[391,1540,526],{"class":515},[391,1542,529],{"class":522},[391,1544,532],{"class":515},[391,1546,1547],{"class":522}," ObservesWrites\n",[391,1549,1550],{"class":393,"line":512},[391,1551,541],{"class":405},[391,1553,1554,1556,1558,1560,1562,1564,1566,1569,1571,1574,1576],{"class":393,"line":538},[391,1555,558],{"class":515},[391,1557,564],{"class":515},[391,1559,931],{"class":567},[391,1561,632],{"class":405},[391,1563,936],{"class":515},[391,1565,939],{"class":515},[391,1567,1568],{"class":522}," HistoryStore",[391,1570,637],{"class":405},[391,1572,1573],{"class":401},"history",[391,1575,950],{"class":405},[391,1577,953],{"class":405},[391,1579,1580],{"class":393,"line":544},[391,1581,509],{"emptyLinePlaceholder":508},[391,1583,1584,1586,1588],{"class":393,"line":555},[391,1585,547],{"class":401},[391,1587,406],{"class":405},[391,1589,552],{"class":401},[391,1591,1592,1594,1596,1598,1600,1602],{"class":393,"line":577},[391,1593,558],{"class":515},[391,1595,561],{"class":515},[391,1597,564],{"class":515},[391,1599,568],{"class":567},[391,1601,571],{"class":405},[391,1603,574],{"class":397},[391,1605,1606],{"class":393,"line":583},[391,1607,580],{"class":405},[391,1609,1610,1612,1614,1616,1618],{"class":393,"line":602},[391,1611,587],{"class":586},[391,1613,590],{"class":405},[391,1615,1573],{"class":593},[391,1617,597],{"class":405},[391,1619,426],{"class":405},[391,1621,1622],{"class":393,"line":608},[391,1623,605],{"class":405},[391,1625,1626],{"class":393,"line":613},[391,1627,509],{"emptyLinePlaceholder":508},[391,1629,1630,1632,1634],{"class":393,"line":622},[391,1631,547],{"class":401},[391,1633,406],{"class":405},[391,1635,552],{"class":401},[391,1637,1638,1640,1642,1645,1647,1649,1651,1653,1655],{"class":393,"line":649},[391,1639,558],{"class":515},[391,1641,564],{"class":515},[391,1643,1644],{"class":567}," observeWrite",[391,1646,632],{"class":405},[391,1648,1479],{"class":522},[391,1650,637],{"class":405},[391,1652,640],{"class":401},[391,1654,643],{"class":405},[391,1656,1034],{"class":397},[391,1658,1659],{"class":393,"line":654},[391,1660,580],{"class":405},[391,1662,1663,1666,1668,1670,1673,1675,1677,1679,1682,1684,1687,1689,1691,1693,1695,1698,1700,1703,1705,1707,1709,1711,1713,1716,1719,1722,1724,1726,1728,1731,1734],{"class":393,"line":703},[391,1664,1665],{"class":405},"        $this->",[391,1667,1573],{"class":401},[391,1669,663],{"class":405},[391,1671,1672],{"class":567},"record",[391,1674,1056],{"class":405},[391,1676,640],{"class":401},[391,1678,663],{"class":405},[391,1680,1681],{"class":401},"resource",[391,1683,675],{"class":405},[391,1685,1686],{"class":397},"class",[391,1688,1093],{"class":405},[391,1690,637],{"class":405},[391,1692,640],{"class":401},[391,1694,663],{"class":405},[391,1696,1697],{"class":401},"endpoint",[391,1699,663],{"class":405},[391,1701,1702],{"class":401},"value",[391,1704,1093],{"class":405},[391,1706,637],{"class":405},[391,1708,640],{"class":401},[391,1710,663],{"class":405},[391,1712,1063],{"class":401},[391,1714,1715],{"class":405},"?->",[391,1717,1718],{"class":567},"getAuthIdentifier",[391,1720,1721],{"class":405},"(),",[391,1723,637],{"class":405},[391,1725,640],{"class":401},[391,1727,663],{"class":405},[391,1729,1730],{"class":401},"operations ",[391,1732,1733],{"class":405},"??",[391,1735,1736],{"class":405}," []);\n",[391,1738,1739],{"class":393,"line":708},[391,1740,605],{"class":405},[391,1742,1743],{"class":393,"line":1102},[391,1744,711],{"class":405},[1250,1746,1747,1756],{},[1253,1748,1749],{},[1256,1750,1751,1753],{},[1259,1752,500],{},[1259,1754,1755],{},"Context",[1266,1757,1758,1793,1808],{},[1256,1759,1760,1764],{},[1271,1761,1762],{},[350,1763,1306],{},[1271,1765,1766,1769,1770,1772,1773,1776,1777,1780,1781,353,1783,353,1786,1789,1790,1792],{},[350,1767,1768],{},"operations",", the ",[350,1771,1768],{}," of the response, and ",[350,1774,1775],{},"written",", a list of ",[350,1778,1779],{},"Lomkit\\Rest\\Mutations\\WrittenRow"," (",[350,1782,1681],{},[350,1784,1785],{},"entry",[350,1787,1788],{},"model","), once for each resource that the request wrote, with the rows that a ",[350,1791,1354],{}," detaches",[1256,1794,1795,1803],{},[1271,1796,1797,353,1799,353,1801],{},[350,1798,1360],{},[350,1800,1363],{},[350,1802,1366],{},[1271,1804,1805],{},[350,1806,1807],{},"rows",[1256,1809,1810,1813],{},[1271,1811,1812],{},"An action",[1271,1814,1815,353,1818,353,1821,360,1824,1826],{},[350,1816,1817],{},"action",[350,1819,1820],{},"fields",[350,1822,1823],{},"impacted",[350,1825,1807],{}," for each committed transaction, in the worker for a queued action",[713,1828,1829,1832,1835,1846,1853],{},[716,1830,1831],{},"It is never notified for an attempt that a deadlock rolled back or for a write that rolls back later in the same transaction.",[716,1833,1834],{},"It waits for the commit of a transaction of the application on the connection of the resource. A transaction on another connection does not delay it.",[716,1836,1837,1838,1841,1842,1845],{},"When the ",[350,1839,1840],{},"db.transactions"," of the container differs from the transactions manager of the connection, as in an Octane application whose warm list leaves it out, the notification is deferred through ",[350,1843,1844],{},"Connection::afterCommit()",", which attaches it to the last pending transaction of that manager, on any connection: a transaction on another connection opened after the transaction of the application can then release or keep it.",[716,1847,1848,1849,1852],{},"An exception that it throws is reported with ",[350,1850,1851],{},"report()",", the next extension still runs and the response does not change.",[716,1854,1855],{},"The models are copies that the package never saves. A write of the extension runs after the commit, outside the transaction of the package.",[370,1857,1859],{"id":1858},"observing-reads","Observing reads",[346,1861,1862,1865,1866,1139],{},[350,1863,1864],{},"ObservesReads::observeRead(ReadObservationContext $context)"," is notified after an HTTP search, a metric and ",[350,1867,1868],{},"\u002Fdetails",[381,1870,1873],{"className":383,"code":1871,"filename":1872,"language":386,"meta":387,"style":387},"use Lomkit\\Rest\\Extensions\\Contexts\\ReadObservationContext;\nuse Lomkit\\Rest\\Extensions\\Extension;\nuse Lomkit\\Rest\\Extensions\\Kinds\\ObservesReads;\n\nfinal class ReadUsageExtension extends Extension implements ObservesReads\n{\n    public function __construct(private readonly UsageMeter $usage) {}\n\n    #[\\Override]\n    public static function name(): string\n    {\n        return 'usage';\n    }\n\n    #[\\Override]\n    public function observeRead(ReadObservationContext $context): void\n    {\n        $this->usage->add($context->user, $context->endpoint->value, count($context->rows ?? []));\n    }\n}\n","Vendor\u002FPlans\u002FReadUsageExtension.php",[350,1874,1875,1900,1920,1944,1948,1966,1970,1996,2000,2008,2022,2026,2038,2042,2046,2054,2075,2079,2131,2135],{"__ignoreMap":387},[391,1876,1877,1879,1881,1883,1885,1887,1889,1891,1893,1895,1898],{"class":393,"line":394},[391,1878,398],{"class":397},[391,1880,402],{"class":401},[391,1882,406],{"class":405},[391,1884,409],{"class":401},[391,1886,406],{"class":405},[391,1888,208],{"class":401},[391,1890,406],{"class":405},[391,1892,418],{"class":401},[391,1894,406],{"class":405},[391,1896,1897],{"class":401},"ReadObservationContext",[391,1899,426],{"class":405},[391,1901,1902,1904,1906,1908,1910,1912,1914,1916,1918],{"class":393,"line":429},[391,1903,398],{"class":397},[391,1905,402],{"class":401},[391,1907,406],{"class":405},[391,1909,409],{"class":401},[391,1911,406],{"class":405},[391,1913,208],{"class":401},[391,1915,406],{"class":405},[391,1917,446],{"class":401},[391,1919,426],{"class":405},[391,1921,1922,1924,1926,1928,1930,1932,1934,1936,1938,1940,1942],{"class":393,"line":451},[391,1923,398],{"class":397},[391,1925,402],{"class":401},[391,1927,406],{"class":405},[391,1929,409],{"class":401},[391,1931,406],{"class":405},[391,1933,208],{"class":401},[391,1935,406],{"class":405},[391,1937,468],{"class":401},[391,1939,406],{"class":405},[391,1941,363],{"class":401},[391,1943,426],{"class":405},[391,1945,1946],{"class":393,"line":477},[391,1947,509],{"emptyLinePlaceholder":508},[391,1949,1950,1952,1954,1957,1959,1961,1963],{"class":393,"line":505},[391,1951,516],{"class":515},[391,1953,519],{"class":515},[391,1955,1956],{"class":522}," ReadUsageExtension",[391,1958,526],{"class":515},[391,1960,529],{"class":522},[391,1962,532],{"class":515},[391,1964,1965],{"class":522}," ObservesReads\n",[391,1967,1968],{"class":393,"line":512},[391,1969,541],{"class":405},[391,1971,1972,1974,1976,1978,1980,1982,1984,1987,1989,1992,1994],{"class":393,"line":538},[391,1973,558],{"class":515},[391,1975,564],{"class":515},[391,1977,931],{"class":567},[391,1979,632],{"class":405},[391,1981,936],{"class":515},[391,1983,939],{"class":515},[391,1985,1986],{"class":522}," UsageMeter",[391,1988,637],{"class":405},[391,1990,1991],{"class":401},"usage",[391,1993,950],{"class":405},[391,1995,953],{"class":405},[391,1997,1998],{"class":393,"line":544},[391,1999,509],{"emptyLinePlaceholder":508},[391,2001,2002,2004,2006],{"class":393,"line":555},[391,2003,547],{"class":401},[391,2005,406],{"class":405},[391,2007,552],{"class":401},[391,2009,2010,2012,2014,2016,2018,2020],{"class":393,"line":577},[391,2011,558],{"class":515},[391,2013,561],{"class":515},[391,2015,564],{"class":515},[391,2017,568],{"class":567},[391,2019,571],{"class":405},[391,2021,574],{"class":397},[391,2023,2024],{"class":393,"line":583},[391,2025,580],{"class":405},[391,2027,2028,2030,2032,2034,2036],{"class":393,"line":602},[391,2029,587],{"class":586},[391,2031,590],{"class":405},[391,2033,1991],{"class":593},[391,2035,597],{"class":405},[391,2037,426],{"class":405},[391,2039,2040],{"class":393,"line":608},[391,2041,605],{"class":405},[391,2043,2044],{"class":393,"line":613},[391,2045,509],{"emptyLinePlaceholder":508},[391,2047,2048,2050,2052],{"class":393,"line":622},[391,2049,547],{"class":401},[391,2051,406],{"class":405},[391,2053,552],{"class":401},[391,2055,2056,2058,2060,2063,2065,2067,2069,2071,2073],{"class":393,"line":649},[391,2057,558],{"class":515},[391,2059,564],{"class":515},[391,2061,2062],{"class":567}," observeRead",[391,2064,632],{"class":405},[391,2066,1897],{"class":522},[391,2068,637],{"class":405},[391,2070,640],{"class":401},[391,2072,643],{"class":405},[391,2074,1034],{"class":397},[391,2076,2077],{"class":393,"line":654},[391,2078,580],{"class":405},[391,2080,2081,2083,2085,2087,2090,2092,2094,2096,2098,2100,2102,2104,2106,2108,2110,2112,2114,2117,2119,2121,2123,2126,2128],{"class":393,"line":703},[391,2082,1665],{"class":405},[391,2084,1991],{"class":401},[391,2086,663],{"class":405},[391,2088,2089],{"class":567},"add",[391,2091,1056],{"class":405},[391,2093,640],{"class":401},[391,2095,663],{"class":405},[391,2097,1063],{"class":401},[391,2099,1093],{"class":405},[391,2101,637],{"class":405},[391,2103,640],{"class":401},[391,2105,663],{"class":405},[391,2107,1697],{"class":401},[391,2109,663],{"class":405},[391,2111,1702],{"class":401},[391,2113,1093],{"class":405},[391,2115,2116],{"class":567}," count",[391,2118,1056],{"class":405},[391,2120,640],{"class":401},[391,2122,663],{"class":405},[391,2124,2125],{"class":401},"rows ",[391,2127,1733],{"class":405},[391,2129,2130],{"class":405}," []));\n",[391,2132,2133],{"class":393,"line":708},[391,2134,605],{"class":405},[391,2136,2137],{"class":393,"line":1102},[391,2138,711],{"class":405},[1250,2140,2141,2149],{},[1253,2142,2143],{},[1256,2144,2145,2147],{},[1259,2146,500],{},[1259,2148,1755],{},[1266,2150,2151,2174,2187],{},[1256,2152,2153,2155],{},[1271,2154,62],{},[1271,2156,2157,2159,2160,353,2163,360,2166,2169,2170,2173],{},[350,2158,1807],{},", copies of the rows of the page with their includes, ",[350,2161,2162],{},"total",[350,2164,2165],{},"page",[350,2167,2168],{},"perPage",", after ",[350,2171,2172],{},"searched()"," and the meta",[1256,2175,2176,2179],{},[1271,2177,2178],{},"Metric, computed or read from the cache",[1271,2180,2181,360,2184],{},[350,2182,2183],{},"metric",[350,2185,2186],{},"result",[1256,2188,2189,2193],{},[1271,2190,2191],{},[350,2192,1868],{},[1271,2194,2195,2169,2198],{},[350,2196,2197],{},"details",[350,2199,2200],{},"described()",[713,2202,2203,2208,2225,2231,2234],{},[716,2204,2205,2206,1164],{},"The keys that do not apply are ",[350,2207,1288],{},[716,2209,2210,2211,2214,2215,353,2218,1183,2221,2224],{},"Only the HTTP endpoints notify. ",[350,2212,2213],{},"Rest::search()"," notifies nothing, through ",[350,2216,2217],{},"page()",[350,2219,2220],{},"render()",[350,2222,2223],{},"lazy()",": the code that calls it observes its own calls.",[716,2226,2227,2230],{},[350,2228,2229],{},"appliesTo()"," is asked with the resource of the endpoint. The included rows come with the rows of the page and do not notify the extensions of their resources.",[716,2232,2233],{},"It runs in the request: keep writes and slow calls out of it. Its exceptions reach the caller.",[716,2235,2236,2237,2240],{},"On a search engine page, the rows can hold a row that the ",[350,2238,2239],{},"RestrictsQueries"," restrictions would exclude while the index still matches it, since the engine is the proof.",[2242,2243,2244],"style",{},"html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":387,"searchDepth":394,"depth":429,"links":2246},[2247,2248,2253,2254],{"id":372,"depth":429,"text":373},{"id":814,"depth":429,"text":815,"children":2249},[2250,2251,2252],{"id":1247,"depth":451,"text":1248},{"id":1336,"depth":451,"text":1337},{"id":1399,"depth":451,"text":1400},{"id":1443,"depth":429,"text":1444},{"id":1858,"depth":429,"text":1859},"Add middleware to the routes of every resource, refuse a write with a status of your own, and observe the writes and reads of the endpoints.","md",null,{},{"title":229,"description":2255},{"loc":230,"lastmod":2261},"2026-11-21T13:04:54+01:00","faDqEOTTxdZJPrOjagG1nj0nEzaQIu_3Vn6iGgeSnks",[2264,2266],{"title":225,"path":226,"stem":227,"description":2265,"children":-1},"Prepare and version row checks, add to the keys of kept decisions, declare gates and narrow the fields of a resource for each user from an extension.",{"title":233,"path":234,"stem":235,"description":2267,"children":-1},"Add keys to the meta of search pages and details, document an extension in the OpenAPI document and add checks to rest:check.",1795277217124]