@webiny/aws-helpers 5.43.3 → 6.0.0-alpha.1

package/cloudfrontFunctions/cookies.d.ts

@@ -0,0 +1,8 @@
+import type { CloudFrontResponse } from "./types";
+export interface CookieParams {
+    name: string;
+    value: string;
+    maxAge?: number;
+}
+/** Sets cookie for the HTTP response */
+export declare function setResponseCookie(response: CloudFrontResponse, cookie: CookieParams): void;

package/cloudfrontFunctions/cookies.js

@@ -0,0 +1,28 @@
+/** Sets cookie for the HTTP response */
+export function setResponseCookie(response, cookie) {
+  const cookies = response.cookies || (response.cookies = {});
+  const current = cookies[cookie.name];
+  let attrs = `Secure; Path=/;`;
+  if (cookie.maxAge) {
+    attrs += ` Max-Age=${cookie.maxAge};`;
+  }
+  if (current) {
+    // If there is already the same cookie set in a response,
+    // we add another entry using `multivalue`.
+    // This is how you set multiple same cookies in CloudFront Functions.
+    // It DOES make sense to set the same cookie multiple times,
+    // for example when dealing with SameSite issue (https://web.dev/samesite-cookies-explained/)
+    const multivalue = current.multivalue ?? (current.multivalue = []);
+    multivalue.push({
+      value: cookie.value,
+      attributes: attrs
+    });
+  } else {
+    cookies[cookie.name] = {
+      value: cookie.value,
+      attributes: attrs
+    };
+  }
+}
+
+//# sourceMappingURL=cookies.js.map

package/cloudfrontFunctions/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setResponseCookie","response","cookie","cookies","current","name","attrs","maxAge","multivalue","push","value","attributes"],"sources":["cookies.ts"],"sourcesContent":["import type { CloudFrontResponse } from \"./types\";\n\nexport interface CookieParams {\n    name: string;\n    value: string;\n    maxAge?: number;\n}\n\n/** Sets cookie for the HTTP response */\nexport function setResponseCookie(response: CloudFrontResponse, cookie: CookieParams) {\n    const cookies = response.cookies || (response.cookies = {});\n\n    const current = cookies[cookie.name];\n    let attrs = `Secure; Path=/;`;\n\n    if (cookie.maxAge) {\n        attrs += ` Max-Age=${cookie.maxAge};`;\n    }\n\n    if (current) {\n        // If there is already the same cookie set in a response,\n        // we add another entry using `multivalue`.\n        // This is how you set multiple same cookies in CloudFront Functions.\n        // It DOES make sense to set the same cookie multiple times,\n        // for example when dealing with SameSite issue (https://web.dev/samesite-cookies-explained/)\n        const multivalue = current.multivalue ?? (current.multivalue = []);\n        multivalue.push({\n            value: cookie.value,\n            attributes: attrs\n        });\n    } else {\n        cookies[cookie.name] = {\n            value: cookie.value,\n            attributes: attrs\n        };\n    }\n}\n"],"mappings":"AAQA;AACA,OAAO,SAASA,iBAAiBA,CAACC,QAA4B,EAAEC,MAAoB,EAAE;EAClF,MAAMC,OAAO,GAAGF,QAAQ,CAACE,OAAO,KAAKF,QAAQ,CAACE,OAAO,GAAG,CAAC,CAAC,CAAC;EAE3D,MAAMC,OAAO,GAAGD,OAAO,CAACD,MAAM,CAACG,IAAI,CAAC;EACpC,IAAIC,KAAK,GAAG,iBAAiB;EAE7B,IAAIJ,MAAM,CAACK,MAAM,EAAE;IACfD,KAAK,IAAI,YAAYJ,MAAM,CAACK,MAAM,GAAG;EACzC;EAEA,IAAIH,OAAO,EAAE;IACT;IACA;IACA;IACA;IACA;IACA,MAAMI,UAAU,GAAGJ,OAAO,CAACI,UAAU,KAAKJ,OAAO,CAACI,UAAU,GAAG,EAAE,CAAC;IAClEA,UAAU,CAACC,IAAI,CAAC;MACZC,KAAK,EAAER,MAAM,CAACQ,KAAK;MACnBC,UAAU,EAAEL;IAChB,CAAC,CAAC;EACN,CAAC,MAAM;IACHH,OAAO,CAACD,MAAM,CAACG,IAAI,CAAC,GAAG;MACnBK,KAAK,EAAER,MAAM,CAACQ,KAAK;MACnBC,UAAU,EAAEL;IAChB,CAAC;EACL;AACJ","ignoreList":[]}

package/cloudfrontFunctions/headers.d.ts

@@ -0,0 +1,5 @@
+import type { CloudFrontHeaders, Header } from "./types";
+export declare function getHeader(headers: CloudFrontHeaders, header: string): string | undefined;
+export declare function setHeader(headers: CloudFrontHeaders, header: Header): void;
+export declare function setHeaders(headers: CloudFrontHeaders, headersToSet: Header[]): void;
+export declare function setNoCacheHeaders(headers: CloudFrontHeaders): void;

package/cloudfrontFunctions/headers.js

@@ -0,0 +1,26 @@
+export function getHeader(headers, header) {
+  return headers[header]?.value;
+}
+export function setHeader(headers, header) {
+  headers[header.key] = {
+    value: header.value
+  };
+}
+export function setHeaders(headers, headersToSet) {
+  for (let i = 0; i < headersToSet.length; i++) {
+    setHeader(headers, headersToSet[i]);
+  }
+}
+export function setNoCacheHeaders(headers) {
+  headers["cache-control"] = {
+    value: "no-cache, no-store, must-revalidate"
+  };
+  headers["pragma"] = {
+    value: "no-cache"
+  };
+  headers["expires"] = {
+    value: "0"
+  };
+}
+
+//# sourceMappingURL=headers.js.map

package/cloudfrontFunctions/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getHeader","headers","header","value","setHeader","key","setHeaders","headersToSet","i","length","setNoCacheHeaders"],"sources":["headers.ts"],"sourcesContent":["import type { CloudFrontHeaders, Header } from \"./types\";\n\nexport function getHeader(headers: CloudFrontHeaders, header: string) {\n    return headers[header]?.value;\n}\n\nexport function setHeader(headers: CloudFrontHeaders, header: Header) {\n    headers[header.key] = {\n        value: header.value\n    };\n}\n\nexport function setHeaders(headers: CloudFrontHeaders, headersToSet: Header[]) {\n    for (let i = 0; i < headersToSet.length; i++) {\n        setHeader(headers, headersToSet[i]);\n    }\n}\n\nexport function setNoCacheHeaders(headers: CloudFrontHeaders) {\n    headers[\"cache-control\"] = { value: \"no-cache, no-store, must-revalidate\" };\n    headers[\"pragma\"] = { value: \"no-cache\" };\n    headers[\"expires\"] = { value: \"0\" };\n}\n"],"mappings":"AAEA,OAAO,SAASA,SAASA,CAACC,OAA0B,EAAEC,MAAc,EAAE;EAClE,OAAOD,OAAO,CAACC,MAAM,CAAC,EAAEC,KAAK;AACjC;AAEA,OAAO,SAASC,SAASA,CAACH,OAA0B,EAAEC,MAAc,EAAE;EAClED,OAAO,CAACC,MAAM,CAACG,GAAG,CAAC,GAAG;IAClBF,KAAK,EAAED,MAAM,CAACC;EAClB,CAAC;AACL;AAEA,OAAO,SAASG,UAAUA,CAACL,OAA0B,EAAEM,YAAsB,EAAE;EAC3E,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGD,YAAY,CAACE,MAAM,EAAED,CAAC,EAAE,EAAE;IAC1CJ,SAAS,CAACH,OAAO,EAAEM,YAAY,CAACC,CAAC,CAAC,CAAC;EACvC;AACJ;AAEA,OAAO,SAASE,iBAAiBA,CAACT,OAA0B,EAAE;EAC1DA,OAAO,CAAC,eAAe,CAAC,GAAG;IAAEE,KAAK,EAAE;EAAsC,CAAC;EAC3EF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAEE,KAAK,EAAE;EAAW,CAAC;EACzCF,OAAO,CAAC,SAAS,CAAC,GAAG;IAAEE,KAAK,EAAE;EAAI,CAAC;AACvC","ignoreList":[]}

package/cloudfrontFunctions/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./cookies";
+export * from "./headers";
+export * from "./querystring";
+export * from "./redirect";
+export * from "./types";
+export * from "./utils";

package/cloudfrontFunctions/index.js

@@ -0,0 +1,8 @@
+export * from "./cookies";
+export * from "./headers";
+export * from "./querystring";
+export * from "./redirect";
+export * from "./types";
+export * from "./utils";
+
+//# sourceMappingURL=index.js.map

package/cloudfrontFunctions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["index.ts"],"sourcesContent":["export * from \"./cookies\";\nexport * from \"./headers\";\nexport * from \"./querystring\";\nexport * from \"./redirect\";\nexport * from \"./types\";\nexport * from \"./utils\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/cloudfrontFunctions/querystring.d.ts

@@ -0,0 +1,2 @@
+import type { CloudFrontQuery } from "./types";
+export declare function stringifyQuery(query: CloudFrontQuery): string;

package/cloudfrontFunctions/querystring.js

@@ -0,0 +1,31 @@
+export function stringifyQuery(query) {
+  let qs = "";
+  for (const key of Object.keys(query)) {
+    const value = query[key];
+    if (!value) {
+      continue;
+    }
+    qs = appendQueryString(qs, key, value?.value);
+    if (value.multivalue) {
+      for (let i = 0; i < value.multivalue.length; i++) {
+        qs = appendQueryString(qs, key, value.multivalue[i].value);
+      }
+    }
+  }
+  if (qs) {
+    qs = "?" + qs;
+  }
+  return qs;
+}
+function appendQueryString(qs, key, value) {
+  if (value === null) {
+    return qs;
+  }
+  if (qs.length) {
+    qs += "&";
+  }
+  qs += `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+  return qs;
+}
+
+//# sourceMappingURL=querystring.js.map

package/cloudfrontFunctions/querystring.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["stringifyQuery","query","qs","key","Object","keys","value","appendQueryString","multivalue","i","length","encodeURIComponent"],"sources":["querystring.ts"],"sourcesContent":["import type { CloudFrontQuery } from \"./types\";\n\nexport function stringifyQuery(query: CloudFrontQuery) {\n    let qs = \"\";\n\n    for (const key of Object.keys(query)) {\n        const value = query[key];\n        if (!value) {\n            continue;\n        }\n\n        qs = appendQueryString(qs, key, value?.value);\n\n        if (value.multivalue) {\n            for (let i = 0; i < value.multivalue.length; i++) {\n                qs = appendQueryString(qs, key, value.multivalue[i].value);\n            }\n        }\n    }\n\n    if (qs) {\n        qs = \"?\" + qs;\n    }\n\n    return qs;\n}\n\nfunction appendQueryString(qs: string, key: string, value: string | null) {\n    if (value === null) {\n        return qs;\n    }\n\n    if (qs.length) {\n        qs += \"&\";\n    }\n\n    qs += `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;\n\n    return qs;\n}\n"],"mappings":"AAEA,OAAO,SAASA,cAAcA,CAACC,KAAsB,EAAE;EACnD,IAAIC,EAAE,GAAG,EAAE;EAEX,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,EAAE;IAClC,MAAMK,KAAK,GAAGL,KAAK,CAACE,GAAG,CAAC;IACxB,IAAI,CAACG,KAAK,EAAE;MACR;IACJ;IAEAJ,EAAE,GAAGK,iBAAiB,CAACL,EAAE,EAAEC,GAAG,EAAEG,KAAK,EAAEA,KAAK,CAAC;IAE7C,IAAIA,KAAK,CAACE,UAAU,EAAE;MAClB,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGH,KAAK,CAACE,UAAU,CAACE,MAAM,EAAED,CAAC,EAAE,EAAE;QAC9CP,EAAE,GAAGK,iBAAiB,CAACL,EAAE,EAAEC,GAAG,EAAEG,KAAK,CAACE,UAAU,CAACC,CAAC,CAAC,CAACH,KAAK,CAAC;MAC9D;IACJ;EACJ;EAEA,IAAIJ,EAAE,EAAE;IACJA,EAAE,GAAG,GAAG,GAAGA,EAAE;EACjB;EAEA,OAAOA,EAAE;AACb;AAEA,SAASK,iBAAiBA,CAACL,EAAU,EAAEC,GAAW,EAAEG,KAAoB,EAAE;EACtE,IAAIA,KAAK,KAAK,IAAI,EAAE;IAChB,OAAOJ,EAAE;EACb;EAEA,IAAIA,EAAE,CAACQ,MAAM,EAAE;IACXR,EAAE,IAAI,GAAG;EACb;EAEAA,EAAE,IAAI,GAAGS,kBAAkB,CAACR,GAAG,CAAC,IAAIQ,kBAAkB,CAACL,KAAK,CAAC,EAAE;EAE/D,OAAOJ,EAAE;AACb","ignoreList":[]}

package/cloudfrontFunctions/redirect.d.ts

@@ -0,0 +1,8 @@
+import type { CloudFrontQuery, CloudFrontResponse } from "./types";
+interface RedirectParams {
+    url: string;
+    query?: CloudFrontQuery;
+    status?: number;
+}
+export declare function redirectResponse(params: RedirectParams): CloudFrontResponse;
+export {};

package/cloudfrontFunctions/redirect.js

@@ -0,0 +1,22 @@
+import { setNoCacheHeaders } from "./headers";
+import { stringifyQuery } from "./querystring";
+export function redirectResponse(params) {
+  const query = params.query ? stringifyQuery(params.query) : "";
+  const permanent = params.status === 301;
+  const response = {
+    statusCode: params.status || 302,
+    statusDescription: params.status === 301 ? "Moved permanently" : "Found",
+    headers: {
+      location: {
+        value: params.url + query
+      }
+    }
+  };
+  if (!permanent) {
+    // For temporary redirects make sure they won't be cached.
+    setNoCacheHeaders(response.headers);
+  }
+  return response;
+}
+
+//# sourceMappingURL=redirect.js.map

package/cloudfrontFunctions/redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setNoCacheHeaders","stringifyQuery","redirectResponse","params","query","permanent","status","response","statusCode","statusDescription","headers","location","value","url"],"sources":["redirect.ts"],"sourcesContent":["import type { CloudFrontQuery, CloudFrontResponse } from \"./types\";\nimport { setNoCacheHeaders } from \"./headers\";\nimport { stringifyQuery } from \"./querystring\";\n\ninterface RedirectParams {\n    url: string;\n    query?: CloudFrontQuery;\n    status?: number;\n}\n\nexport function redirectResponse(params: RedirectParams) {\n    const query = params.query ? stringifyQuery(params.query) : \"\";\n    const permanent = params.status === 301;\n\n    const response: CloudFrontResponse = {\n        statusCode: params.status || 302,\n        statusDescription: params.status === 301 ? \"Moved permanently\" : \"Found\",\n        headers: {\n            location: { value: params.url + query }\n        }\n    };\n\n    if (!permanent) {\n        // For temporary redirects make sure they won't be cached.\n        setNoCacheHeaders(response.headers);\n    }\n\n    return response;\n}\n"],"mappings":"AACA,SAASA,iBAAiB;AAC1B,SAASC,cAAc;AAQvB,OAAO,SAASC,gBAAgBA,CAACC,MAAsB,EAAE;EACrD,MAAMC,KAAK,GAAGD,MAAM,CAACC,KAAK,GAAGH,cAAc,CAACE,MAAM,CAACC,KAAK,CAAC,GAAG,EAAE;EAC9D,MAAMC,SAAS,GAAGF,MAAM,CAACG,MAAM,KAAK,GAAG;EAEvC,MAAMC,QAA4B,GAAG;IACjCC,UAAU,EAAEL,MAAM,CAACG,MAAM,IAAI,GAAG;IAChCG,iBAAiB,EAAEN,MAAM,CAACG,MAAM,KAAK,GAAG,GAAG,mBAAmB,GAAG,OAAO;IACxEI,OAAO,EAAE;MACLC,QAAQ,EAAE;QAAEC,KAAK,EAAET,MAAM,CAACU,GAAG,GAAGT;MAAM;IAC1C;EACJ,CAAC;EAED,IAAI,CAACC,SAAS,EAAE;IACZ;IACAL,iBAAiB,CAACO,QAAQ,CAACG,OAAO,CAAC;EACvC;EAEA,OAAOH,QAAQ;AACnB","ignoreList":[]}

package/cloudfrontFunctions/types.d.ts

@@ -0,0 +1,78 @@
+export interface SingleValue {
+    value: string;
+}
+export interface Header extends SingleValue {
+    key: string;
+}
+export interface ResponseCookie extends SingleValue {
+    attributes?: string;
+}
+/**
+ * In principle you may have multiple same headers and cookies in one request or response.
+ * This is a wrapper interface for simpler use.
+ */
+export type MultiValue<T> = T & {
+    /** Additional values for the same item (for example multiple values for the same cookie.) */
+    multivalue?: T[];
+};
+export type MultiValueDictionary<T> = Record<string, MultiValue<T> | undefined>;
+export type CloudFrontHeaders = MultiValueDictionary<SingleValue>;
+export type CloudFrontRequestCookies = MultiValueDictionary<SingleValue>;
+export type CloudFrontResponseCookies = MultiValueDictionary<ResponseCookie>;
+export type CloudFrontQuery = MultiValueDictionary<SingleValue>;
+/**
+ * Interface type for request in CloudFront Functions
+ * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html
+ */
+export interface CloudFrontRequest {
+    method: string;
+    uri: string;
+    querystring?: CloudFrontQuery;
+    headers: CloudFrontHeaders;
+    cookies?: CloudFrontRequestCookies;
+}
+/**
+ * Interface type for response in CloudFront Functions
+ * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html
+ */
+export interface CloudFrontResponse {
+    statusCode: number;
+    statusDescription?: string;
+    headers: CloudFrontHeaders;
+    cookies?: CloudFrontResponseCookies;
+}
+/**
+ * Interface type for request event in CloudFront Functions
+ * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html
+ */
+export interface CloudFrontRequestEvent {
+    version: string;
+    context: {
+        eventType: "viewer-request";
+    };
+    viewer: {
+        ip: string;
+    };
+    request: CloudFrontRequest;
+}
+/**
+ * Interface type for response event in CloudFront Functions
+ * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html
+ */
+export interface CloudFrontResponseEvent {
+    version: string;
+    context: {
+        eventType: "viewer-response";
+    };
+    viewer: {
+        ip: string;
+    };
+    response: CloudFrontResponse;
+    request: CloudFrontRequest;
+}
+export interface CloudFrontRequestHandler {
+    (event: CloudFrontRequestEvent): CloudFrontRequest | CloudFrontResponse;
+}
+export interface CloudFrontResponseHandler {
+    (event: CloudFrontResponseEvent): CloudFrontResponse;
+}

package/cloudfrontFunctions/types.js

@@ -0,0 +1,3 @@
+export {};
+
+//# sourceMappingURL=types.js.map

package/cloudfrontFunctions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["// These are types for CloudFront Functions.\n// They differ from Lambda@Edge types.\n// See also: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html\n\nexport interface SingleValue {\n    value: string;\n}\n\nexport interface Header extends SingleValue {\n    key: string;\n}\n\nexport interface ResponseCookie extends SingleValue {\n    attributes?: string;\n}\n\n/**\n * In principle you may have multiple same headers and cookies in one request or response.\n * This is a wrapper interface for simpler use.\n */\nexport type MultiValue<T> = T & {\n    /** Additional values for the same item (for example multiple values for the same cookie.) */\n    multivalue?: T[];\n};\n\nexport type MultiValueDictionary<T> = Record<string, MultiValue<T> | undefined>;\n\nexport type CloudFrontHeaders = MultiValueDictionary<SingleValue>;\nexport type CloudFrontRequestCookies = MultiValueDictionary<SingleValue>;\nexport type CloudFrontResponseCookies = MultiValueDictionary<ResponseCookie>;\nexport type CloudFrontQuery = MultiValueDictionary<SingleValue>;\n\n/**\n * Interface type for request in CloudFront Functions\n * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html\n */\nexport interface CloudFrontRequest {\n    method: string;\n    uri: string;\n    querystring?: CloudFrontQuery;\n    headers: CloudFrontHeaders;\n    cookies?: CloudFrontRequestCookies;\n}\n\n/**\n * Interface type for response in CloudFront Functions\n * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html\n */\nexport interface CloudFrontResponse {\n    statusCode: number;\n    statusDescription?: string;\n    headers: CloudFrontHeaders;\n    cookies?: CloudFrontResponseCookies;\n}\n\n/**\n * Interface type for request event in CloudFront Functions\n * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html\n */\nexport interface CloudFrontRequestEvent {\n    version: string;\n    context: {\n        eventType: \"viewer-request\";\n    };\n    viewer: {\n        ip: string;\n    };\n    request: CloudFrontRequest;\n}\n\n/**\n * Interface type for response event in CloudFront Functions\n * see: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/functions-event-structure.html\n */\nexport interface CloudFrontResponseEvent {\n    version: string;\n    context: {\n        eventType: \"viewer-response\";\n    };\n    viewer: {\n        ip: string;\n    };\n    response: CloudFrontResponse;\n    request: CloudFrontRequest;\n}\n\nexport interface CloudFrontRequestHandler {\n    (event: CloudFrontRequestEvent): CloudFrontRequest | CloudFrontResponse;\n}\n\nexport interface CloudFrontResponseHandler {\n    (event: CloudFrontResponseEvent): CloudFrontResponse;\n}\n"],"mappings":"","ignoreList":[]}

package/cloudfrontFunctions/utils.d.ts

@@ -0,0 +1,17 @@
+import type { CloudFrontRequestHandler, CloudFrontResponseHandler } from "./types";
+/**
+ * Helper function to easier define CloudFront Function request handler.
+ *
+ * Lambdas use exports, but CloudFront Functions use a global `handler` variable.
+ * This way you only have to run the function within your handler script,
+ * and you are provided with working handler and full typing.
+ **/
+export declare function defineCloudfrontFunctionRequestHandler(handler: CloudFrontRequestHandler): void;
+/**
+ * Helper function to easier define CloudFront Function response handler.
+ *
+ * Lambdas use exports, but CloudFront Functions use a global `handler` variable.
+ * This way you only have to run the function within your handler script,
+ * and you are provided with working handler and full typing.
+ **/
+export declare function defineCloudfrontFunctionResponseHandler(handler: CloudFrontResponseHandler): void;

package/cloudfrontFunctions/utils.js

@@ -0,0 +1,23 @@
+/**
+ * Helper function to easier define CloudFront Function request handler.
+ *
+ * Lambdas use exports, but CloudFront Functions use a global `handler` variable.
+ * This way you only have to run the function within your handler script,
+ * and you are provided with working handler and full typing.
+ **/
+export function defineCloudfrontFunctionRequestHandler(handler) {
+  global.handler = handler;
+}
+
+/**
+ * Helper function to easier define CloudFront Function response handler.
+ *
+ * Lambdas use exports, but CloudFront Functions use a global `handler` variable.
+ * This way you only have to run the function within your handler script,
+ * and you are provided with working handler and full typing.
+ **/
+export function defineCloudfrontFunctionResponseHandler(handler) {
+  global.handler = handler;
+}
+
+//# sourceMappingURL=utils.js.map

package/cloudfrontFunctions/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineCloudfrontFunctionRequestHandler","handler","global","defineCloudfrontFunctionResponseHandler"],"sources":["utils.ts"],"sourcesContent":["import type { CloudFrontRequestHandler, CloudFrontResponseHandler } from \"./types\";\n\ndeclare const global: typeof globalThis & {\n    // CloudFront Functions use global handler value, not exports.\n    /**\n     * We will leave the Function for now.\n     */\n    // eslint-disable-next-line @typescript-eslint/ban-types\n    handler: Function;\n};\n\n/**\n * Helper function to easier define CloudFront Function request handler.\n *\n * Lambdas use exports, but CloudFront Functions use a global `handler` variable.\n * This way you only have to run the function within your handler script,\n * and you are provided with working handler and full typing.\n **/\nexport function defineCloudfrontFunctionRequestHandler(handler: CloudFrontRequestHandler) {\n    global.handler = handler;\n}\n\n/**\n * Helper function to easier define CloudFront Function response handler.\n *\n * Lambdas use exports, but CloudFront Functions use a global `handler` variable.\n * This way you only have to run the function within your handler script,\n * and you are provided with working handler and full typing.\n **/\nexport function defineCloudfrontFunctionResponseHandler(handler: CloudFrontResponseHandler) {\n    global.handler = handler;\n}\n"],"mappings":"AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,sCAAsCA,CAACC,OAAiC,EAAE;EACtFC,MAAM,CAACD,OAAO,GAAGA,OAAO;AAC5B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,uCAAuCA,CAACF,OAAkC,EAAE;EACxFC,MAAM,CAACD,OAAO,GAAGA,OAAO;AAC5B","ignoreList":[]}

package/index.d.ts

@@ -0,0 +1 @@
+export * from "./lambdaEdge";

package/index.js

@@ -0,0 +1,3 @@
+export * from "./lambdaEdge";
+
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["index.ts"],"sourcesContent":["export * from \"./lambdaEdge\";\n"],"mappings":"AAAA","ignoreList":[]}

package/lambdaEdge/cookies.d.ts

@@ -0,0 +1,3 @@
+import type { CloudFrontRequest, CloudFrontResponse } from "./types";
+export declare function getRequestCookies(request: CloudFrontRequest): Record<string, string | undefined>;
+export declare function setResponseCookie(response: CloudFrontResponse, cookie: string): void;

package/lambdaEdge/cookies.js

@@ -0,0 +1,23 @@
+import { getHeader } from "./headers";
+export function getRequestCookies(request) {
+  const header = getHeader(request.headers, "cookie");
+  const cookies = {};
+  if (!header) {
+    return cookies;
+  }
+  const cookiesArray = decodeURIComponent(header).split(";");
+  for (const cookie of cookiesArray) {
+    const [name, value] = cookie.trim().split("=");
+    cookies[name] = value;
+  }
+  return cookies;
+}
+export function setResponseCookie(response, cookie) {
+  const headers = response.headers;
+  const cookies = headers["set-cookie"] || (headers["set-cookie"] = []);
+  cookies.push({
+    value: cookie
+  });
+}
+
+//# sourceMappingURL=cookies.js.map

package/lambdaEdge/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getHeader","getRequestCookies","request","header","headers","cookies","cookiesArray","decodeURIComponent","split","cookie","name","value","trim","setResponseCookie","response","push"],"sources":["cookies.ts"],"sourcesContent":["import { getHeader } from \"./headers\";\nimport type { CloudFrontRequest, CloudFrontResponse } from \"./types\";\n\nexport function getRequestCookies(request: CloudFrontRequest) {\n    const header = getHeader(request.headers, \"cookie\");\n    const cookies: Record<string, string | undefined> = {};\n\n    if (!header) {\n        return cookies;\n    }\n\n    const cookiesArray = decodeURIComponent(header).split(\";\");\n\n    for (const cookie of cookiesArray) {\n        const [name, value] = cookie.trim().split(\"=\");\n        cookies[name] = value;\n    }\n\n    return cookies;\n}\n\nexport function setResponseCookie(response: CloudFrontResponse, cookie: string) {\n    const headers = response.headers;\n    const cookies = headers[\"set-cookie\"] || (headers[\"set-cookie\"] = []);\n\n    cookies.push({\n        value: cookie\n    });\n}\n"],"mappings":"AAAA,SAASA,SAAS;AAGlB,OAAO,SAASC,iBAAiBA,CAACC,OAA0B,EAAE;EAC1D,MAAMC,MAAM,GAAGH,SAAS,CAACE,OAAO,CAACE,OAAO,EAAE,QAAQ,CAAC;EACnD,MAAMC,OAA2C,GAAG,CAAC,CAAC;EAEtD,IAAI,CAACF,MAAM,EAAE;IACT,OAAOE,OAAO;EAClB;EAEA,MAAMC,YAAY,GAAGC,kBAAkB,CAACJ,MAAM,CAAC,CAACK,KAAK,CAAC,GAAG,CAAC;EAE1D,KAAK,MAAMC,MAAM,IAAIH,YAAY,EAAE;IAC/B,MAAM,CAACI,IAAI,EAAEC,KAAK,CAAC,GAAGF,MAAM,CAACG,IAAI,CAAC,CAAC,CAACJ,KAAK,CAAC,GAAG,CAAC;IAC9CH,OAAO,CAACK,IAAI,CAAC,GAAGC,KAAK;EACzB;EAEA,OAAON,OAAO;AAClB;AAEA,OAAO,SAASQ,iBAAiBA,CAACC,QAA4B,EAAEL,MAAc,EAAE;EAC5E,MAAML,OAAO,GAAGU,QAAQ,CAACV,OAAO;EAChC,MAAMC,OAAO,GAAGD,OAAO,CAAC,YAAY,CAAC,KAAKA,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;EAErEC,OAAO,CAACU,IAAI,CAAC;IACTJ,KAAK,EAAEF;EACX,CAAC,CAAC;AACN","ignoreList":[]}

package/lambdaEdge/headers.d.ts

@@ -0,0 +1,6 @@
+import type { CloudFrontHeaders } from "./types";
+export declare function setHeader(headers: CloudFrontHeaders, header: {
+    key: string;
+    value: string;
+}): void;
+export declare function getHeader(headers: CloudFrontHeaders | undefined, header: string): string | undefined;

package/lambdaEdge/headers.js

@@ -0,0 +1,8 @@
+export function setHeader(headers, header) {
+  headers[header.key] = [header];
+}
+export function getHeader(headers, header) {
+  return headers?.[header]?.[0].value;
+}
+
+//# sourceMappingURL=headers.js.map

package/lambdaEdge/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setHeader","headers","header","key","getHeader","value"],"sources":["headers.ts"],"sourcesContent":["import type { CloudFrontHeaders } from \"./types\";\n\nexport function setHeader(headers: CloudFrontHeaders, header: { key: string; value: string }) {\n    headers[header.key] = [header];\n}\n\nexport function getHeader(headers: CloudFrontHeaders | undefined, header: string) {\n    return headers?.[header]?.[0].value;\n}\n"],"mappings":"AAEA,OAAO,SAASA,SAASA,CAACC,OAA0B,EAAEC,MAAsC,EAAE;EAC1FD,OAAO,CAACC,MAAM,CAACC,GAAG,CAAC,GAAG,CAACD,MAAM,CAAC;AAClC;AAEA,OAAO,SAASE,SAASA,CAACH,OAAsC,EAAEC,MAAc,EAAE;EAC9E,OAAOD,OAAO,GAAGC,MAAM,CAAC,GAAG,CAAC,CAAC,CAACG,KAAK;AACvC","ignoreList":[]}

package/lambdaEdge/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./cookies";
+export * from "./headers";
+export * from "./redirect";
+export * from "./request";
+export * from "./response";
+export * from "./types";
+export * from "./utils";

package/lambdaEdge/index.js

@@ -0,0 +1,9 @@
+export * from "./cookies";
+export * from "./headers";
+export * from "./redirect";
+export * from "./request";
+export * from "./response";
+export * from "./types";
+export * from "./utils";
+
+//# sourceMappingURL=index.js.map

package/lambdaEdge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["index.ts"],"sourcesContent":["export * from \"./cookies\";\nexport * from \"./headers\";\nexport * from \"./redirect\";\nexport * from \"./request\";\nexport * from \"./response\";\nexport * from \"./types\";\nexport * from \"./utils\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lambdaEdge/redirect.d.ts

@@ -0,0 +1,8 @@
+import type { CloudFrontResponse } from "./types";
+interface RedirectParams {
+    url: string;
+    query?: string;
+    status?: number;
+}
+export declare function redirectResponse(params: RedirectParams): CloudFrontResponse;
+export {};

package/lambdaEdge/redirect.js

@@ -0,0 +1,32 @@
+import { setHeader } from "./headers";
+export function redirectResponse(params) {
+  const query = params.query || "";
+  const permanent = params.status === 301;
+  const response = {
+    status: String(params.status || 302),
+    statusDescription: permanent ? "Moved permanently" : "Found",
+    headers: {}
+  };
+  setHeader(response.headers, {
+    key: "location",
+    value: params.url + query
+  });
+  if (!permanent) {
+    // for temporary redirects make sure they won't be cached
+    setHeader(response.headers, {
+      key: "cache-control",
+      value: "no-cache, no-store, must-revalidate"
+    });
+    setHeader(response.headers, {
+      key: "pragma",
+      value: "no-cache"
+    });
+    setHeader(response.headers, {
+      key: "expires",
+      value: "0"
+    });
+  }
+  return response;
+}
+
+//# sourceMappingURL=redirect.js.map

package/lambdaEdge/redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setHeader","redirectResponse","params","query","permanent","status","response","String","statusDescription","headers","key","value","url"],"sources":["redirect.ts"],"sourcesContent":["import type { CloudFrontResponse } from \"./types\";\nimport { setHeader } from \"./headers\";\n\ninterface RedirectParams {\n    url: string;\n    query?: string;\n    status?: number;\n}\n\nexport function redirectResponse(params: RedirectParams): CloudFrontResponse {\n    const query = params.query || \"\";\n    const permanent = params.status === 301;\n\n    const response: CloudFrontResponse = {\n        status: String(params.status || 302),\n        statusDescription: permanent ? \"Moved permanently\" : \"Found\",\n        headers: {}\n    };\n\n    setHeader(response.headers, {\n        key: \"location\",\n        value: params.url + query\n    });\n\n    if (!permanent) {\n        // for temporary redirects make sure they won't be cached\n        setHeader(response.headers, {\n            key: \"cache-control\",\n            value: \"no-cache, no-store, must-revalidate\"\n        });\n        setHeader(response.headers, {\n            key: \"pragma\",\n            value: \"no-cache\"\n        });\n        setHeader(response.headers, {\n            key: \"expires\",\n            value: \"0\"\n        });\n    }\n\n    return response;\n}\n"],"mappings":"AACA,SAASA,SAAS;AAQlB,OAAO,SAASC,gBAAgBA,CAACC,MAAsB,EAAsB;EACzE,MAAMC,KAAK,GAAGD,MAAM,CAACC,KAAK,IAAI,EAAE;EAChC,MAAMC,SAAS,GAAGF,MAAM,CAACG,MAAM,KAAK,GAAG;EAEvC,MAAMC,QAA4B,GAAG;IACjCD,MAAM,EAAEE,MAAM,CAACL,MAAM,CAACG,MAAM,IAAI,GAAG,CAAC;IACpCG,iBAAiB,EAAEJ,SAAS,GAAG,mBAAmB,GAAG,OAAO;IAC5DK,OAAO,EAAE,CAAC;EACd,CAAC;EAEDT,SAAS,CAACM,QAAQ,CAACG,OAAO,EAAE;IACxBC,GAAG,EAAE,UAAU;IACfC,KAAK,EAAET,MAAM,CAACU,GAAG,GAAGT;EACxB,CAAC,CAAC;EAEF,IAAI,CAACC,SAAS,EAAE;IACZ;IACAJ,SAAS,CAACM,QAAQ,CAACG,OAAO,EAAE;MACxBC,GAAG,EAAE,eAAe;MACpBC,KAAK,EAAE;IACX,CAAC,CAAC;IACFX,SAAS,CAACM,QAAQ,CAACG,OAAO,EAAE;MACxBC,GAAG,EAAE,QAAQ;MACbC,KAAK,EAAE;IACX,CAAC,CAAC;IACFX,SAAS,CAACM,QAAQ,CAACG,OAAO,EAAE;MACxBC,GAAG,EAAE,SAAS;MACdC,KAAK,EAAE;IACX,CAAC,CAAC;EACN;EAEA,OAAOL,QAAQ;AACnB","ignoreList":[]}

package/lambdaEdge/request.d.ts

@@ -0,0 +1,2 @@
+import type { CloudFrontRequest } from "./types";
+export declare function setDomainOrigin(request: CloudFrontRequest, domain: string): void;

package/lambdaEdge/request.js

@@ -0,0 +1,21 @@
+import { setHeader } from "./headers";
+export function setDomainOrigin(request, domain) {
+  request.origin = {
+    custom: {
+      domainName: domain,
+      port: 443,
+      protocol: "https",
+      path: "",
+      sslProtocols: ["TLSv1", "TLSv1.1", "TLSv1.2"],
+      readTimeout: 5,
+      keepaliveTimeout: 5,
+      customHeaders: {}
+    }
+  };
+  setHeader(request.headers, {
+    key: "host",
+    value: domain
+  });
+}
+
+//# sourceMappingURL=request.js.map

package/lambdaEdge/request.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["setHeader","setDomainOrigin","request","domain","origin","custom","domainName","port","protocol","path","sslProtocols","readTimeout","keepaliveTimeout","customHeaders","headers","key","value"],"sources":["request.ts"],"sourcesContent":["import { setHeader } from \"./headers\";\nimport type { CloudFrontRequest } from \"./types\";\n\nexport function setDomainOrigin(request: CloudFrontRequest, domain: string) {\n    request.origin = {\n        custom: {\n            domainName: domain,\n            port: 443,\n            protocol: \"https\",\n            path: \"\",\n            sslProtocols: [\"TLSv1\", \"TLSv1.1\", \"TLSv1.2\"],\n            readTimeout: 5,\n            keepaliveTimeout: 5,\n            customHeaders: {}\n        }\n    };\n\n    setHeader(request.headers, {\n        key: \"host\",\n        value: domain\n    });\n}\n"],"mappings":"AAAA,SAASA,SAAS;AAGlB,OAAO,SAASC,eAAeA,CAACC,OAA0B,EAAEC,MAAc,EAAE;EACxED,OAAO,CAACE,MAAM,GAAG;IACbC,MAAM,EAAE;MACJC,UAAU,EAAEH,MAAM;MAClBI,IAAI,EAAE,GAAG;MACTC,QAAQ,EAAE,OAAO;MACjBC,IAAI,EAAE,EAAE;MACRC,YAAY,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;MAC7CC,WAAW,EAAE,CAAC;MACdC,gBAAgB,EAAE,CAAC;MACnBC,aAAa,EAAE,CAAC;IACpB;EACJ,CAAC;EAEDb,SAAS,CAACE,OAAO,CAACY,OAAO,EAAE;IACvBC,GAAG,EAAE,MAAM;IACXC,KAAK,EAAEb;EACX,CAAC,CAAC;AACN","ignoreList":[]}

package/lambdaEdge/response.d.ts

@@ -0,0 +1,2 @@
+import type { CloudFrontResultResponse } from "./types";
+export declare function notFoundResponse(message?: string): CloudFrontResultResponse;

package/lambdaEdge/response.js

@@ -0,0 +1,9 @@
+export function notFoundResponse(message) {
+  return {
+    status: "404",
+    statusDescription: "Not found",
+    body: message || "Not found"
+  };
+}
+
+//# sourceMappingURL=response.js.map

package/lambdaEdge/response.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["notFoundResponse","message","status","statusDescription","body"],"sources":["response.ts"],"sourcesContent":["import type { CloudFrontResultResponse } from \"./types\";\n\nexport function notFoundResponse(message?: string): CloudFrontResultResponse {\n    return {\n        status: \"404\",\n        statusDescription: \"Not found\",\n        body: message || \"Not found\"\n    };\n}\n"],"mappings":"AAEA,OAAO,SAASA,gBAAgBA,CAACC,OAAgB,EAA4B;EACzE,OAAO;IACHC,MAAM,EAAE,KAAK;IACbC,iBAAiB,EAAE,WAAW;IAC9BC,IAAI,EAAEH,OAAO,IAAI;EACrB,CAAC;AACL","ignoreList":[]}

package/lambdaEdge/types.d.ts

@@ -0,0 +1,10 @@
+import type { CloudFrontEvent as BaseCloudFrontEvent, CloudFrontRequest as BaseCloudFrontRequest, CloudFrontRequestEvent as BaseCloudFrontRequestEvent, CloudFrontResponse as BaseCloudFrontResponse, CloudFrontResponseEvent as BaseCloudFrontResponseEvent, CloudFrontResultResponse as BaseCloudFrontResultResponse, CloudFrontHeaders as BaseCloudFrontHeaders } from "aws-lambda";
+export type CloudFrontEvent = BaseCloudFrontEvent;
+export type CloudFrontRequest = BaseCloudFrontRequest;
+export type CloudFrontRequestEvent = BaseCloudFrontRequestEvent;
+export type CloudFrontResponse = BaseCloudFrontResponse & {
+    body?: string;
+};
+export type CloudFrontResponseEvent = BaseCloudFrontResponseEvent;
+export type CloudFrontResultResponse = BaseCloudFrontResultResponse;
+export type CloudFrontHeaders = BaseCloudFrontHeaders;

package/lambdaEdge/types.js

@@ -0,0 +1,3 @@
+export {};
+
+//# sourceMappingURL=types.js.map

package/lambdaEdge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import type {\n    CloudFrontEvent as BaseCloudFrontEvent,\n    CloudFrontRequest as BaseCloudFrontRequest,\n    CloudFrontRequestEvent as BaseCloudFrontRequestEvent,\n    CloudFrontResponse as BaseCloudFrontResponse,\n    CloudFrontResponseEvent as BaseCloudFrontResponseEvent,\n    CloudFrontResultResponse as BaseCloudFrontResultResponse,\n    CloudFrontHeaders as BaseCloudFrontHeaders\n} from \"aws-lambda\";\n\nexport type CloudFrontEvent = BaseCloudFrontEvent;\nexport type CloudFrontRequest = BaseCloudFrontRequest;\nexport type CloudFrontRequestEvent = BaseCloudFrontRequestEvent;\nexport type CloudFrontResponse = BaseCloudFrontResponse & { body?: string };\nexport type CloudFrontResponseEvent = BaseCloudFrontResponseEvent;\nexport type CloudFrontResultResponse = BaseCloudFrontResultResponse;\nexport type CloudFrontHeaders = BaseCloudFrontHeaders;\n"],"mappings":"","ignoreList":[]}

package/lambdaEdge/utils.d.ts

@@ -0,0 +1,3 @@
+import type { CloudFrontRequestHandler, CloudFrontResponseHandler } from "aws-lambda";
+export declare function defineLambdaEdgeRequestHandler(handler: CloudFrontRequestHandler): CloudFrontRequestHandler;
+export declare function defineLambdaEdgeResponseHandler(handler: CloudFrontResponseHandler): CloudFrontResponseHandler;

package/lambdaEdge/utils.js

@@ -0,0 +1,8 @@
+export function defineLambdaEdgeRequestHandler(handler) {
+  return handler;
+}
+export function defineLambdaEdgeResponseHandler(handler) {
+  return handler;
+}
+
+//# sourceMappingURL=utils.js.map

package/lambdaEdge/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineLambdaEdgeRequestHandler","handler","defineLambdaEdgeResponseHandler"],"sources":["utils.ts"],"sourcesContent":["import type { CloudFrontRequestHandler, CloudFrontResponseHandler } from \"aws-lambda\";\n\nexport function defineLambdaEdgeRequestHandler(handler: CloudFrontRequestHandler) {\n    return handler;\n}\n\nexport function defineLambdaEdgeResponseHandler(handler: CloudFrontResponseHandler) {\n    return handler;\n}\n"],"mappings":"AAEA,OAAO,SAASA,8BAA8BA,CAACC,OAAiC,EAAE;EAC9E,OAAOA,OAAO;AAClB;AAEA,OAAO,SAASC,+BAA+BA,CAACD,OAAkC,EAAE;EAChF,OAAOA,OAAO;AAClB","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webiny/aws-helpers",
-	"version": "5.43.3",
+	"version": "6.0.0-alpha.1",
 	"types": "dist/index.d.ts",
 	"exports": {
 		".": {
@@ -25,14 +25,18 @@
 		"access": "public",
 		"directory": "dist"
 	},
-	"gitHead": "c6d623eb1b715f3731434a8d3107b8fd8a1d6792",
+	"gitHead": "9bd236cf5e689f209a11bec089207dcc2d41a53c",
 	"dependencies": {
 		"@types/aws-lambda": "8.10.145",
-		"cheerio": "1.0.0-rc.12",
+		"cheerio": "1.1.2",
 		"srcset": "4.0.0"
 	},
+	"scripts": {
+		"build": "node ../cli/bin.js run build",
+		"watch": "node ../cli/bin.js run watch"
+	},
 	"devDependencies": {
-		"@webiny/project-utils": "5.43.3"
+		"@webiny/project-utils": "6.0.0-alpha.1"
 	},
 	"sideEffects": false,
 	"adio": {

package/stagedRollouts/functions/adminOriginRequest.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("aws-lambda").CloudFrontRequestHandler;
+export default _default;