webdaemon 11.5.1 → 12.0.0

package/dist/types/js/Token.d.ts

@@ -0,0 +1,257 @@
+export class Token {
+    static Source: {
+        PARTY_CONTROL: string;
+    };
+    static Counterparty: {
+        PUBLIC: string;
+    };
+    static Capability: {
+        OPEN: string;
+        CLOSE: string;
+        GRANT: string;
+        REVOKE: string;
+        OFFER: string;
+        RETRACT: string;
+        DELETE: string;
+        CATALOG: string;
+        ALIAS: string;
+        UNALIAS: string;
+        GET_ITEM: string;
+        SET_ITEM: string;
+        ALERT: string;
+        LOG: string;
+        READ: string;
+        WRITE: string;
+    };
+    static DEFAULT_EXPIRY_MILLIS: number;
+    static TOKEN_HEADER: string;
+    static SCOPE_SEPARATOR: RegExp;
+    /**
+     * Returns a base64 JSON string corresponding to the provided byte array.
+     *
+     * @param {Uint8Array} bytes to be encoded as a base64 string.
+     * @returns {string} the encoded bytes.
+     */
+    static bytesToBase64(bytes: Uint8Array): string;
+    /**
+     * Returns the byte array decoded from the base64 string.
+     *
+     * @param {string} base64
+     * @returns {Uint8Array} the decoded bytes.
+     */
+    static base64ToBytes(base64: string): Uint8Array;
+    /**
+     * Returns a new token using the x-tabserver-token header on the
+     * request.
+     *
+     * @param {Request} request the request.
+     * @return {Token | null} the token, or null if no header is present.
+     * @throws {string} exception if token cannot be constructed.
+     */
+    static from(request: Request): Token | null;
+    /**
+     * Converts an object whose string keys map to token objects
+     * into  URL-friendly search params suitable for use in a
+     * query string or fragment.
+     *
+     * The string keys are normally the audience hostname, or the
+     * special key 'party' which holds the identity token whose
+     * `aud` and `sub` are the same.
+     *
+     * @param {TokenSet} tokenSet the set of tokens keyed by string.
+     * @returns {string}
+     */
+    static toSearchString(tokenSet: TokenSet): string;
+    /**
+     * Constructor takes either a signed base64 token, or a payload object.
+     *
+     * If successful, the payload and optionally the signature fields are
+     * populated.
+     *
+     * @param {object | string} source a payload, or a base64 token
+     */
+    constructor(source: object | string);
+    /**
+     * Generates the signature for the object using the private key provided by the
+     * supplied callback and stores the result.
+     *
+     * @param {Promise<JsonWebKey>} privateJwkPromise the private key used for signing.
+     * @return {Promise<string>} resolved with the base64 signature if signed successfully.
+     */
+    signWith(privateJwkPromise: Promise<JsonWebKey>): Promise<string>;
+    /**
+     * Retrieves the signatory using the `iss` field, checks the signature
+     * and if valid sets the signatory property in this instance.
+     *
+     * @throws {string} if signatory cannot be retrieved or signature doesn't match.
+     */
+    verifySignatory(): Promise<void>;
+    /**
+     * Fetches the signatory from the `iss` URL, setting the instance
+     * property.
+     *
+     * The signatory comprises the `src` representing the app that has
+     * signed the token and  the public `jwk`.
+     *
+     * Caching may be introduced to reduce latency and bandwidth use.
+     *
+     * @throws {string} error if fetch fails or returns an error response.
+     */
+    fetchSignatory(): Promise<void>;
+    /**
+     * Checks the signature using the public key provided by the supplied callback,
+     * and stores the result.
+     *
+     * @param {Promise<JsonWebKey>} publicJwkPromise the public key used to verify the signature.
+     * @throws {string} exception if signature cannot be verified or the public key is null or error.
+     */
+    checkSignature(publicJwkPromise: Promise<JsonWebKey>): Promise<void>;
+    /**
+     * Returns the payload with the `sig` property added.
+     *
+     * @return {TokenPayload} the payload with `sig` property.
+     */
+    getSignedPayload(): TokenPayload;
+    /**
+     * Returns the payload whether signed or not.
+     *
+     * @return {TokenPayload} the payload object without signature.
+     */
+    getPayload(): TokenPayload;
+    /**
+     * Returns the `aud` field as a string.
+     *
+     * @return {string} the `aud` field value.
+     */
+    getAud(): string;
+    /**
+     * Returns the `aud` host which is the party name handling the request.
+     *
+     * @return {string} the party name.
+     */
+    getParty(): string;
+    /**
+     * Returns the `sub` field as a string.
+     *
+     * @return {string} the `sub` field value.
+     */
+    getSub(): string;
+    /**
+     * Returns the `sub` host, which is the counterparty name making the
+     * request.
+     *
+     * @return {string} the counterparty name.
+     */
+    getCounterparty(): string;
+    /**
+     * Returns the source of the signatory who signed on behalf of the
+     * counterparty. This is only available once the token is
+     * verified, as it is provided by the `iss` endpoint.
+     *
+     * @returns {string} source of the verified signatory.
+     */
+    getSignatorySrc(): string;
+    /**
+     * Returns the `src` URL.
+     *
+     * @return {URL} the source URL.
+     */
+    getSourceUrl(): URL;
+    /**
+     * Returns the `issuer` field as a URL. The counterparty is inferred from
+     * the host name which generally matches the sub field.
+     *
+     * @return {URL} the issuer URL.
+     */
+    getIssuer(): URL;
+    /**
+     * Returns the list of zero or more sources for which scope is requested.
+     *
+     * @return {string[]} a list of source URL strings.
+     */
+    getSources(): string[];
+    /**
+     * Returns the scope for the source as an array of capability tokens.
+     *
+     * These can be separated by any mix of space, comma, semicolon
+     * or vertical bar.
+     *
+     * @param {string} source whose capabilities are returned.
+     * @return {string[]} zero or more scope tokens.
+     */
+    getCapabilities(source: string): string[];
+    /**
+     * Returns true if the supplied capability is present in the token
+     * scope under the specified source, otherwise false.
+     *
+     * @param {string} source the source under which the capability is expected.
+     * @param {string} capability the capability being tested.
+     * @return {boolean} true if capability is present in the scope, otherwise false.
+     */
+    hasCapability(source: string, capability: string): boolean;
+    /**
+     * Checks the token is within the period defined by the `iat` and `exp`
+     * date fields.
+     *
+     * @throws {string} exception if not within valid period.
+     */
+    checkPeriod(): void;
+    /**
+     * Returns the signed object including the `sig` property as a base64 string.
+     *
+     * @return {string} the signed object as a base64 string.
+     */
+    asSignedBase64(): string;
+    #private;
+}
+export type Scope = {
+    [x: string]: string;
+};
+export type TokenPayload = {
+    /**
+     * // URL of public key of counterparty making request.
+     */
+    iss: string;
+    /**
+     * // Party origin handling the request.
+     */
+    aud: string;
+    /**
+     * // Counterparty origin making the request.
+     */
+    sub: string;
+    /**
+     * // Source HTML document context of the request excluding fragment and query.
+     */
+    src: string;
+    /**
+     * // Map of scope (space-separated capabilities) keyed by source URL.
+     */
+    scope: Scope;
+    /**
+     * // Issued at time.
+     */
+    iat: number;
+    /**
+     * // Expiry time.
+     */
+    exp: number;
+    /**
+     * // Signature if signed.
+     */
+    sig: string;
+};
+/**
+ * the object to be served on the iss URL.
+ */
+export type Signatory = {
+    /**
+     * which is 'party:control' if the shell, or source URL if a runner.
+     */
+    src: string | null;
+    jwk: JsonWebKey;
+};
+export type TokenSet = {
+    [x: string]: Token;
+};
+//# sourceMappingURL=Token.d.ts.map

package/dist/types/js/Token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Token.d.ts","sourceRoot":"","sources":["../../../js/Token.js"],"names":[],"mappings":"AAmFA;IAGE;;MAEC;IAGD;;MAEC;IAGD;;;;;;;;;;;;;;;;;MAiBC;IAED,qCAAkD;IAClD,4BAAyC;IACzC,+BAAoC;IAsXpC;;;;;OAKG;IACH,4BAHW,UAAU,GACR,MAAM,CAKlB;IAED;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,UAAU,CAKtB;IAED;;;;;;;OAOG;IACH,qBAJW,OAAO,GACN,KAAK,GAAG,IAAI,CAUvB;IAED;;;;;;;;;;;OAWG;IACH,gCAHW,QAAQ,GACN,MAAM,CAUlB;IA5ZD;;;;;;;OAOG;IACH,oBAFW,MAAM,GAAG,MAAM,EA8DzB;IAED;;;;;;OAMG;IACH,4BAHW,OAAO,CAAC,UAAU,CAAC,GAClB,OAAO,CAAC,MAAM,CAAC,CAgB1B;IAED;;;;;OAKG;IACH,iCAMC;IAED;;;;;;;;;;OAUG;IACH,gCAkBC;IAED;;;;;;OAMG;IACH,iCAHW,OAAO,CAAC,UAAU,CAAC,iBAoB7B;IAED;;;;OAIG;IACH,oBAFY,YAAY,CAWvB;IAED;;;;OAIG;IACH,cAFY,YAAY,CAOvB;IAED;;;;OAIG;IACH,UAFY,MAAM,CAIjB;IAGD;;;;OAIG;IACH,YAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,UAFY,MAAM,CAIjB;IAED;;;;;OAKG;IACH,mBAFY,MAAM,CAIjB;IAED;;;;;;OAMG;IACH,mBAFa,MAAM,CAWlB;IAED;;;;OAIG;IACH,gBAFY,GAAG,CAId;IAED;;;;;OAKG;IACH,aAFY,GAAG,CAId;IAED;;;;OAIG;IACH,cAFY,MAAM,EAAE,CAYnB;IAED;;;;;;;;OAQG;IACH,wBAHW,MAAM,GACL,MAAM,EAAE,CAanB;IAED;;;;;;;OAOG;IACH,sBAJW,MAAM,cACN,MAAM,GACL,OAAO,CAIlB;IAED;;;;;OAKG;IACH,oBAkBC;IAED;;;;OAIG;IACH,kBAFY,MAAM,CAIjB;;CA8DF;;;;;;;;SAzfa,MAAM;;;;SACN,MAAM;;;;SACN,MAAM;;;;SACN,MAAM;;;;WACN,KAAK;;;;SACL,MAAM;;;;SACN,MAAM;;;;SACN,MAAM;;;;;;;;;SAKN,MAAM,OAAC;SACP,UAAU"}

package/dist/types/ts/Assertions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Use this type to reference a plain object with
+ * random string keys.
+ */
+export interface Plain {
+    [key: string]: any;
+}
+/**
+ * Any JSON-serialisable type.
+ */
+export type JSONPrimitive = string | number | boolean | null;
+export type JSONArray = JSONValue[];
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export type JSONValue = JSONPrimitive | JSONObject | JSONArray;
+/**
+ * Type predicates to be used in type-narrowing assertions, e.g.
+ *
+ *   assert(notNull(someValue))
+ *   ... now the type of someValue does not include null ...
+ *
+ * or
+ *  if (isOk(returnValue)) {
+ *     ...in this block we know returnValue.ok is present and of the correct type.
+ *  }
+ *
+ * @param value the value to be tested.
+ * @returns true if not null, otherwise false.
+ */
+export declare function notNull<T>(value: T | null): value is T;
+export declare function isDefined<T>(value: T | undefined): value is T;
+//# sourceMappingURL=Assertions.d.ts.map

package/dist/types/ts/Assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Assertions.d.ts","sourceRoot":"","sources":["../../../ts/Assertions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,KAAK;IAEpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AAC5D,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAA;AACnC,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACzB;AACD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAA;AAG9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAEtD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAE7D"}

package/dist/types/ts/Lifecycle.d.ts

@@ -0,0 +1,102 @@
+import { Plain } from './Assertions.ts';
+import { Token, Scope } from '../js/Token.js';
+export interface DaemonConfig {
+    system: {
+        protocol: 'http:' | 'https:';
+        party: string;
+        issuer: string;
+        source: string;
+        sourcePrefix: string;
+        tab: string;
+        privateJwk: JsonWebKey;
+    };
+    user: Plain;
+}
+export declare const DAEMON_PREFIX = "daemon";
+export declare const CONFIG_PATH = "config";
+export declare const EVENT_PATH = "event";
+/**
+ * Encapsulates the lifecycle event requests that occur on
+ * runner start and termination and when alerts are resolved
+ * or rejected.
+ *
+ * The Lifecycle object also provides static methods to retrieve
+ * configuration items, a public and private key pair, and also to
+ * produce the signed token that is required in requests from this party
+ * to third parties.
+ */
+export declare class Lifecycle extends EventTarget {
+    #private;
+    static Ev: {
+        Config: string;
+    };
+    static getInstance(): Lifecycle;
+    /**
+     * All system requests are under the /daemon/ path.
+     *
+     * @param {Request} request to be tested.
+     * @returns {boolean} true if the request is a lifecycle request.
+     */
+    static shouldHandle(request: Request): boolean;
+    static isConfig(request: Request): boolean;
+    static isEvent(request: Request): boolean;
+    /**
+     * Handles a lifecycle request.
+     *
+     * @param {Request} request to be handled.
+     * @returns {Response} response for caller.
+     */
+    handler(request: Request): Promise<Response>;
+    /**
+     * Saves the lifecycle config object provided in the request body.
+     *
+     * Fires a 'config' lifecycle event.
+     *
+     * @param {Request} request containing the configuration json.
+     * @return {Response} ok response.
+     */
+    handleConfig(request: Request): Promise<Response>;
+    /**
+     * Fires a lifecycle event upon receiving an event request.
+     *
+     * @param {Request} request containing the event.
+     * @return {Response} ok response.
+     */
+    handleEvent(request: Request): Promise<Response>;
+    /**
+     * Returns the configuration object stored on initialisation.
+     * @return {DaemonConfig} the daemon configuration object.
+     * @throws {string} exception if config is not yet initialised.
+     */
+    static getConfig(): DaemonConfig;
+    /**
+     * Generates if necessary and returns a private key for
+     * use in signing tokens.
+     *
+     * @returns {JSONWebKey} the private key for this session.
+     */
+    static getPrivateKey(): Promise<JsonWebKey>;
+    /**
+     * Returns a token suitable for the `x-tabserver-token` header
+     * in a request to the supplied party with the required
+     * scope.
+     *
+     * If party is omitted, it defaults to this party.
+     * If
+     *
+     * @param {Scope} scope map of string source -> space-separated capabilities.
+     * @param {string=} party the party host name to whom the request will be sent.
+     * @param { src=} src the HTML page from which the request is (actually or notionally) made.
+     * @param {number=} ttlMillis the lifetime of this token.
+     * @returns {Token} the signed token.
+     * @throws {string} if configuration not yet initialised.
+     *
+    */
+    static getTokenFor(scope: Scope, party?: string | null, src?: string | null, ttlMillis?: number): Promise<Token>;
+    /**
+     * Returns a token for our party with the setitem and getitem
+     * capabilities on the party control source.
+     */
+    static getStorageToken(): Promise<Token>;
+}
+//# sourceMappingURL=Lifecycle.d.ts.map

package/dist/types/ts/Lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../../ts/Lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAa,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAG7C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAA;QAC5B,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,MAAM,CAAA;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,UAAU,CAAA;KACvB,CAAA;IACD,IAAI,EAAE,KAAK,CAAA;CACZ;AAGD,eAAO,MAAM,aAAa,WAAW,CAAA;AAGrC,eAAO,MAAM,WAAW,WAAW,CAAA;AACnC,eAAO,MAAM,UAAU,UAAU,CAAA;AAkBjC;;;;;;;;;GASG;AACH,qBAAa,SAAU,SAAQ,WAAW;;IAIxC,MAAM,CAAC,EAAE;;MAAK;IAEd,MAAM,CAAC,WAAW;IAIlB;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAO9C,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAS1C,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IASzC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYlD;;;;;;;OAOG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWvD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAatD;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,YAAY;IAQhC;;;;;OAKG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAS3C;;;;;;;;;;;;;;;MAeE;WACW,WAAW,CACtB,KAAK,EAAE,KAAK,EACZ,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,GAAG,GAAE,MAAM,GAAG,IAAW,EACzB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,KAAK,CAAC;IAsCjB;;;OAGG;IACH,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;CAazC"}

package/dist/types/ts/Requests.d.ts

@@ -0,0 +1,69 @@
+import { Plain } from "./Assertions.ts";
+/**
+ * Returns the request protocol. This is the first of the following:
+ *
+ * 1. The `x-forwarded-proto` header, if present, with trailing colon.
+ * 2. The request URL protocol, ditto.
+ *
+ * @param request the request.
+ * @returns {string} the protocol with trailing colon.
+ */
+export declare function getClientProtocol(request: Request): string;
+/**
+ * Returns the request host name. This is the first of the following:
+ *
+ * 1. The `x-forwarded-host` header, if present.
+ * 2. The request URL hostname (including port, if present)
+ *
+ * @param request the request.
+ * @returns the protocol.
+ */
+export declare function getClientHost(request: Request): string;
+/**
+ * Returns the request pathname. This is the first of the following:
+ *
+ * 1. The `x-forwarded-pathname` header, if present.
+ * 2. The request URL pathname.
+ */
+export declare function getClientPathname(request: Request): string;
+/**
+ * Returns the client request protocol, host and pathname components
+ * only.
+ *
+ * @param request the request.
+ * @return {URL} the protocol://host/pathname
+ */
+export declare function getClientUrlPhp(request: Request): URL;
+/**
+ * Returns the URL as requested by the client taking account
+ * of the x-forwarded protocol and host.
+ *
+ * @param request the request.
+ * @returns the URL.
+ */
+export declare function getClientUrl(request: Request): URL;
+/**
+ * Returns the pathname portion of the request URL, excluding
+ * query and fragment components.
+ *
+ * @param {request} the request.
+ * @returns {string} the pathname which starts with a forward slash.
+ */
+export declare function getPathname(request: Request): string;
+/**
+ * Returns the string value of a named cookie, or null if it is not
+ * present in the request.
+ *
+ * @param {Request} request the request.
+ * @param {string} cookieName the name of the cookie
+ * @returns {string} the cookie value, or null if not present.
+ */
+export declare function getCookie(request: Request, cookieName: string): string | null;
+/**
+ * Returns a map of request cookie names to values, which can be empty.
+ *
+ * @param {Request} request the request.
+ * @returns {Plain} the plain object with zero or more cookie keys.
+ */
+export declare function getCookies(request: Request): Plain;
+//# sourceMappingURL=Requests.d.ts.map

package/dist/types/ts/Requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Requests.d.ts","sourceRoot":"","sources":["../../../ts/Requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AASxC;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM1D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGpD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAUlD"}

package/dist/types/ts/Responses.d.ts

@@ -0,0 +1,54 @@
+import { Plain } from './Assertions.ts';
+export interface Ok<T> {
+    ok: T;
+}
+export interface Error {
+    error: string;
+}
+/**
+ * Returns an ok response or an error response corresponding
+ * to the standard ok or error return value.
+ *
+ * If the error string starts with a space-separated status code,
+ * then that is used as the status code for the response.
+ *
+ * For example:
+ *
+ * {error: 'Ordinary Error'}
+ *   is sent as is with status 200.
+ * {error: '401 Authentication Error'}
+ *   is sent as {error: 'Authentication Error'} with status 401
+ */
+export declare function response<T>(rvalue: Ok<T> | Error, extraHeaders?: Plain): Response;
+/**
+ * Returns a 404 error response, including
+ * the standard JSON error return value.
+ * @deprecated Use response instead using a status-prefixed error message.
+ */
+export declare function response404<T>(json?: Error): Response;
+/**
+ * Returns a 302 permanent redirect response.
+ * @param url the url to redirect to.
+ * @returns Response object.
+ */
+export declare function response302(url: URL, extraHeaders?: Plain): Response;
+/**
+ * Simple build-a-cookie support.
+ *
+ * If the `expires` attribute is not defined, it's a session cookie.
+ * Otherwise it's a permanent cookie. To delete a cookie, use the
+ * `expires` attribute set to `new Date(0)`.
+ */
+export interface CookiePayload {
+    name: string;
+    value: string;
+    domain?: string;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    path?: string;
+    expires?: Date;
+    secure?: boolean;
+    httpOnly?: boolean;
+}
+export type CookieString = string;
+export declare function buildCookie(payload: CookiePayload): CookieString;
+//# sourceMappingURL=Responses.d.ts.map

package/dist/types/ts/Responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Responses.d.ts","sourceRoot":"","sources":["../../../ts/Responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC,MAAM,WAAW,EAAE,CAAC,CAAC;IACnB,EAAE,EAAE,CAAC,CAAA;CACN;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,YAAY,CAAC,EAAE,KAAK,YA2BtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAE,KAEpC,YASA;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,GAAE,KAAU,GAAG,QAAQ,CASxE;AAED;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAuBhE"}

package/package.json

@@ -2,10 +2,11 @@
   "name": "webdaemon",
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/types/index.d.ts",
   "files": [
     "dist"
   ],
-  "version": "11.5.1",
+  "version": "12.0.0",
   "description": "Web Daemon",
   "module": "./dist/index.js",
   "keywords": [
@@ -19,6 +20,10 @@
     "typescript": "^5.7.2"
   },
   "scripts": {
-    "build": "node esbuild.esm.js"
+    "build": "deno --allow-all esbuild.esm.js && tsc --project tsconfig.json",
+    "types": "tsc --project tsconfig.json"
+  },
+  "bin": {
+    "test": "./bin/test.js"
   }
 }