@betterinternship/core 2.26.2 → 2.27.0

package/README.md

@@ -1,26 +1,26 @@
-# Package.Core
-
-Contains dependencies shared between the different services of the site.
-
-## How to update
-
-1. Build the package:
-
-```bash
-npm run build
-```
-
-2. Commit the build:
-
-```bash
-git add .
-git commit -m "<follow conventional commits, k thanks>"
-git push
-```
-
-3. Update the version and publish the package to NPM:
-
-```bash
-npm version <patch|minor|major>
-npm publish
-```
+# Package.Core
+
+Contains dependencies shared between the different services of the site.
+
+## How to update
+
+1. Build the package:
+
+```bash
+npm run build
+```
+
+2. Commit the build:
+
+```bash
+git add .
+git commit -m "<follow conventional commits, k thanks>"
+git push
+```
+
+3. Update the version and publish the package to NPM:
+
+```bash
+npm version <patch|minor|major>
+npm publish
+```

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './lib/env.js';
 export * from './lib/email/index.js';
 export * from './lib/forms/index.js';
 export * from './lib/partners/forms/index.js';
+export * from './lib/links/index.js';

package/dist/index.js

@@ -2,4 +2,5 @@ export * from './lib/env.js';
 export * from './lib/email/index.js';
 export * from './lib/forms/index.js';
 export * from './lib/partners/forms/index.js';
+export * from './lib/links/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC"}

package/dist/lib/email/action.js

@@ -6,10 +6,9 @@ const escapeHtml = (value) => value
     .replaceAll("'", ''');
 export const renderEmailAction = ({ href, label }) => {
     const escapedHref = escapeHtml(href);
-    return `<div style="margin:24px 0 0">
-  <a href="${escapedHref}" style="display:inline-block;padding:12px 22px;background:#155eef;color:#ffffff;border-radius:8px;text-decoration:none;font-size:14px;font-weight:700">${escapeHtml(label)} →</a>
-  <p style="margin:14px 0 0;font-size:12px;line-height:1.5;color:#64748b">Button not working? Copy and paste this link into your browser:</p>
-  <p style="margin:5px 0 0;font-size:12px;line-height:1.5;word-break:break-all"><a href="${escapedHref}" style="color:#155eef;text-decoration:underline;word-break:break-all">${escapedHref}</a></p>
+    return `<div style="margin:20px 0 0">
+  <a href="${escapedHref}" style="display:inline-block;padding:12px 22px;background:#155eef;color:#ffffff;border-radius:8px;text-decoration:none;font-size:14px;font-weight:700">${escapeHtml(label)} →</a>
+  <p style="margin:8px 0 0;font-size:11px;line-height:1.45;color:#8a94a8;word-break:break-all">Or copy this link: <a href="${escapedHref}" style="color:#64748b;text-decoration:underline;word-break:break-all">${escapedHref}</a></p>
 </div>`;
 };
 //# sourceMappingURL=action.js.map

package/dist/lib/email/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../lib/email/action.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CACnC,KAAK;KACF,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;KACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;KACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAG9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAsB,EAAE,EAAE;IACvE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO;aACI,WAAW,2JAA2J,UAAU,CAAC,KAAK,CAAC;;2FAEzG,WAAW,0EAA0E,WAAW;OACpL,CAAC;AACR,CAAC,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../lib/email/action.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CACnC,KAAK;KACF,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;KACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;KACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAG9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAsB,EAAE,EAAE;IACvE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO;aACI,WAAW,2JAA2J,UAAU,CAAC,KAAK,CAAC;6HACvE,WAAW,0EAA0E,WAAW;OACtN,CAAC;AACR,CAAC,CAAC"}

package/dist/lib/email/preview.js

@@ -26,26 +26,26 @@ export const writeEmailPreviewCatalog = ({ title, previews, outputDirectory, })
     });
     const escapedTitle = escapeHtml(title);
     const catalogPath = join(outputDirectory, 'index.html');
-    writeFileSync(catalogPath, `<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <title>${escapedTitle}</title>
-    <style>
-      body { margin: 0; padding: 32px; background: #eef2f7; color: #17213d; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-      h1 { margin: 0 0 8px; }
-      p { margin: 0 0 32px; color: #5c6880; }
-      section { max-width: 680px; margin: 0 auto 36px; }
-      h2 { display: flex; align-items: center; gap: 8px; font-size: 16px; margin: 0 0 10px; }
-      h2 span { padding: 3px 7px; border-radius: 999px; background: #dbeafe; color: #1d4ed8; font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: .04em; }
-      iframe { width: 100%; height: 760px; border: 1px solid #d7deea; background: #fff; border-radius: 8px; }
-    </style>
-  </head>
-  <body>
-    <h1>${escapedTitle}</h1>
-    <p>Generated from the production email factories and their templates.</p>
-    ${catalogItems.join('\n    ')}
-  </body>
+    writeFileSync(catalogPath, `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${escapedTitle}</title>
+    <style>
+      body { margin: 0; padding: 32px; background: #eef2f7; color: #17213d; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+      h1 { margin: 0 0 8px; }
+      p { margin: 0 0 32px; color: #5c6880; }
+      section { max-width: 680px; margin: 0 auto 36px; }
+      h2 { display: flex; align-items: center; gap: 8px; font-size: 16px; margin: 0 0 10px; }
+      h2 span { padding: 3px 7px; border-radius: 999px; background: #dbeafe; color: #1d4ed8; font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: .04em; }
+      iframe { width: 100%; height: 760px; border: 1px solid #d7deea; background: #fff; border-radius: 8px; }
+    </style>
+  </head>
+  <body>
+    <h1>${escapedTitle}</h1>
+    <p>Generated from the production email factories and their templates.</p>
+    ${catalogItems.join('\n    ')}
+  </body>
 </html>`);
     return catalogPath;
 };

package/dist/lib/email/shell.js

@@ -4,27 +4,27 @@ const escapeHtml = (value) => value
     .replaceAll('>', '>')
     .replaceAll('"', '"')
     .replaceAll("'", ''');
-export const renderEmailShell = ({ logoUrl, heading, bodyHtml, footerHtml = 'This is an automated message from BetterInternship.', }) => `<!doctype html>
-<html lang="en">
-  <body style="margin:0;background:#ffffff;color:#17213d;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Arial,sans-serif">
-    <div style="padding:40px 16px">
-      <div style="margin:0 auto 20px;text-align:center">
-        <table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:0 auto">
-          <tr>
-            <td style="vertical-align:middle"><img src="${escapeHtml(logoUrl)}" alt="BetterInternship" width="30" height="30" style="width:30px;height:30px;display:block;object-fit:contain" /></td>
-            <td style="padding-left:9px;vertical-align:middle;font-size:19px;font-weight:700;color:#111827">${escapeHtml(heading)}</td>
-          </tr>
-        </table>
-      </div>
-
-      <div style="width:100%;max-width:520px;margin:0 auto;background:#ffffff;border:1px solid #e4e8f0;border-radius:14px;overflow:hidden">
-        <div style="padding:34px 32px 36px">
-${bodyHtml}
-        </div>
-
-        <div style="padding:16px 32px;background:#fafbfc;border-top:1px solid #edf0f5;color:#8a94a8;font-size:12px;line-height:1.5">${footerHtml}</div>
-      </div>
-    </div>
-  </body>
+export const renderEmailShell = ({ logoUrl, heading, bodyHtml, footerHtml = 'This is an automated message from BetterInternship.', }) => `<!doctype html>
+<html lang="en">
+  <body style="margin:0;background:#ffffff;color:#17213d;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Arial,sans-serif">
+    <div style="padding:40px 16px">
+      <div style="margin:0 auto 20px;text-align:center">
+        <table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:0 auto">
+          <tr>
+            <td style="vertical-align:middle"><img src="${escapeHtml(logoUrl)}" alt="BetterInternship" width="30" height="30" style="width:30px;height:30px;display:block;object-fit:contain" /></td>
+            <td style="padding-left:9px;vertical-align:middle;font-size:19px;font-weight:700;color:#111827">${escapeHtml(heading)}</td>
+          </tr>
+        </table>
+      </div>
+
+      <div style="width:100%;max-width:520px;margin:0 auto;background:#ffffff;border:1px solid #e4e8f0;border-radius:14px;overflow:hidden">
+        <div style="padding:34px 32px 36px;font-size:15px;line-height:1.7;color:#4b5872">
+${bodyHtml}
+        </div>
+
+        <div style="padding:16px 32px;background:#fafbfc;border-top:1px solid #edf0f5;color:#8a94a8;font-size:12px;line-height:1.5">${footerHtml}</div>
+      </div>
+    </div>
+  </body>
 </html>`;
 //# sourceMappingURL=shell.js.map

package/dist/lib/forms/field-preset-templates.js

@@ -5,14 +5,14 @@ const LONG_TEXT_VALIDATOR = `${TEXT_PREPROCESS}z.string().describe("textarea"))`
 const NUMBER_VALIDATOR = 'z.number()';
 const SIGNATURE_VALIDATOR = `${TEXT_PREPROCESS}z.string().nonempty({ message: "This field is required." }))`;
 const DROPDOWN_VALIDATOR = `z.enum(["Option 1", "Option 2"], {message:"This field is required."})`;
-const MULTISELECT_VALIDATOR = `z.array(
-  z.enum(
-    [
-      "Option 1",
-      "Option 2"
-    ],
-    { message: "This field is required." }
-  )
+const MULTISELECT_VALIDATOR = `z.array(
+  z.enum(
+    [
+      "Option 1",
+      "Option 2"
+    ],
+    { message: "This field is required." }
+  )
 ).describe("multiselect")`;
 const DATE_VALIDATOR = 'z.coerce.date()';
 const TIME_VALIDATOR = 'z.string().describe("time")';

package/dist/lib/links/index.d.ts

@@ -0,0 +1,10 @@
+export declare const LINK_HOSTS: readonly ["career", "hire", "docs", "moa", "uni", "admin", "api"];
+export type LinkHost = (typeof LINK_HOSTS)[number];
+export type LinkHostBases = Readonly<Partial<Record<LinkHost, string>>>;
+export declare const isLinkHost: (value: string) => value is LinkHost;
+export declare const linkHostBase: (host: LinkHost, bases: LinkHostBases) => string;
+export declare const isApprovedLinkHostPair: (shortHost: LinkHost, destinationHost: LinkHost) => boolean;
+export declare const assertApprovedLinkHostPair: (shortHost: LinkHost, destinationHost: LinkHost) => void;
+export declare const configuredLinkHostBases: (env?: Record<string, string | undefined>) => LinkHostBases;
+export declare const assertRootRelativePath: (path: string) => void;
+export declare const generateLinkSlug: (length?: number) => string;

package/dist/lib/links/index.js

@@ -0,0 +1,57 @@
+import { randomBytes } from 'node:crypto';
+import { ENV } from '../env.js';
+export const LINK_HOSTS = [
+    'career',
+    'hire',
+    'docs',
+    'moa',
+    'uni',
+    'admin',
+    'api',
+];
+export const isLinkHost = (value) => LINK_HOSTS.includes(value);
+const configuredBase = (host, bases) => {
+    const value = bases[host];
+    if (!value)
+        throw new Error(`[LINKS] No base URL configured for '${host}'.`);
+    return value.replace(/\/+$/, '');
+};
+export const linkHostBase = (host, bases) => configuredBase(host, bases);
+export const isApprovedLinkHostPair = (shortHost, destinationHost) => isLinkHost(shortHost) && isLinkHost(destinationHost);
+export const assertApprovedLinkHostPair = (shortHost, destinationHost) => {
+    if (!isApprovedLinkHostPair(shortHost, destinationHost)) {
+        throw new Error(`[LINKS] '${shortHost}' short links cannot redirect to '${destinationHost}'.`);
+    }
+};
+export const configuredLinkHostBases = (env = ENV) => ({
+    career: env.CLIENT_SERVER_URL,
+    hire: env.CLIENT_SERVER_HIRE_URL,
+    uni: env.CLIENT_DUMMY_UNIV_URL,
+    api: env.API_BASE_URL,
+});
+export const assertRootRelativePath = (path) => {
+    if (!path.startsWith('/') || path.startsWith('//')) {
+        throw new Error('[LINKS] URL must be a root-relative path.');
+    }
+    try {
+        const origin = 'https://betterinternship.invalid';
+        if (new URL(path, origin).origin !== origin) {
+            throw new Error('[LINKS] URL must be a root-relative path.');
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('[LINKS]')) {
+            throw error;
+        }
+        throw new Error('[LINKS] URL must be a valid root-relative path.');
+    }
+};
+export const generateLinkSlug = (length = 32) => {
+    if (!Number.isSafeInteger(length) || length < 1) {
+        throw new Error('[LINKS] Slug length must be a positive integer.');
+    }
+    return randomBytes(Math.ceil((length * 3) / 4))
+        .toString('base64url')
+        .slice(0, length);
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/links/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/links/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/pdf-viewer/form-previewer-rendering.js

@@ -77,13 +77,13 @@ export const ensurePreviewFontsLoaded = () => {
     if (!document.getElementById(PREVIEW_FONT_STYLE_ID)) {
         const style = document.createElement("style");
         style.id = PREVIEW_FONT_STYLE_ID;
-        style.textContent = `
-@font-face {
-  font-family: "MegastinaPreview";
-  src: url("/fonts/megastina.regular.ttf") format("truetype");
-  font-weight: 400;
-  font-style: normal;
-  font-display: block;
+        style.textContent = `
+@font-face {
+  font-family: "MegastinaPreview";
+  src: url("/fonts/megastina.regular.ttf") format("truetype");
+  font-weight: 400;
+  font-style: normal;
+  font-display: block;
 }`;
         document.head.appendChild(style);
     }