@atlasauth/emulator-core 0.2.0 → 0.3.1

package/dist/handlers/emu4-region.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.regionHandlers = regionHandlers;
+const errors_1 = require("../errors");
+const support_1 = require("./support");
+const emu4_shared_1 = require("./emu4-shared");
+/**
+ * Regional readiness. A single-region deployment (the default) has no regions: nothing is pinned, refused or rerouted. A
+ * deployment with a region table (`PUT /__emulator/region/config`) can pin the instance to the region of the stack answering, name
+ * a failover region and isolate the Frontend API origin. A pin is a statement about where the data is: it is only ever set to
+ * this stack's region and there is no unpin (moving between regions is an export and an import). The stack answering a pinned
+ * instance from another region refuses with 421 WRONG_REGION naming the region that serves it. shortcut: the guard sits on the
+ * region routes only; the rest of the emulator answers whatever stack it is told it is.
+ */
+const REGION_ID = /^[a-z][a-z0-9-]{1,19}$/;
+const STATUSES = ['active', 'standby', 'draining'];
+const st = (0, support_1.engineState)(() => ({ self: null, regions: [], isolationDefault: 'off', frontendApiHost: 'emulator-fapi.atlas.invalid', region: null, failoverRegion: null, fapiIsolation: null }));
+const isUrl = (v) => {
+    if (typeof v !== 'string')
+        return false;
+    try {
+        new URL(v);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** Validate a region table like the deployment setting: readable issues, unique ids, failover pointing at another listed region. */
+function parseTable(self, raw) {
+    if (self !== null && self !== undefined && (typeof self !== 'string' || !REGION_ID.test(self)))
+        throw (0, emu4_shared_1.bad)('self is a region id such as "eu" or null (one region).', 'self');
+    const list = raw === undefined ? [] : raw;
+    if (!Array.isArray(list))
+        throw (0, emu4_shared_1.bad)('regions must be an array.', 'regions');
+    if (list.length > 32)
+        throw (0, emu4_shared_1.bad)('At most 32 regions.', 'regions');
+    const regions = list.map((r, i) => {
+        const e = (0, emu4_shared_1.isObj)(r) ? r : {};
+        if (typeof e.id !== 'string' || !REGION_ID.test(e.id))
+            throw (0, emu4_shared_1.bad)(`regions.${i}.id is not a valid region id.`, 'regions');
+        if (e.label !== undefined && (typeof e.label !== 'string' || e.label.length < 1 || e.label.length > 80))
+            throw (0, emu4_shared_1.bad)(`regions.${i}.label must be 1-80 characters.`, 'regions');
+        for (const k of ['fapi_origin', 'bapi_origin'])
+            if (e[k] != null && !isUrl(e[k]))
+                throw (0, emu4_shared_1.bad)(`regions.${i}.${k} must be a URL.`, 'regions');
+        if (e.failover_to != null && (typeof e.failover_to !== 'string' || !REGION_ID.test(e.failover_to)))
+            throw (0, emu4_shared_1.bad)(`regions.${i}.failover_to is not a valid region id.`, 'regions');
+        const status = e.status ?? 'active';
+        if (!STATUSES.includes(status))
+            throw (0, emu4_shared_1.bad)(`regions.${i}.status must be one of ${STATUSES.join(', ')}.`, 'regions');
+        return { id: e.id, label: e.label ?? e.id, fapi_origin: typeof e.fapi_origin === 'string' ? e.fapi_origin.replace(/\/$/, '') : null, bapi_origin: typeof e.bapi_origin === 'string' ? e.bapi_origin.replace(/\/$/, '') : null, status: status, failover_to: e.failover_to ?? null };
+    });
+    const ids = new Set(regions.map((r) => r.id));
+    if (ids.size !== regions.length)
+        throw (0, emu4_shared_1.bad)('The region table lists a region id twice.', 'regions');
+    for (const r of regions)
+        if (r.failover_to && (!ids.has(r.failover_to) || r.failover_to === r.id))
+            throw (0, emu4_shared_1.bad)(`Region ${r.id} fails over to ${r.failover_to}, which is not another listed region.`, 'regions');
+    if (self && regions.length > 0 && !ids.has(self))
+        throw (0, emu4_shared_1.bad)(`The region table does not list this stack's own region (${self}).`, 'regions');
+    return { self: self ?? null, regions };
+}
+/** May this stack serve the instance? Yes with no region configured, no pin, a pin to this region, or this stack as its failover. */
+function decision(s) {
+    if (!s.self || !s.region || s.region === s.self || s.failoverRegion === s.self)
+        return { ok: true };
+    const home = s.regions.find((r) => r.id === s.region);
+    return { ok: false, pinned: s.region, region: s.region, fapi_origin: home?.fapi_origin ?? null, bapi_origin: home?.bapi_origin ?? null };
+}
+const wrongRegion = (d) => ({ status: 421, body: (0, errors_1.errorBody)([{ code: 'WRONG_REGION', message: `This instance is served from the ${d.pinned} region. Send the request there.`, meta: { region: d.region, fapi_origin: d.fapi_origin, bapi_origin: d.bapi_origin } }]) });
+const view = (s) => ({
+    object: 'region_status',
+    region: s.region,
+    pinned: !!s.region,
+    serving_region: s.self,
+    regions_enabled: !!s.self,
+    failover_region: s.failoverRegion,
+    fapi_isolation: s.fapiIsolation,
+    effective_fapi_isolation: s.fapiIsolation ?? s.isolationDefault,
+    regions: s.regions.map((r) => ({ id: r.id, label: r.label, status: r.status, fapi_origin: r.fapi_origin, bapi_origin: r.bapi_origin, failover_to: r.failover_to, self: r.id === s.self })),
+});
+const BASE_PATH = /^(\/[a-z0-9_~-][a-z0-9._~-]{0,63}){1,4}$/;
+const HOST = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/;
+function regionHandlers() {
+    const guard = (e) => {
+        const d = decision(st(e));
+        return d.ok ? null : wrongRegion(d);
+    };
+    return [
+        { method: 'GET', pattern: '/v1/region', scope: 'instance:read', handler: (c) => guard(c.engine) ?? { body: view(st(c.engine)) } },
+        { method: 'PUT', pattern: '/v1/region', scope: 'instance:write', handler: (c) => {
+                const e = c.engine;
+                const refused = guard(e);
+                if (refused)
+                    return refused;
+                const s = st(e);
+                const b = c.body;
+                const before = { region: s.region, failover_region: s.failoverRegion, fapi_isolation: s.fapiIsolation };
+                const set = {};
+                if (b.pin !== undefined) {
+                    if (typeof b.pin !== 'boolean')
+                        throw (0, emu4_shared_1.bad)('pin must be true or false.', 'pin');
+                    if (!b.pin)
+                        throw (0, emu4_shared_1.bad)("A pinned instance cannot be unpinned: its data lives in its region. Moving it is an export and an import.", 'pin');
+                    if (!s.self)
+                        throw (0, emu4_shared_1.bad)('This deployment has no region configured, so there is nothing to pin to.', 'pin');
+                    set.region = s.self;
+                }
+                const regionAfter = set.region ?? s.region;
+                if (b.failover_region !== undefined) {
+                    if (b.failover_region === null)
+                        set.failoverRegion = null;
+                    else {
+                        if (typeof b.failover_region !== 'string' || !s.regions.some((r) => r.id === b.failover_region))
+                            throw (0, emu4_shared_1.bad)(`failover_region must be null or one of: ${s.regions.map((r) => r.id).join(', ') || '(no regions configured)'}.`, 'failover_region');
+                        if (!regionAfter)
+                            throw (0, emu4_shared_1.bad)('Pin the instance to a region before naming its failover region.', 'failover_region');
+                        if (b.failover_region === regionAfter)
+                            throw (0, emu4_shared_1.bad)("The failover region must differ from the instance's own region.", 'failover_region');
+                        set.failoverRegion = b.failover_region;
+                    }
+                }
+                if (b.fapi_isolation !== undefined) {
+                    if (b.fapi_isolation !== null && b.fapi_isolation !== 'off' && b.fapi_isolation !== 'enforce')
+                        throw (0, emu4_shared_1.bad)('fapi_isolation must be null (the deployment default), "off" or "enforce".', 'fapi_isolation');
+                    set.fapiIsolation = b.fapi_isolation;
+                }
+                if (Object.keys(set).length === 0)
+                    throw (0, emu4_shared_1.bad)('Send at least one of pin, failover_region or fapi_isolation.');
+                Object.assign(s, set);
+                (0, emu4_shared_1.audit)(e, c, 'instance.region_updated', 'instance', e.instanceId, { before, after: set });
+                return { body: view(s) };
+            } },
+        { method: 'GET', pattern: '/v1/region/failover', scope: 'instance:read', handler: (c) => {
+                const e = c.engine;
+                const refused = guard(e);
+                if (refused)
+                    return refused;
+                const s = st(e);
+                const mountHost = String(c.query.get('mount_host') ?? '').trim().toLowerCase().replace(/\.$/, '');
+                if (!HOST.test(mountHost) || mountHost.length > 253)
+                    throw (0, emu4_shared_1.bad)('mount_host must be the host your reverse proxy serves, such as app.example.com.', 'mount_host');
+                const rawBase = c.query.get('base_path');
+                const basePath = rawBase === null || rawBase === '' ? '/__atlas' : rawBase;
+                if (!BASE_PATH.test(basePath))
+                    throw (0, emu4_shared_1.bad)('base_path must start with "/", have 1 to 4 segments of lowercase letters, digits, "_", "-" or "~" (a "." is allowed after the first character), and no trailing slash. Example: "/__atlas".', 'base_path');
+                const fail = (message) => ({ status: 422, body: (0, errors_1.errorBody)([{ code: 'VALIDATION_FAILED', message }]) });
+                if (!s.failoverRegion)
+                    return fail('This instance has no failover region. Set one with PUT /v1/region.');
+                const host = s.frontendApiHost.split('/')[0];
+                const standby = s.regions.find((r) => r.id === s.failoverRegion)?.fapi_origin;
+                if (!standby)
+                    return fail("The failover region has no Frontend API origin in this deployment's region table.");
+                const upstreams = [
+                    { role: 'primary', region: s.region ?? s.self, origin: `https://${host}`, host },
+                    { role: 'failover', region: s.failoverRegion, origin: standby, host },
+                ];
+                const standbyHost = new URL(standby).host;
+                const nginx = ['upstream atlas_fapi {', `  server ${host}:443;`, `  server ${standbyHost} backup;`, '}', '', `location ${basePath}/ {`, '  proxy_pass https://atlas_fapi;   # no URI part: the path is kept', `  proxy_set_header Host ${host};`, '  proxy_ssl_server_name on;', `  proxy_ssl_name ${host};`, '  # Fail over on a dead or erroring upstream, never on a 4xx (a 421 means "wrong region", not "down").', '  proxy_next_upstream error timeout http_502 http_503 http_504;', '  proxy_next_upstream_tries 2;', '}'].join('\n');
+                const caddy = [`handle ${basePath}/* {`, `  reverse_proxy ${upstreams[0].origin} ${standby} {`, '    lb_policy first', '    lb_try_duration 5s', '    fail_duration 30s', `    header_up Host ${host}`, '    transport http {', `      tls_server_name ${host}`, '    }', '  }', '}'].join('\n');
+                return { body: { object: 'region_failover', mount_host: mountHost, base_path: basePath, upstreams, nginx, caddy } };
+            } },
+        // ── emulator helpers ──
+        // PUT /__emulator/region/config { self, regions, fapi_isolation_default, frontend_api_host }: what the deployment is told (the region table and which stack this is).
+        { method: 'PUT', pattern: '/__emulator/region/config', public: true, handler: (c) => {
+                const s = st(c.engine);
+                const b = c.body;
+                const next = parseTable(b.self === undefined ? s.self : b.self, b.regions === undefined ? s.regions : b.regions);
+                if (b.fapi_isolation_default !== undefined && b.fapi_isolation_default !== 'off' && b.fapi_isolation_default !== 'enforce')
+                    throw (0, emu4_shared_1.bad)('fapi_isolation_default is off or enforce.', 'fapi_isolation_default');
+                if (b.frontend_api_host !== undefined && (typeof b.frontend_api_host !== 'string' || !b.frontend_api_host))
+                    throw (0, emu4_shared_1.bad)('frontend_api_host is a host name.', 'frontend_api_host');
+                s.self = next.self;
+                s.regions = next.regions;
+                if (b.fapi_isolation_default !== undefined)
+                    s.isolationDefault = b.fapi_isolation_default;
+                if (b.frontend_api_host !== undefined)
+                    s.frontendApiHost = b.frontend_api_host;
+                return { body: view(s) };
+            } },
+        // GET /__emulator/region/decision: would the stack answering serve this instance, or refuse it with 421?
+        { method: 'GET', pattern: '/__emulator/region/decision', public: true, handler: (c) => {
+                const d = decision(st(c.engine));
+                return { body: d.ok ? { object: 'region_decision', serves: true } : { object: 'region_decision', serves: false, pinned: d.pinned, serve_from: { region: d.region, fapi_origin: d.fapi_origin, bapi_origin: d.bapi_origin } } };
+            } },
+    ];
+}
+//# sourceMappingURL=emu4-region.js.map

package/dist/handlers/emu4-region.js.map

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

package/dist/handlers/emu4-saml.d.ts

@@ -0,0 +1,12 @@
+import type { Engine, RouteDef } from '../engine';
+interface XNode {
+    name: string;
+    attrs: Record<string, string>;
+    kids: XNode[];
+    text: string;
+}
+export declare function parseXml(src: string): XNode | null;
+/** Called once by the engine: hands the SOAP route its raw XML body (the engine itself only reads JSON and form bodies). */
+export declare function installSaml(e: Engine): void;
+export declare function samlHandlers(): RouteDef[];
+export {};