@occultist/occultist 0.0.4 → 0.0.6

package/dist/accept.js

@@ -57,7 +57,6 @@ export class Accept {
         const accept = req.headers.get('Accept');
         const acceptLanguage = req.headers.get('Accept-Language');
         const acceptEncoding = req.headers.get('Accept-Encoding');
-        console.log('ACCEPT', accept);
         return new Accept(accept, acceptLanguage, acceptEncoding);
     }
     debug() {

package/dist/actions/actionSets.d.ts

@@ -1,6 +1,6 @@
-import { type Accept } from "../accept.js";
-import type { ActionMeta } from "./meta.js";
-import type { ImplementedAction } from "./types.js";
+import { type Accept } from "../accept.ts";
+import type { ActionMeta } from "./meta.ts";
+import type { ImplementedAction } from "./types.ts";
 export type UnsupportedContentTypeMatch = {
     type: 'unsupported-content-type';
     contentTypes: string[];

package/dist/actions/actions.d.ts

@@ -1,11 +1,11 @@
-import { CacheInstanceArgs } from '../cache/types.js';
-import type { JSONLDContext, JSONObject, TypeDef } from "../jsonld.js";
-import type { Registry } from '../registry.js';
-import type { Scope } from "../scopes.js";
-import { type ActionMeta } from "./meta.js";
-import type { ActionSpec, ContextState } from "./spec.js";
-import type { HandleRequestArgs, HandlerFn, HandlerMeta, HandlerObj, HandlerValue, HintArgs, ImplementedAction } from './types.js';
-import { ResponseTypes } from './writer.js';
+import type { CacheInstanceArgs } from '../cache/types.ts';
+import type { JSONLDContext, JSONObject, TypeDef } from "../jsonld.ts";
+import type { Registry } from '../registry.ts';
+import type { Scope } from "../scopes.ts";
+import { type ActionMeta } from "./meta.ts";
+import type { ActionSpec, ContextState } from "./spec.ts";
+import type { AuthMiddleware, AuthState, HandleRequestArgs, HandlerFn, HandlerMeta, HandlerObj, HandlerValue, HintArgs, ImplementedAction } from './types.ts';
+import { type ResponseTypes } from './writer.ts';
 export type DefineArgs<Term extends string = string, Spec extends ActionSpec = ActionSpec> = {
     typeDef?: TypeDef<Term>;
     spec?: Spec;
@@ -14,31 +14,31 @@ export type DefineArgs<Term extends string = string, Spec extends ActionSpec = A
  * A handler definition which can be pulled from a registry, scope or action
  * after an action is defined.
  */
-export declare class HandlerDefinition<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> {
+export declare class HandlerDefinition<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> {
     name: string;
     contentType: string;
     handler: HandlerFn | HandlerValue;
     meta: HandlerMeta;
-    action: ImplementedAction<State, Spec>;
+    action: ImplementedAction<State, Auth, Spec>;
     cache: ReadonlyArray<CacheInstanceArgs>;
-    constructor(name: string, contentType: string, handler: HandlerFn | HandlerValue, meta: HandlerMeta, action: ImplementedAction<State, Spec>, actionMeta: ActionMeta);
+    constructor(name: string, contentType: string, handler: HandlerFn | HandlerValue, meta: HandlerMeta, action: ImplementedAction<State, Auth, Spec>, actionMeta: ActionMeta);
     get [Symbol.toStringTag](): string;
 }
-export interface Handleable<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> {
+export interface Handleable<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> {
     /**
      * Defines the final handler for this content type.
      *
      * An action can have multiple handlers defined
      * each for a different set of content types.
      */
-    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State, Spec>): FinalizedAction<State, Spec>;
-    handle(args: HandlerObj<State, Spec>): FinalizedAction<State, Spec>;
+    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
+    handle(args: HandlerObj<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
 }
-export declare class FinalizedAction<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> implements Handleable<State, Spec>, ImplementedAction<State, Spec> {
+export declare class FinalizedAction<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> implements Handleable<State, Auth, Spec>, ImplementedAction<State, Auth, Spec> {
     #private;
-    constructor(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Spec>, handlerArgs: HandlerObj<State, Spec>);
-    static fromHandlers<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec>(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Spec>, contextType: string | string[], handler: HandlerValue | HandlerFn<State, Spec>): FinalizedAction<State, Spec>;
-    static fromHandlers<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec>(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Spec>, handlerArgs: HandlerObj<State, Spec>): FinalizedAction<State, Spec>;
+    constructor(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Auth, Spec>, handlerArgs: HandlerObj<State, Auth, Spec>);
+    static fromHandlers<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec>(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Auth, Spec>, contextType: string | string[], handler: HandlerValue | HandlerFn<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
+    static fromHandlers<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec>(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Auth, Spec>, handlerArgs: HandlerObj<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
     static toJSONLD(action: ImplementedAction, scope: Scope): Promise<JSONObject | null>;
     get public(): boolean;
     get method(): string;
@@ -51,25 +51,32 @@ export declare class FinalizedAction<State extends ContextState = ContextState,
     get spec(): Spec;
     get scope(): Scope | undefined;
     get registry(): Registry;
-    get handlers(): HandlerDefinition<State, Spec>[];
+    get handlers(): HandlerDefinition<State, Auth, Spec>[];
     get contentTypes(): string[];
     get context(): JSONObject;
     url(): string;
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(contentType: string): HandlerDefinition<State, Auth, Spec> | undefined;
     jsonld(): Promise<JSONObject | null>;
     jsonldPartial(): {
         '@type': string;
         '@id': string;
     } | null;
-    handle(contentType: string | string[], handler: HandlerFn<State, Spec> | HandlerValue): FinalizedAction<State, Spec>;
-    handle(args: HandlerObj<State, Spec>): FinalizedAction<State, Spec>;
+    handle(contentType: string | string[], handler: HandlerFn<State, Auth, Spec> | HandlerValue): FinalizedAction<State, Auth, Spec>;
+    handle(args: HandlerObj<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
     handleRequest(args: HandleRequestArgs): Promise<ResponseTypes>;
+    perform(req: Request): Promise<Response>;
 }
 export interface Applicable<ActionType> {
     use(): ActionType;
 }
-export declare class DefinedAction<State extends ContextState = ContextState, Term extends string = string, Spec extends ActionSpec = ActionSpec> implements Applicable<DefinedAction<State, Term, Spec>>, Handleable<State, Spec>, ImplementedAction<State, Spec> {
+export declare class DefinedAction<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Term extends string = string, Spec extends ActionSpec = ActionSpec> implements Applicable<DefinedAction<State, Auth, Term, Spec>>, Handleable<State, Auth, Spec>, ImplementedAction<State, Auth, Spec> {
     #private;
-    constructor(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Spec>);
+    constructor(typeDef: TypeDef | undefined, spec: Spec, meta: ActionMeta<State, Auth, Spec>);
     get public(): boolean;
     get method(): string;
     get term(): string | undefined;
@@ -82,9 +89,15 @@ export declare class DefinedAction<State extends ContextState = ContextState, Te
     get spec(): Spec;
     get scope(): Scope | undefined;
     get registry(): Registry;
-    get handlers(): HandlerDefinition<State, Spec>[];
+    get handlers(): HandlerDefinition<State, Auth, Spec>[];
     get contentTypes(): string[];
     url(): string;
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(_contentType: string): undefined;
     get context(): JSONLDContext;
     jsonld(): Promise<JSONObject | null>;
     jsonldPartial(): {
@@ -98,14 +111,15 @@ export declare class DefinedAction<State extends ContextState = ContextState, Te
      * if validating and transforming the action payload might cause
      * auth sensitive checks to be run which might reject the request.
      */
-    cache(args: CacheInstanceArgs): DefinedAction<State, string, Spec>;
-    meta(): DefinedAction<State, string, Spec>;
-    use(): DefinedAction<State, string, Spec>;
-    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State, Spec>): FinalizedAction<State, Spec>;
-    handle(args: HandlerObj<State, Spec>): FinalizedAction<State, Spec>;
+    cache(args: CacheInstanceArgs): DefinedAction<State, Auth, Term, Spec>;
+    meta(): DefinedAction<State, Auth, Term, Spec>;
+    use(): DefinedAction<State, Auth, Term, Spec>;
+    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
+    handle(args: HandlerObj<State, Auth, Spec>): FinalizedAction<State, Auth, Spec>;
     handleRequest(args: HandleRequestArgs): Promise<ResponseTypes>;
+    perform(req: Request): Promise<Response>;
 }
-export declare class Action<State extends ContextState = ContextState> implements Applicable<Action>, Handleable<State>, ImplementedAction<State> {
+export declare class Action<State extends ContextState = ContextState, Auth extends AuthState = AuthState> implements Applicable<Action>, Handleable<State>, ImplementedAction<State> {
     #private;
     constructor(meta: ActionMeta<State>);
     get public(): boolean;
@@ -124,40 +138,47 @@ export declare class Action<State extends ContextState = ContextState> implement
     get contentTypes(): string[];
     get context(): JSONObject;
     url(): string;
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(_contentType: string): undefined;
     jsonld(): Promise<null>;
     jsonldPartial(): {
         '@type': string;
         '@id': string;
     } | null;
     use(): Action<State>;
-    define<Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Term, Spec>;
+    define<Auth extends AuthState = AuthState, Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Auth, Term, Spec>;
     handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State>): FinalizedAction<State>;
     handle(args: HandlerObj<State>): FinalizedAction<State>;
     handleRequest(args: HandleRequestArgs): Promise<ResponseTypes>;
+    perform(req: Request): Promise<Response>;
 }
-export declare class PreAction<State extends ContextState = ContextState> implements Applicable<Action>, Handleable<State> {
+export declare class PreAction<State extends ContextState = ContextState, Auth extends AuthState = AuthState> implements Applicable<Action>, Handleable<State, Auth> {
     #private;
-    constructor(meta: ActionMeta<State>);
-    use(): Action<State>;
-    define<Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Term, Spec>;
-    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State>): FinalizedAction<State>;
-    handle(args: HandlerObj<State>): FinalizedAction<State>;
+    constructor(meta: ActionMeta<State, Auth>);
+    use(): Action<State, AuthState>;
+    define<Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Auth, Term, Spec>;
+    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State, Auth>): FinalizedAction<State, Auth>;
+    handle(args: HandlerObj<State>): FinalizedAction<State, Auth>;
 }
-export declare class Endpoint<State extends ContextState = ContextState> implements Applicable<Action>, Handleable<State> {
+export declare class Endpoint<State extends ContextState = ContextState, Auth extends AuthState = AuthState> implements Applicable<Action>, Handleable<State, Auth> {
     #private;
-    constructor(meta: ActionMeta<State>);
-    hint(hints: HintArgs): Endpoint<State>;
-    compress(): Endpoint<State>;
-    cache(args: CacheInstanceArgs): this;
+    constructor(meta: ActionMeta<State, Auth>);
+    hint(hints: HintArgs): Endpoint<State, Auth>;
+    compress(): Endpoint<State, Auth>;
+    cache(args: CacheInstanceArgs): Endpoint<State, Auth>;
     etag(): this;
-    use(): Action<State>;
-    define<Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Term, Spec>;
-    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State>): FinalizedAction<State>;
-    handle(args: HandlerObj<State>): FinalizedAction<State>;
+    use(): Action<State, Auth>;
+    define<Term extends string = string, Spec extends ActionSpec = ActionSpec>(args: DefineArgs<Term, Spec>): DefinedAction<State, Auth, Term, Spec>;
+    handle(contentType: string | string[], handler: HandlerValue | HandlerFn<State>): FinalizedAction<State, Auth>;
+    handle(args: HandlerObj<State, Auth>): FinalizedAction<State, Auth>;
 }
 export declare class ActionAuth<State extends ContextState = ContextState> {
     #private;
     constructor(meta: ActionMeta<State>);
-    public(): Endpoint<State>;
-    private(): Endpoint<State>;
+    public<Auth extends AuthState = AuthState>(authMiddleware?: AuthMiddleware<Auth>): Endpoint<State, Auth>;
+    private<Auth extends AuthState = AuthState>(authMiddleware: AuthMiddleware<Auth>): Endpoint<State, Auth>;
 }

package/dist/actions/actions.js

@@ -1,6 +1,6 @@
 import { getActionContext } from "../utils/getActionContext.js";
 import { getPropertyValueSpecifications } from "../utils/getPropertyValueSpecifications.js";
-import { isPopulatedObject } from '../utils/isPopulatedObject.js';
+import { isPopulatedObject } from "../utils/isPopulatedObject.js";
 import { joinPaths } from "../utils/joinPaths.js";
 import { AfterDefinition, BeforeDefinition } from "./meta.js";
 function isHandlerObj(handler) {
@@ -131,6 +131,14 @@ export class FinalizedAction {
     url() {
         return joinPaths(this.#meta.registry.rootIRI, this.#meta.path.normalized);
     }
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(contentType) {
+        return this.#handlers.get(contentType);
+    }
     jsonld() {
         const scope = this.#meta.scope;
         return FinalizedAction.toJSONLD(this, scope);
@@ -175,7 +183,7 @@ export class FinalizedAction {
         }
         return this;
     }
-    async handleRequest(args) {
+    handleRequest(args) {
         const handler = this.#handlers.get(args.contentType);
         return this.#meta.handleRequest({
             ...args,
@@ -183,6 +191,9 @@ export class FinalizedAction {
             handler,
         });
     }
+    perform(req) {
+        return this.#meta.perform(req);
+    }
 }
 export class DefinedAction {
     #spec;
@@ -239,6 +250,12 @@ export class DefinedAction {
     url() {
         return '';
     }
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(_contentType) { }
     get context() {
         return getActionContext({
             spec: this.#spec,
@@ -295,6 +312,9 @@ export class DefinedAction {
             spec: this.#spec,
         });
     }
+    perform(req) {
+        return this.#meta.perform(req);
+    }
 }
 export class Action {
     #spec = {};
@@ -355,6 +375,12 @@ export class Action {
     url() {
         return '';
     }
+    /**
+     * Retrives the handler configured for the given content type.
+     *
+     * @param contentType   The content type.
+     */
+    handlerFor(_contentType) { }
     jsonld() {
         return Promise.resolve(null);
     }
@@ -376,6 +402,9 @@ export class Action {
             spec: this.#spec,
         });
     }
+    perform(req) {
+        return this.#meta.perform(req);
+    }
 }
 export class PreAction {
     #meta;
@@ -426,11 +455,17 @@ export class ActionAuth {
     constructor(meta) {
         this.#meta = meta;
     }
-    public() {
+    public(authMiddleware) {
+        if (authMiddleware != null && typeof authMiddleware !== 'function')
+            throw new Error('Public action given invalid auth middleware');
         this.#meta.public = true;
+        this.#meta.auth = authMiddleware;
         return new Endpoint(this.#meta);
     }
-    private() {
+    private(authMiddleware) {
+        if (typeof authMiddleware !== 'function')
+            throw new Error('Private action given invalid auth middleware');
+        this.#meta.auth = authMiddleware;
         return new Endpoint(this.#meta);
     }
 }

package/dist/actions/context.d.ts

@@ -1,14 +1,15 @@
-import type { HandlerDefinition } from "../mod.js";
-import type { Registry } from "../registry.js";
-import type { ActionPayload, ActionSpec, ContextState, ParsedIRIValues } from "./spec.js";
-import type { ImplementedAction } from "./types.js";
-import type { ResponseBody } from "./writer.js";
-export type CacheContextArgs = {
+import type { HandlerDefinition } from "../mod.ts";
+import type { Registry } from "../registry.ts";
+import type { ActionPayload, ActionSpec, ContextState, ParsedIRIValues } from "./spec.ts";
+import type { AuthState, ImplementedAction } from "./types.ts";
+import type { ResponseBody } from "./writer.ts";
+export type CacheContextArgs<Auth extends AuthState = AuthState> = {
     req: Request;
     url: string;
     contentType: string;
     public: boolean;
     authKey?: string;
+    auth: Auth;
     handler: HandlerDefinition;
     params: ParsedIRIValues;
     query: ParsedIRIValues;
@@ -16,7 +17,7 @@ export type CacheContextArgs = {
 /**
  * Request context object.
  */
-export declare class CacheContext {
+export declare class CacheContext<Auth extends AuthState = AuthState> {
     #private;
     req: Request;
     method: string;
@@ -24,12 +25,13 @@ export declare class CacheContext {
     contentType: string;
     public: boolean;
     authKey?: string;
+    auth: Auth;
     action: ImplementedAction;
     registry: Registry;
     params: ParsedIRIValues;
     query: ParsedIRIValues;
     headers: Headers;
-    constructor(args: CacheContextArgs);
+    constructor(args: CacheContextArgs<Auth>);
     get hit(): boolean;
     set hit(hit: boolean);
     get status(): undefined | number;
@@ -40,12 +42,13 @@ export declare class CacheContext {
     set etag(etag: string);
     get [Symbol.toStringTag](): string;
 }
-export type ContextArgs<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> = {
+export type ContextArgs<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> = {
     req: Request;
     url: string;
     contentType: string;
     public: boolean;
     authKey?: string;
+    auth: Auth;
     handler: HandlerDefinition<State, Spec>;
     params: ParsedIRIValues;
     query: ParsedIRIValues;
@@ -54,7 +57,7 @@ export type ContextArgs<State extends ContextState = ContextState, Spec extends
 /**
  * Request context object.
  */
-export declare class Context<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> {
+export declare class Context<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> {
     #private;
     req: Request;
     method: string;
@@ -62,6 +65,7 @@ export declare class Context<State extends ContextState = ContextState, Spec ext
     contentType: string;
     public: boolean;
     authKey?: string;
+    auth: Auth;
     state: State;
     action: ImplementedAction<State, Spec>;
     registry: Registry;
@@ -69,7 +73,7 @@ export declare class Context<State extends ContextState = ContextState, Spec ext
     query: ParsedIRIValues;
     payload: ActionPayload<Spec>;
     headers: Headers;
-    constructor(args: ContextArgs<State, Spec>);
+    constructor(args: ContextArgs<State, Auth, Spec>);
     get status(): undefined | number;
     set status(status: number);
     get body(): undefined | ResponseBody;

package/dist/actions/context.js

@@ -16,6 +16,7 @@ export class CacheContext {
     contentType;
     public = false;
     authKey;
+    auth;
     action;
     registry;
     params;
@@ -27,6 +28,7 @@ export class CacheContext {
         this.contentType = args.contentType;
         this.public = args.public;
         this.authKey = args.authKey;
+        this.auth = args.auth;
         this.action = args.handler.action;
         this.method = args.handler.action.method;
         this.registry = args.handler.action.registry;
@@ -73,6 +75,7 @@ export class Context {
     contentType;
     public = false;
     authKey;
+    auth;
     state = {};
     action;
     registry;
@@ -86,6 +89,7 @@ export class Context {
         this.contentType = args.contentType;
         this.public = args.public;
         this.authKey = args.authKey;
+        this.auth = args.auth;
         this.action = args.handler.action;
         this.method = args.handler.action.method;
         this.registry = args.handler.action.registry;
@@ -93,6 +97,7 @@ export class Context {
         this.query = args.query;
         this.payload = args.payload;
         Object.freeze(this);
+        Object.freeze(this.auth);
     }
     get status() {
         return this.#editable.status;

package/dist/actions/meta.d.ts

@@ -1,15 +1,15 @@
-import { CacheInstanceArgs } from '../cache/types.js';
-import { JSONValue } from '../jsonld.js';
-import type { Registry } from '../registry.js';
-import type { Scope } from "../scopes.js";
-import { HandlerDefinition } from './actions.js';
-import { Path } from "./path.js";
-import type { ActionSpec, ContextState, FileValue, TransformerFn } from './spec.js';
-import type { HintArgs, ImplementedAction } from './types.js';
-import type { HTTPWriter, ResponseTypes } from "./writer.js";
+import type { CacheInstanceArgs } from '../cache/types.ts';
+import type { JSONValue } from '../jsonld.ts';
+import type { Registry } from '../registry.ts';
+import type { Scope } from "../scopes.ts";
+import { HandlerDefinition } from './actions.ts';
+import { Path } from "./path.ts";
+import type { ActionSpec, ContextState, FileValue, TransformerFn } from './spec.ts';
+import type { AuthMiddleware, AuthState, CacheHitHeader, HintArgs, ImplementedAction } from './types.ts';
+import { type HTTPWriter, type ResponseTypes } from "./writer.ts";
 export declare const BeforeDefinition = 0;
 export declare const AfterDefinition = 1;
-export declare class ActionMeta<State extends ContextState = ContextState, Spec extends ActionSpec = ActionSpec> {
+export declare class ActionMeta<State extends ContextState = ContextState, Auth extends AuthState = AuthState, Spec extends ActionSpec = ActionSpec> {
     #private;
     rootIRI: string;
     method: string;
@@ -27,6 +27,7 @@ export declare class ActionMeta<State extends ContextState = ContextState, Spec
     acceptCache: Set<string>;
     compressBeforeCache: boolean;
     cacheOccurance: 0 | 1;
+    auth?: AuthMiddleware<Auth>;
     cache: CacheInstanceArgs[];
     serverTiming: boolean;
     constructor(rootIRI: string, method: string, name: string, uriTemplate: string, registry: Registry, writer: HTTPWriter, scope?: Scope);
@@ -34,8 +35,11 @@ export declare class ActionMeta<State extends ContextState = ContextState, Spec
      * Called when the API is defined to compute all uncomputed values.
      */
     finalize(): void;
-    handleRequest({ startTime, contentType, language: _language, encoding: _encoding, url, req, writer, spec, handler, }: {
-        startTime: number;
+    perform(req: Request): Promise<Response>;
+    /**
+     *
+     */
+    handleRequest({ contentType, url, req, writer, spec, handler, cacheHitHeader, startTime, }: {
         contentType?: string;
         language?: string;
         encoding?: string;
@@ -44,6 +48,8 @@ export declare class ActionMeta<State extends ContextState = ContextState, Spec
         writer: HTTPWriter;
         spec?: Spec;
         handler?: HandlerDefinition<State, Spec>;
+        cacheHitHeader?: CacheHitHeader;
+        startTime?: number;
     }): Promise<ResponseTypes>;
     get [Symbol.toStringTag](): string;
 }