@plitzi/sdk-shared 0.35.3 → 0.35.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @plitzi/sdk-shared
 
+## 0.35.5
+
+### Patch Changes
+
+- v0.35.5
+
+## 0.35.4
+
+### Patch Changes
+
+- v0.35.4
+
 ## 0.35.3
 
 ### Patch Changes

package/dist/actions/index.d.ts

@@ -2,5 +2,7 @@ export { cronMatches, isKnownTimeZone, parseCron, zonedClock } from './cron';
 export { triggerAccess, triggerCacheMs, triggerHasStaleVerify, triggerInput, triggerVerify } from './triggerParams';
 export { actionName, actionTriggers, isActionEnabled } from './triggers';
 export { validateActionDocument } from './validateDocument';
+export { isSingleEmailAddress, readSmtpCredential, SMTP_CREDENTIAL_KEYS } from './smtp';
 export type { CronExpression } from './cron';
+export type { SmtpCredentialProblem, SmtpCredentialReading, SmtpSecurity, SmtpSettings } from './smtp';
 export type { ActionDocumentIssue, ActionDocumentReport } from './validateDocument';

package/dist/actions/index.mjs

@@ -2,4 +2,5 @@ import { cronMatches as e, isKnownTimeZone as t, parseCron as n, zonedClock as r
 import { triggerAccess as i, triggerCacheMs as a, triggerHasStaleVerify as o, triggerInput as s, triggerVerify as c } from "./triggerParams.mjs";
 import { actionName as l, actionTriggers as u, isActionEnabled as d } from "./triggers.mjs";
 import { validateActionDocument as f } from "./validateDocument.mjs";
-export { l as actionName, u as actionTriggers, e as cronMatches, d as isActionEnabled, t as isKnownTimeZone, n as parseCron, i as triggerAccess, a as triggerCacheMs, o as triggerHasStaleVerify, s as triggerInput, c as triggerVerify, f as validateActionDocument, r as zonedClock };
+import { SMTP_CREDENTIAL_KEYS as p, isSingleEmailAddress as m, readSmtpCredential as h } from "./smtp.mjs";
+export { p as SMTP_CREDENTIAL_KEYS, l as actionName, u as actionTriggers, e as cronMatches, d as isActionEnabled, t as isKnownTimeZone, m as isSingleEmailAddress, n as parseCron, h as readSmtpCredential, i as triggerAccess, a as triggerCacheMs, o as triggerHasStaleVerify, s as triggerInput, c as triggerVerify, f as validateActionDocument, r as zonedClock };

package/dist/actions/smtp.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The SMTP server a space sends its flows' mail through, as its credential stores it — one rule for everybody who
+ * reads one: the editor saving it, the API accepting it, the check reporting on it and the `email.send` task using it.
+ *
+ * A credential is a bag of strings, so every value arrives as text and is judged here: a port that is not a port, a
+ * sender that is not one address, a password with no user to go with it. Each problem names the key it is about, so a
+ * form can put the sentence under the field.
+ */
+export type SmtpSecurity = 'tls' | 'starttls' | 'none';
+export type SmtpSettings = {
+    host: string;
+    port: number;
+    /** `tls` connects encrypted (usually 465); `starttls` upgrades a plain connection (usually 587); `none` never does. */
+    security: SmtpSecurity;
+    /** Empty with an empty password: a relay that authenticates by where the connection comes from. */
+    username: string;
+    password: string;
+    fromEmail: string;
+    fromName: string;
+};
+export type SmtpCredentialProblem = {
+    key: keyof SmtpSettings;
+    message: string;
+};
+export type SmtpCredentialReading = {
+    settings: SmtpSettings;
+    problems: [];
+} | {
+    problems: SmtpCredentialProblem[];
+};
+/** The keys an SMTP credential holds, in the order an editor asks for them. */
+export declare const SMTP_CREDENTIAL_KEYS: readonly (keyof SmtpSettings)[];
+export declare const isSingleEmailAddress: (value: string) => boolean;
+export declare const readSmtpCredential: (data: Record<string, unknown>) => SmtpCredentialReading;

package/dist/actions/smtp.mjs

@@ -0,0 +1,51 @@
+//#region src/actions/smtp.ts
+var e = [
+	"host",
+	"port",
+	"security",
+	"username",
+	"password",
+	"fromEmail",
+	"fromName"
+], t = [
+	"tls",
+	"starttls",
+	"none"
+], n = /^[A-Za-z0-9](?:[A-Za-z0-9.-]{0,251}[A-Za-z0-9])?$/, r = /^[^\s@,;<>"]+@[^\s@,;<>"]+\.[^\s@,;<>"]+$/, i = (e) => r.test(e), a = (e) => t.some((t) => t === e), o = (e, t) => {
+	let n = e[t];
+	return typeof n == "number" ? String(n) : typeof n == "string" ? n.trim() : "";
+}, s = (e) => {
+	let t = o(e, "host"), r = Number(o(e, "port")), s = o(e, "security"), c = o(e, "username"), l = typeof e.password == "string" ? e.password : "", u = o(e, "fromEmail"), d = o(e, "fromName"), f = [];
+	return n.test(t) || f.push({
+		key: "host",
+		message: "A host name like smtp.example.com, with no scheme and no port"
+	}), (!Number.isInteger(r) || r < 1 || r > 65535) && f.push({
+		key: "port",
+		message: "A port number, usually 587 or 465"
+	}), a(s) || f.push({
+		key: "security",
+		message: "One of tls, starttls or none"
+	}), l !== "" && c === "" && f.push({
+		key: "username",
+		message: "A password needs the user it belongs to"
+	}), i(u) || f.push({
+		key: "fromEmail",
+		message: "The one address this server sends as"
+	}), (/[\r\n]/.test(d) || d.length > 100) && f.push({
+		key: "fromName",
+		message: "One line of at most 100 characters"
+	}), f.length > 0 || !a(s) ? { problems: f } : {
+		settings: {
+			host: t,
+			port: r,
+			security: s,
+			username: c,
+			password: l,
+			fromEmail: u,
+			fromName: d
+		},
+		problems: []
+	};
+};
+//#endregion
+export { e as SMTP_CREDENTIAL_KEYS, i as isSingleEmailAddress, s as readSmtpCredential };

package/dist/actions/validateDocument.mjs

@@ -24,7 +24,8 @@ var a = [
 	"spaceId",
 	"environment",
 	"trigger",
-	"runId"
+	"runId",
+	"now"
 ]), u = /^[a-z][a-zA-Z0-9]*\.[a-z][a-zA-Z0-9]*$/, d = (e) => typeof e == "object" && !!e && !Array.isArray(e), f = (e) => typeof e == "string" && e.trim() !== "", p = (e) => {
 	try {
 		let t = JSON.parse(e);

package/dist/helpers/twigWrapper/filters/filters.mjs

@@ -99,7 +99,54 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 }, s = "__PLITZI_RAW__", c = (e) => typeof e == "object" && !!e && e.__marker === "__PLITZI_RAW__", l = (e) => ({
 	__raw: e,
 	__marker: s
-}), u = (e) => c(e) ? e.__raw : e, d = {
+}), u = (e) => c(e) ? e.__raw : e, d = [
+	"Sun",
+	"Mon",
+	"Tue",
+	"Wed",
+	"Thu",
+	"Fri",
+	"Sat"
+], f = /* @__PURE__ */ new Map(), p = (e) => {
+	if (!f.has(e)) try {
+		f.set(e, new Intl.DateTimeFormat("en-US", {
+			timeZone: e,
+			hourCycle: "h23",
+			year: "numeric",
+			month: "numeric",
+			day: "numeric",
+			hour: "numeric",
+			minute: "numeric",
+			second: "numeric",
+			weekday: "short"
+		}));
+	} catch {
+		f.set(e, null);
+	}
+	return f.get(e) ?? null;
+}, m = (e, t) => {
+	if (!t) return {
+		year: e.getFullYear(),
+		month: e.getMonth() + 1,
+		day: e.getDate(),
+		hours: e.getHours(),
+		minutes: e.getMinutes(),
+		seconds: e.getSeconds(),
+		weekday: e.getDay()
+	};
+	let n = p(t);
+	if (!n) return;
+	let r = n.formatToParts(e), i = (e) => r.find((t) => t.type === e)?.value ?? "";
+	return {
+		year: Number(i("year")),
+		month: Number(i("month")),
+		day: Number(i("day")),
+		hours: Number(i("hour")),
+		minutes: Number(i("minute")),
+		seconds: Number(i("second")),
+		weekday: d.indexOf(i("weekday"))
+	};
+}, h = {
 	raw: (e) => l(e),
 	to_json: (e) => typeof e == "object" && e ? JSON.stringify(e) : r(e),
 	json_encode: (e) => typeof e == "object" && e ? JSON.stringify(e) : r(e),
@@ -262,13 +309,21 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 		if (t.length === 0) return e;
 		let n = r(t[0]), i = e instanceof Date ? e : new Date(String(e));
 		if (Number.isNaN(i.getTime())) return "";
-		let a = (e) => String(e).padStart(2, "0"), o = {
-			Y: String(i.getFullYear()),
-			m: a(i.getMonth() + 1),
-			d: a(i.getDate()),
-			H: a(i.getHours()),
-			i: a(i.getMinutes()),
-			s: a(i.getSeconds()),
+		let a = m(i, t.length > 1 ? r(t[1]) : "");
+		if (!a) return "";
+		let o = (e) => String(e).padStart(2, "0"), s = {
+			Y: String(a.year),
+			m: o(a.month),
+			n: String(a.month),
+			d: o(a.day),
+			j: String(a.day),
+			H: o(a.hours),
+			G: String(a.hours),
+			i: o(a.minutes),
+			s: o(a.seconds),
+			w: String(a.weekday),
+			N: String(a.weekday === 0 ? 7 : a.weekday),
+			U: String(Math.floor(i.getTime() / 1e3)),
 			l: [
 				"Sunday",
 				"Monday",
@@ -277,7 +332,7 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 				"Thursday",
 				"Friday",
 				"Saturday"
-			][i.getDay()],
+			][a.weekday],
 			F: [
 				"January",
 				"February",
@@ -291,7 +346,7 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 				"October",
 				"November",
 				"December"
-			][i.getMonth()],
+			][a.month - 1],
 			M: [
 				"Jan",
 				"Feb",
@@ -305,10 +360,10 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 				"Oct",
 				"Nov",
 				"Dec"
-			][i.getMonth()]
-		}, s = "";
-		for (let e of n) s += Object.prototype.hasOwnProperty.call(o, e) ? o[e] : e;
-		return s;
+			][a.month - 1]
+		}, c = "";
+		for (let e of n) c += Object.prototype.hasOwnProperty.call(s, e) ? s[e] : e;
+		return c;
 	},
 	base64_encode: (e) => typeof e == "string" ? i(e) : e,
 	base64_decode: (e) => typeof e == "string" ? a(e) : e,
@@ -369,4 +424,4 @@ var e = Symbol("twigArrowParams"), t = (e) => e == null || e === "", n = (e, t)
 	}
 };
 //#endregion
-export { e as ARROW_PARAMS, s as RAW_MARKER, d as filters, c as isRawMarker, u as unwrapRaw, l as wrapRaw };
+export { e as ARROW_PARAMS, s as RAW_MARKER, h as filters, c as isRawMarker, u as unwrapRaw, l as wrapRaw };

package/dist/network/spaceEvents.d.ts

@@ -93,19 +93,19 @@ export declare const spaceEventSchemas: {
         selector: z.ZodString;
         path: z.ZodOptional<z.ZodCustom<StyleCategory, StyleCategory>>;
         type: z.ZodEnum<{
+            id: "id";
             class: "class";
             element: "element";
-            id: "id";
         }>;
         style: z.ZodOptional<z.ZodCustom<import('..').StyleAttributes, import('..').StyleAttributes>>;
         params: z.ZodObject<{
             componentType: z.ZodOptional<z.ZodString>;
             styleSelector: z.ZodOptional<z.ZodString>;
             styleState: z.ZodOptional<z.ZodEnum<{
-                disabled: "disabled";
                 hover: "hover";
                 active: "active";
                 focus: "focus";
+                disabled: "disabled";
                 checked: "checked";
                 visited: "visited";
             }>>;
@@ -124,10 +124,10 @@ export declare const spaceEventSchemas: {
         params: z.ZodObject<{
             componentType: z.ZodOptional<z.ZodString>;
             styleState: z.ZodOptional<z.ZodEnum<{
-                disabled: "disabled";
                 hover: "hover";
                 active: "active";
                 focus: "focus";
+                disabled: "disabled";
                 checked: "checked";
                 visited: "visited";
             }>>;
@@ -281,9 +281,9 @@ export declare const spaceEventSchemas: {
         }>;
         selector: z.ZodString;
         type: z.ZodEnum<{
+            id: "id";
             class: "class";
             element: "element";
-            id: "id";
         }>;
         path: z.ZodOptional<z.ZodCustom<StyleCategory, StyleCategory>>;
         style: z.ZodOptional<z.ZodCustom<import('..').StyleAttributes, import('..').StyleAttributes>>;
@@ -291,10 +291,10 @@ export declare const spaceEventSchemas: {
             componentType: z.ZodOptional<z.ZodString>;
             styleSelector: z.ZodOptional<z.ZodString>;
             styleState: z.ZodOptional<z.ZodEnum<{
-                disabled: "disabled";
                 hover: "hover";
                 active: "active";
                 focus: "focus";
+                disabled: "disabled";
                 checked: "checked";
                 visited: "visited";
             }>>;
@@ -314,10 +314,10 @@ export declare const spaceEventSchemas: {
         params: z.ZodObject<{
             componentType: z.ZodOptional<z.ZodString>;
             styleState: z.ZodOptional<z.ZodEnum<{
-                disabled: "disabled";
                 hover: "hover";
                 active: "active";
                 focus: "focus";
+                disabled: "disabled";
                 checked: "checked";
                 visited: "visited";
             }>>;