encore.dev 1.44.9 → 1.45.0

package/api/mod.ts

@@ -1,6 +1,11 @@
 /* eslint-disable */
 
 import type { IncomingMessage, ServerResponse } from "http";
+import { RequestMeta, currentRequest } from "../mod";
+import { RawResponse } from "./mod";
+import { RawRequest } from "./mod";
+import { InternalHandlerResponse } from "../internal/appinit/mod";
+import { IterableSocket, IterableStream, Sink } from "./stream";
 export { RawRequest, RawResponse } from "../internal/api/node_http";
 
 export type Method =
@@ -141,21 +146,21 @@ export interface StreamOut<Response> {
 
 export type StreamInOutHandlerFn<HandshakeData, Request, Response> =
   HandshakeData extends void
-  ? (stream: StreamInOut<Request, Response>) => Promise<void>
-  : (
-    data: HandshakeData,
-    stream: StreamInOut<Request, Response>
-  ) => Promise<void>;
+    ? (stream: StreamInOut<Request, Response>) => Promise<void>
+    : (
+        data: HandshakeData,
+        stream: StreamInOut<Request, Response>
+      ) => Promise<void>;
 
 export type StreamOutHandlerFn<HandshakeData, Response> =
   HandshakeData extends void
-  ? (stream: StreamOut<Response>) => Promise<void>
-  : (data: HandshakeData, stream: StreamOut<Response>) => Promise<void>;
+    ? (stream: StreamOut<Response>) => Promise<void>
+    : (data: HandshakeData, stream: StreamOut<Response>) => Promise<void>;
 
 export type StreamInHandlerFn<HandshakeData, Request, Response> =
   HandshakeData extends void
-  ? (stream: StreamIn<Request>) => Promise<Response>
-  : (data: HandshakeData, stream: StreamIn<Request>) => Promise<Response>;
+    ? (stream: StreamIn<Request>) => Promise<Response>
+    : (data: HandshakeData, stream: StreamIn<Request>) => Promise<Response>;
 
 export type StreamInOut<Request, Response> = StreamIn<Request> &
   StreamOut<Response>;
@@ -261,5 +266,180 @@ api.static = function staticAssets(options: StaticOptions) {
   return new StaticAssets(options);
 };
 
+export interface MiddlewareOptions {
+  /**
+   * Configuration for what endpoints that should be targeted by the middleware
+   */
+  target?: {
+    /**
+     * If set, only run middleware on endpoints that are either exposed or not
+     * exposed.
+     */
+    expose?: boolean;
+
+    /**
+     * If set, only run middleware on endpoints that either require or not
+     * requires auth.
+     */
+    auth?: boolean;
+
+    /**
+     * If set, only run middleware on endpoints that are raw endpoints.
+     */
+    isRaw?: boolean;
+
+    /**
+     * If set, only run middleware on endpoints that are stream endpoints.
+     */
+    isStream?: boolean;
+  };
+}
+
+export class MiddlewareRequest {
+  private _reqMeta?: RequestMeta;
+  private _stream?: IterableStream | IterableSocket | Sink;
+  private _rawReq?: RawRequest;
+  private _rawResp?: RawResponse;
+
+  constructor(
+    stream?: IterableStream | IterableSocket | Sink,
+    rawReq?: RawRequest,
+    rawResp?: RawResponse
+  ) {
+    this._stream = stream;
+    this._rawReq = rawReq;
+    this._rawResp = rawResp;
+  }
+
+  /**
+   * requestMeta is set when the handler is a typed handler or a stream handler.
+   * for raw handlers, see rawRequest and rawResponse.
+   */
+  public get requestMeta(): RequestMeta | undefined {
+    return this._reqMeta || (this._reqMeta = currentRequest());
+  }
+
+  /**
+   * stream is set when the handler is a stream handler.
+   */
+  public get stream(): IterableStream | IterableSocket | Sink | undefined {
+    return this._stream;
+  }
+
+  /**
+   * rawRequest is set when the handler is a raw request handler.
+   */
+  public get rawRequest(): RawRequest | undefined {
+    return this._rawReq;
+  }
+
+  /**
+   * rawResponse is set when the handler is a raw request handler.
+   */
+  public get rawResponse(): RawResponse | undefined {
+    return this._rawResp;
+  }
+}
+
+export class ResponseHeader {
+  headers: Record<string, string | string[]>;
+
+  constructor() {
+    this.headers = {};
+  }
+
+  /**
+   * set will set a header value for a key, if a previous middleware has
+   * already set a value, it will be overridden.
+   */
+  public set(key: string, value: string | string[]) {
+    this.headers[key] = value;
+  }
+
+  /**
+   * add adds a header value to a key, if a previous middleware has
+   * already set a value, they will be appended.
+   */
+  public add(key: string, value: string | string[]) {
+    const prev = this.headers[key];
+
+    if (prev === undefined) {
+      this.headers[key] = value;
+    } else {
+      this.headers[key] = [prev, value].flat();
+    }
+  }
+}
+
+export class HandlerResponse {
+  /**
+   * The payload returned by the handler when the handler is either
+   * a typed handler or stream handler.
+   */
+  payload: any;
+
+  private _headers?: ResponseHeader;
+
+  constructor(payload: any) {
+    this.payload = payload;
+  }
+
+  /**
+   * header can be used by middlewares to set headers to the
+   * response. This only works for typed handler. For raw handlers
+   * see MiddlewareRequest.rawResponse.
+   */
+  public get header(): ResponseHeader {
+    if (this._headers === undefined) {
+      this._headers = new ResponseHeader();
+    }
+
+    return this._headers;
+  }
+
+  /**
+   * __internalToResponse converts a response to the internal representation
+   */
+  __internalToResponse(): InternalHandlerResponse {
+    return {
+      payload: this.payload,
+      extraHeaders: this._headers?.headers
+    };
+  }
+}
+
+export type Next = (req: MiddlewareRequest) => Promise<HandlerResponse>;
+
+export type MiddlewareFn = (
+  req: MiddlewareRequest,
+  next: Next
+) => Promise<HandlerResponse>;
+
+export interface Middleware extends MiddlewareFn {
+  options?: MiddlewareOptions;
+}
+
+export function middleware(m: MiddlewareFn): Middleware;
+export function middleware(
+  options: MiddlewareOptions,
+  fn: MiddlewareFn
+): Middleware;
+
+export function middleware(
+  a: MiddlewareFn | MiddlewareOptions,
+  b?: MiddlewareFn
+): Middleware {
+  if (b === undefined) {
+    return a as Middleware;
+  } else {
+    const opts = a as MiddlewareOptions;
+    const mw = b as Middleware;
+    mw.options = opts;
+
+    return mw;
+  }
+}
+
 export { APIError, ErrCode } from "./error";
 export { Gateway, type GatewayConfig } from "./gateway";
+export { IterableSocket, IterableStream, Sink } from "./stream";

package/api/stream.ts

@@ -0,0 +1,68 @@
+import * as runtime from "../internal/runtime/mod";
+
+export class IterableStream {
+  private stream: runtime.Stream;
+
+  constructor(stream: runtime.Stream) {
+    this.stream = stream;
+  }
+
+  recv(): Promise<Record<string, any>> {
+    return this.stream.recv();
+  }
+
+  async *[Symbol.asyncIterator]() {
+    while (true) {
+      try {
+        yield await this.stream.recv();
+      } catch (e) {
+        break;
+      }
+    }
+  }
+}
+
+export class IterableSocket {
+  private socket: runtime.Socket;
+
+  constructor(socket: runtime.Socket) {
+    this.socket = socket;
+  }
+
+  send(msg: Record<string, any>): void {
+    return this.socket.send(msg);
+  }
+  recv(): Promise<Record<string, any>> {
+    return this.socket.recv();
+  }
+
+  close(): void {
+    this.socket.close();
+  }
+
+  async *[Symbol.asyncIterator]() {
+    while (true) {
+      try {
+        yield await this.socket.recv();
+      } catch (e) {
+        break;
+      }
+    }
+  }
+}
+
+export class Sink {
+  private sink: runtime.Sink;
+
+  constructor(sink: runtime.Sink) {
+    this.sink = sink;
+  }
+
+  send(msg: Record<string, any>): void {
+    return this.sink.send(msg);
+  }
+
+  close(): void {
+    this.sink.close();
+  }
+}

package/dist/api/mod.d.ts

@@ -1,5 +1,10 @@
 /// <reference types="node" />
 import type { IncomingMessage, ServerResponse } from "http";
+import { RequestMeta } from "../mod.js";
+import { RawResponse } from "./mod.js";
+import { RawRequest } from "./mod.js";
+import { InternalHandlerResponse } from "../internal/appinit/mod.js";
+import { IterableSocket, IterableStream, Sink } from "./stream.js";
 export { RawRequest, RawResponse } from "../internal/api/node_http.js";
 export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE" | "CONNECT";
 export type Header<TypeOrName extends string | number | boolean | Date = string, Name extends string = ""> = TypeOrName extends string ? string : TypeOrName;
@@ -146,5 +151,95 @@ export declare class StaticAssets {
     readonly options: StaticOptions;
     constructor(options: StaticOptions);
 }
+export interface MiddlewareOptions {
+    /**
+     * Configuration for what endpoints that should be targeted by the middleware
+     */
+    target?: {
+        /**
+         * If set, only run middleware on endpoints that are either exposed or not
+         * exposed.
+         */
+        expose?: boolean;
+        /**
+         * If set, only run middleware on endpoints that either require or not
+         * requires auth.
+         */
+        auth?: boolean;
+        /**
+         * If set, only run middleware on endpoints that are raw endpoints.
+         */
+        isRaw?: boolean;
+        /**
+         * If set, only run middleware on endpoints that are stream endpoints.
+         */
+        isStream?: boolean;
+    };
+}
+export declare class MiddlewareRequest {
+    private _reqMeta?;
+    private _stream?;
+    private _rawReq?;
+    private _rawResp?;
+    constructor(stream?: IterableStream | IterableSocket | Sink, rawReq?: RawRequest, rawResp?: RawResponse);
+    /**
+     * requestMeta is set when the handler is a typed handler or a stream handler.
+     * for raw handlers, see rawRequest and rawResponse.
+     */
+    get requestMeta(): RequestMeta | undefined;
+    /**
+     * stream is set when the handler is a stream handler.
+     */
+    get stream(): IterableStream | IterableSocket | Sink | undefined;
+    /**
+     * rawRequest is set when the handler is a raw request handler.
+     */
+    get rawRequest(): RawRequest | undefined;
+    /**
+     * rawResponse is set when the handler is a raw request handler.
+     */
+    get rawResponse(): RawResponse | undefined;
+}
+export declare class ResponseHeader {
+    headers: Record<string, string | string[]>;
+    constructor();
+    /**
+     * set will set a header value for a key, if a previous middleware has
+     * already set a value, it will be overridden.
+     */
+    set(key: string, value: string | string[]): void;
+    /**
+     * add adds a header value to a key, if a previous middleware has
+     * already set a value, they will be appended.
+     */
+    add(key: string, value: string | string[]): void;
+}
+export declare class HandlerResponse {
+    /**
+     * The payload returned by the handler when the handler is either
+     * a typed handler or stream handler.
+     */
+    payload: any;
+    private _headers?;
+    constructor(payload: any);
+    /**
+     * header can be used by middlewares to set headers to the
+     * response. This only works for typed handler. For raw handlers
+     * see MiddlewareRequest.rawResponse.
+     */
+    get header(): ResponseHeader;
+    /**
+     * __internalToResponse converts a response to the internal representation
+     */
+    __internalToResponse(): InternalHandlerResponse;
+}
+export type Next = (req: MiddlewareRequest) => Promise<HandlerResponse>;
+export type MiddlewareFn = (req: MiddlewareRequest, next: Next) => Promise<HandlerResponse>;
+export interface Middleware extends MiddlewareFn {
+    options?: MiddlewareOptions;
+}
+export declare function middleware(m: MiddlewareFn): Middleware;
+export declare function middleware(options: MiddlewareOptions, fn: MiddlewareFn): Middleware;
 export { APIError, ErrCode } from "./error.js";
 export { Gateway, type GatewayConfig } from "./gateway.js";
+export { IterableSocket, IterableStream, Sink } from "./stream.js";

package/dist/api/mod.js

@@ -1,4 +1,5 @@
 /* eslint-disable */
+import { currentRequest } from "../mod.js";
 export { RawRequest, RawResponse } from "../internal/api/node_http.js";
 export function api(options, fn) {
     return fn;
@@ -27,6 +28,111 @@ export class StaticAssets {
 api.static = function staticAssets(options) {
     return new StaticAssets(options);
 };
+export class MiddlewareRequest {
+    _reqMeta;
+    _stream;
+    _rawReq;
+    _rawResp;
+    constructor(stream, rawReq, rawResp) {
+        this._stream = stream;
+        this._rawReq = rawReq;
+        this._rawResp = rawResp;
+    }
+    /**
+     * requestMeta is set when the handler is a typed handler or a stream handler.
+     * for raw handlers, see rawRequest and rawResponse.
+     */
+    get requestMeta() {
+        return this._reqMeta || (this._reqMeta = currentRequest());
+    }
+    /**
+     * stream is set when the handler is a stream handler.
+     */
+    get stream() {
+        return this._stream;
+    }
+    /**
+     * rawRequest is set when the handler is a raw request handler.
+     */
+    get rawRequest() {
+        return this._rawReq;
+    }
+    /**
+     * rawResponse is set when the handler is a raw request handler.
+     */
+    get rawResponse() {
+        return this._rawResp;
+    }
+}
+export class ResponseHeader {
+    headers;
+    constructor() {
+        this.headers = {};
+    }
+    /**
+     * set will set a header value for a key, if a previous middleware has
+     * already set a value, it will be overridden.
+     */
+    set(key, value) {
+        this.headers[key] = value;
+    }
+    /**
+     * add adds a header value to a key, if a previous middleware has
+     * already set a value, they will be appended.
+     */
+    add(key, value) {
+        const prev = this.headers[key];
+        if (prev === undefined) {
+            this.headers[key] = value;
+        }
+        else {
+            this.headers[key] = [prev, value].flat();
+        }
+    }
+}
+export class HandlerResponse {
+    /**
+     * The payload returned by the handler when the handler is either
+     * a typed handler or stream handler.
+     */
+    payload;
+    _headers;
+    constructor(payload) {
+        this.payload = payload;
+    }
+    /**
+     * header can be used by middlewares to set headers to the
+     * response. This only works for typed handler. For raw handlers
+     * see MiddlewareRequest.rawResponse.
+     */
+    get header() {
+        if (this._headers === undefined) {
+            this._headers = new ResponseHeader();
+        }
+        return this._headers;
+    }
+    /**
+     * __internalToResponse converts a response to the internal representation
+     */
+    __internalToResponse() {
+        return {
+            payload: this.payload,
+            extraHeaders: this._headers?.headers
+        };
+    }
+}
+export function middleware(a, b) {
+    if (b === undefined) {
+        return a;
+    }
+    else {
+        const opts = a;
+        const mw = b;
+        mw.options = opts;
+        return mw;
+    }
+}
 export { APIError, ErrCode } from "./error.js";
 export { Gateway } from "./gateway.js";
+export { IterableSocket, IterableStream, Sink } from "./stream.js";
 //# sourceMappingURL=mod.js.map

package/dist/api/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../api/mod.ts"],"names":[],"mappings":"AAAA,oBAAoB;AAGpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAmHpE,MAAM,UAAU,GAAG,CAAC,OAAmB,EAAE,EAAO;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAID,GAAG,CAAC,GAAG,GAAG,SAAS,GAAG,CAAC,OAAmB,EAAE,EAAc;IACxD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AA+CF,SAAS,WAAW,CAAC,OAAsB,EAAE,EAAO;IAClD,OAAO,EAAE,CAAC;AACZ,CAAC;AAcD,SAAS,QAAQ,CAAC,OAAsB,EAAE,EAAO;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAUD,SAAS,SAAS,CAAC,OAAsB,EAAE,EAAO;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;AAC9B,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACxB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;AA4C1B,MAAM,OAAO,YAAY;IACP,OAAO,CAAgB;IAEvC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,GAAG,CAAC,MAAM,GAAG,SAAS,YAAY,CAAC,OAAsB;IACvD,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAsB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../api/mod.ts"],"names":[],"mappings":"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"}

package/dist/api/stream.d.ts

@@ -0,0 +1,21 @@
+import * as runtime from "../internal/runtime/mod.js";
+export declare class IterableStream {
+    private stream;
+    constructor(stream: runtime.Stream);
+    recv(): Promise<Record<string, any>>;
+    [Symbol.asyncIterator](): AsyncGenerator<PVals, void, unknown>;
+}
+export declare class IterableSocket {
+    private socket;
+    constructor(socket: runtime.Socket);
+    send(msg: Record<string, any>): void;
+    recv(): Promise<Record<string, any>>;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncGenerator<PVals, void, unknown>;
+}
+export declare class Sink {
+    private sink;
+    constructor(sink: runtime.Sink);
+    send(msg: Record<string, any>): void;
+    close(): void;
+}

package/dist/api/stream.js

@@ -0,0 +1,57 @@
+export class IterableStream {
+    stream;
+    constructor(stream) {
+        this.stream = stream;
+    }
+    recv() {
+        return this.stream.recv();
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            try {
+                yield await this.stream.recv();
+            }
+            catch (e) {
+                break;
+            }
+        }
+    }
+}
+export class IterableSocket {
+    socket;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    send(msg) {
+        return this.socket.send(msg);
+    }
+    recv() {
+        return this.socket.recv();
+    }
+    close() {
+        this.socket.close();
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            try {
+                yield await this.socket.recv();
+            }
+            catch (e) {
+                break;
+            }
+        }
+    }
+}
+export class Sink {
+    sink;
+    constructor(sink) {
+        this.sink = sink;
+    }
+    send(msg) {
+        return this.sink.send(msg);
+    }
+    close() {
+        this.sink.close();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/api/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../api/stream.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACjB,MAAM,CAAiB;IAE/B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IACjB,MAAM,CAAiB;IAE/B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,GAAwB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,IAAI;IACP,IAAI,CAAe;IAE3B,YAAY,IAAkB;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,GAAwB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/internal/appinit/mod.d.ts

@@ -1,7 +1,23 @@
 import { Gateway } from "../../api/gateway.js";
+import { Middleware } from "../../api/mod.js";
 import * as runtime from "../runtime/mod.js";
-export type Handler = runtime.ApiRoute;
+export type Handler = {
+    apiRoute: runtime.ApiRoute;
+    middlewares: Middleware[];
+    endpointOptions: EndpointOptions;
+};
 export declare function registerHandlers(handlers: Handler[]): void;
 export declare function registerTestHandler(handler: Handler): void;
 export declare function registerGateways(gateways: Gateway[]): void;
 export declare function run(): Promise<void>;
+interface EndpointOptions {
+    expose: boolean;
+    auth: boolean;
+    isRaw: boolean;
+    isStream: boolean;
+}
+export interface InternalHandlerResponse {
+    payload: any;
+    extraHeaders?: Record<string, string | string[]>;
+}
+export {};