@ibgib/node-gib 0.0.14 → 0.0.17

package/dist/identity/sso/sso-custodian-service.mjs

@@ -0,0 +1,471 @@
+import { createPublicKey, verify } from 'node:crypto';
+import { hash, HashAlgorithm, extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { kdf_recursiveSaltWrap } from '@ibgib/core-gib/dist/keystone/kdf/kdf-helpers.mjs';
+import { KeystoneService_V1 } from '@ibgib/core-gib/dist/keystone/keystone-service-v1.mjs';
+import { KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE, POOL_ID_MANAGE, KEYSTONE_POOL_ID_REGEXP } from '@ibgib/core-gib/dist/keystone/keystone-constants.mjs';
+import { generateOpaqueChallengeId } from '@ibgib/core-gib/dist/keystone/keystone-helpers.mjs';
+import { KeystoneStrategyFactory } from '@ibgib/core-gib/dist/keystone/strategy/keystone-strategy-factory.mjs';
+/**
+ * Server-side service for token exchange, JWT validation, and user profile normalization.
+ */
+export class SsoCustodianService {
+    config;
+    lc = `[${SsoCustodianService.name}]`;
+    // In-memory cache for JSON Web Key Sets (JWKS) per provider
+    jwksCache = new Map();
+    jwksTtlMs = 24 * 60 * 60 * 1000; // Cache certs for 24 hours
+    /**
+     * @param config The server's global SSO configuration.
+     *   - Visibility: Private (Contains high-entropy secrets like `ssoServerKdfSecret` and `sessionSecret`).
+     *   - Generator: Server (Bootstrapped from node environment variables on server initialization).
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Exchanges an authorization code for an OAuth2 token and retrieves normalized user info.
+     *
+     * @param providerId The string identifier of the OAuth provider (e.g. 'google' or 'github').
+     *   - Visibility: Public (Non-sensitive metadata string).
+     *   - Generator: Client (Sent from browser UI selection).
+     *
+     * @param code The temporary authorization code returned by the OAuth provider.
+     *   - Visibility: Private (Confidential short-lived bearer credential. Must be kept private).
+     *   - Generator: Provider (Created by provider's OAuth page and sent to client redirect URI).
+     *
+     * @param redirectUri The redirect URI registered in the provider portal.
+     *   - Visibility: Public (Configuration URL).
+     *   - Generator: Client/Server (Derived from environmental configuration and sent by client).
+     */
+    async getOAuthUserInfo(providerId, code, redirectUri) {
+        const lc = `${this.lc}[${this.getOAuthUserInfo.name}]`;
+        const providerConfig = this.config.providers[providerId];
+        if (!providerConfig) {
+            throw new Error(`Provider '${providerId}' is not configured on this server. (E: c28900abfefd23e89cf23f12)`);
+        }
+        console.log(`${lc} Exchanging code for provider: ${providerId}`);
+        // 1. Exchange authorization code for tokens
+        const tokens = await this.exchangeCodeForTokens(providerConfig, code, redirectUri);
+        // 2. Retrieve and normalize user info
+        if (providerId === 'google') {
+            // Google returns an id_token (JWT) directly containing user info
+            if (!tokens.id_token) {
+                throw new Error(`Google token exchange did not return id_token. (E: e28900abfefd23e89cf45f23)`);
+            }
+            return this.verifyAndNormalizeGoogleToken(tokens.id_token);
+        }
+        else if (providerId === 'github') {
+            // GitHub requires calling the /user API using the access_token
+            if (!tokens.access_token) {
+                throw new Error(`GitHub token exchange did not return access_token. (E: a28900abfefd23e89cf56f34)`);
+            }
+            return this.fetchAndNormalizeGithubUser(providerConfig, tokens.access_token);
+        }
+        throw new Error(`Unsupported provider: ${providerId}. (E: d28900abfefd23e89cf67f45)`);
+    }
+    /**
+     * Directly validates a Google ID Token (JWT) locally and returns normalized user info.
+     * Useful for client-side authentication handshakes.
+     *
+     * @param idToken The raw base64-encoded signed JSON Web Token (JWT) ID token returned by Google.
+     *   - Visibility: Private (Sensitive bearer credential containing signature and claims. Must be kept private).
+     *   - Generator: Provider (Generated and signed cryptographically by Google authentication servers).
+     */
+    async verifyAndNormalizeGoogleToken(idToken) {
+        const lc = `${this.lc}[${this.verifyAndNormalizeGoogleToken.name}]`;
+        const providerConfig = this.config.providers.google;
+        if (!providerConfig) {
+            throw new Error(`Google provider config is missing. (E: g28900abfefd23e89cf78f56)`);
+        }
+        // Verify signature and decode JWT payload
+        const payload = await this.verifyJwt(idToken, providerConfig);
+        // Assert claims
+        const nowSeconds = Math.floor(Date.now() / 1000);
+        if (payload.exp && payload.exp < nowSeconds) {
+            throw new Error(`Token has expired. (E: t28900abfefd23e89cf89f67)`);
+        }
+        if (payload.aud !== providerConfig.clientId) {
+            throw new Error(`Token audience mismatch. Expected ${providerConfig.clientId}, got ${payload.aud}. (E: m28900abfefd23e89cf90f78)`);
+        }
+        if (!payload.sub) {
+            throw new Error(`Google JWT is missing subject claim ('sub'). (E: s28900abfefd23e89cfa1f89)`);
+        }
+        if (payload.email && payload.email_verified !== true && payload.email_verified !== 'true') {
+            throw new Error(`Google email is not verified: ${payload.email}. (E: v28900abfefd23e89cfb2f90)`);
+        }
+        return {
+            providerKey: `google:${payload.sub}`,
+            providerId: 'google',
+            sub: payload.sub,
+            email: payload.email,
+            name: payload.name,
+            picture: payload.picture
+        };
+    }
+    /**
+     * Internal: Exchange authorization code for access token / ID token.
+     *
+     * @param providerConfig Server configuration settings for the specific provider.
+     *   - Visibility: Private (Contains provider client secrets. Must stay server-side).
+     *   - Generator: Server (Configured from node environment variables).
+     *
+     * @param code The temporary authorization code to exchange.
+     *   - Visibility: Private (Short-lived credential. Must be kept private).
+     *   - Generator: Provider (Via OAuth flow).
+     *
+     * @param redirectUri The redirect URI registered for the exchange.
+     *   - Visibility: Public (Configuration URL).
+     *   - Generator: Client/Server (From app configuration).
+     */
+    async exchangeCodeForTokens(providerConfig, code, redirectUri) {
+        const body = new URLSearchParams({
+            client_id: providerConfig.clientId,
+            client_secret: providerConfig.clientSecret,
+            code,
+            redirect_uri: redirectUri,
+            grant_type: 'authorization_code'
+        });
+        const headers = {
+            'Content-Type': 'application/x-www-form-urlencoded'
+        };
+        // GitHub requires an Accept header to return JSON instead of URL-encoded string
+        if (providerConfig.providerId === 'github') {
+            headers['Accept'] = 'application/json';
+        }
+        const res = await fetch(providerConfig.tokenUrl, {
+            method: 'POST',
+            headers,
+            body: body.toString()
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`Token exchange failed (HTTP ${res.status}): ${errText}`);
+        }
+        return res.json();
+    }
+    /**
+     * Internal: Fetch GitHub user profile and normalize.
+     *
+     * @param providerConfig Server configuration settings for GitHub.
+     *   - Visibility: Private (Contains GitHub client secret).
+     *   - Generator: Server (From environment config).
+     *
+     * @param accessToken The active OAuth2 access token to authorize the API call.
+     *   - Visibility: Private (Bearer token. Must be kept private).
+     *   - Generator: Provider (GitHub token endpoint).
+     */
+    async fetchAndNormalizeGithubUser(providerConfig, accessToken) {
+        const res = await fetch(providerConfig.userInfoUrl, {
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'User-Agent': 'space-gib-auth-agent' // GitHub API requires User-Agent
+            }
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`Failed to fetch GitHub user info (HTTP ${res.status}): ${errText}`);
+        }
+        const rawUser = await res.json();
+        if (!rawUser.id) {
+            throw new Error(`GitHub user info response missing 'id' field.`);
+        }
+        const sub = String(rawUser.id);
+        let email = rawUser.email || undefined;
+        // If email is missing or private, fetch /user/emails to extract primary verified email
+        if (!email) {
+            try {
+                const emailsRes = await fetch('https://api.github.com/user/emails', {
+                    headers: {
+                        'Authorization': `Bearer ${accessToken}`,
+                        'User-Agent': 'space-gib-auth-agent'
+                    }
+                });
+                if (emailsRes.ok) {
+                    const emailsList = await emailsRes.json();
+                    const primaryVerified = emailsList.find((e) => e.verified && e.primary) || emailsList.find((e) => e.verified);
+                    if (primaryVerified?.email) {
+                        email = primaryVerified.email;
+                    }
+                }
+            }
+            catch (err) {
+                console.warn(`[${this.fetchAndNormalizeGithubUser.name}] Could not fetch GitHub /user/emails fallback: ${extractErrorMsg(err)}`);
+            }
+        }
+        if (!email) {
+            throw new Error(`Your GitHub account does not have a verified primary email address. Please verify your primary email on GitHub and try again. (E: e28900abfefd23e89cfc3f01)`);
+        }
+        return {
+            providerKey: `github:${sub}`,
+            providerId: 'github',
+            sub,
+            email,
+            name: rawUser.name || rawUser.login || undefined,
+            picture: rawUser.avatar_url || undefined
+        };
+    }
+    /**
+     * Internal: Decodes and cryptographically verifies a JWT signature using JWKS public keys.
+     *
+     * @param token The raw base64-encoded JWT token to verify.
+     *   - Visibility: Private (Sensitive token. Must be kept private).
+     *   - Generator: Provider (Google / OIDC server).
+     *
+     * @param providerConfig The target provider server settings containing `jwksUrl`.
+     *   - Visibility: Private (Contains secrets).
+     *   - Generator: Server (From environment config).
+     */
+    async verifyJwt(token, providerConfig) {
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            throw new Error('JWT must have 3 parts separated by dots.');
+        }
+        const [headerB64, payloadB64, signatureB64] = parts;
+        // 1. Decode header and select algorithm/key ID
+        let header;
+        try {
+            header = JSON.parse(Buffer.from(headerB64, 'base64url').toString('utf-8'));
+        }
+        catch {
+            throw new Error('Failed to parse JWT header.');
+        }
+        if (header.alg !== 'RS256') {
+            throw new Error(`Only RS256 algorithm is supported, got: ${header.alg}`);
+        }
+        const kid = header.kid;
+        if (!kid) {
+            throw new Error('JWT header missing key ID (kid).');
+        }
+        // 2. Fetch public keys (JWKS)
+        const keys = await this.getJwksKeys(providerConfig);
+        const jwk = keys.find(key => key.kid === kid);
+        if (!jwk) {
+            throw new Error(`JWK public key matching kid '${kid}' not found.`);
+        }
+        // 3. Create Public Key object using Node native crypto
+        const publicKey = createPublicKey({
+            key: jwk,
+            format: 'jwk'
+        });
+        // 4. Verify signature against header + payload data
+        const signature = Buffer.from(signatureB64, 'base64url');
+        const data = Buffer.from(`${headerB64}.${payloadB64}`);
+        const isValid = verify('sha256', data, publicKey, signature);
+        if (!isValid) {
+            throw new Error('Cryptographic signature verification failed.');
+        }
+        // 5. Decode and return payload
+        try {
+            return JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf-8'));
+        }
+        catch {
+            throw new Error('Failed to parse JWT payload.');
+        }
+    }
+    /**
+     * Internal: Retrieves JWKS keys from cache or fetches them from the provider's jwksUrl.
+     *
+     * @param providerConfig The provider config containing the target `jwksUrl`.
+     *   - Visibility: Private (Contains client secrets).
+     *   - Generator: Server (From environment config).
+     */
+    async getJwksKeys(providerConfig) {
+        const providerId = providerConfig.providerId;
+        const cached = this.jwksCache.get(providerId);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.keys;
+        }
+        if (!providerConfig.jwksUrl) {
+            throw new Error(`Provider '${providerId}' does not define a jwksUrl for JWT signature validation.`);
+        }
+        const res = await fetch(providerConfig.jwksUrl);
+        if (!res.ok) {
+            throw new Error(`Failed to fetch JWKS from ${providerConfig.jwksUrl} (HTTP ${res.status})`);
+        }
+        const body = (await res.json());
+        if (!body.keys || !Array.isArray(body.keys)) {
+            throw new Error(`Invalid JWKS response structure from ${providerConfig.jwksUrl}`);
+        }
+        this.jwksCache.set(providerId, {
+            keys: body.keys,
+            expiresAt: Date.now() + this.jwksTtlMs
+        });
+        return body.keys;
+    }
+    /**
+     * Derives a server-delegate master secret deterministically using the server's private KDF secret,
+     * the providerKey, and the user's public nonce.
+     *
+     * @param providerKey The unique key identifying the provider and user sub ID (e.g. `google:123...`).
+     *   - Visibility: Public (Identifier saved on parent's delegate claim, safe for log/ledger storage).
+     *   - Generator: Provider/Server (Derived by mapping provider user sub ID after authentication).
+     *
+     * @param userNonce The public, high-entropy nonce generated by the client to salt the KDF derivation.
+     *   - Visibility: Public (Salt value stored on parent's delegate claim, safe for ledger storage).
+     *   - Generator: Client (Generated offline on user's device).
+     */
+    async deriveServerDelegateSecret(providerKey, userNonce) {
+        const salt = await hash({
+            s: `${providerKey}:${userNonce}`,
+            algorithm: HashAlgorithm.sha_512
+        });
+        return await kdf_recursiveSaltWrap({
+            masterSecret: this.config.ssoServerKdfSecret,
+            salt,
+            rounds: 1000,
+            algorithm: HashAlgorithm.sha_512
+        });
+    }
+    /**
+     * Creates a public custodian challenge pool (custodian-manage) derived deterministically
+     * from the server's private KDF secret, providerKey, and userNonce.
+     *
+     * @param providerKey The unique key identifying the provider and user sub ID (e.g. `google:123...`).
+     *   - Visibility: Public (Mapped identifier, safe for ledger).
+     *   - Generator: Provider/Server (Derived after successful token exchange).
+     *
+     * @param userNonce The public, high-entropy nonce.
+     *   - Visibility: Public (Derivation salt, safe for ledger).
+     *   - Generator: Client (Generated on user's device).
+     */
+    async createCustodianChallengePool({ providerId, providerKey, userNonce, keystoneAddr, metaspace, space, }) {
+        // 1. Fetch target keystone
+        const keystoneService = new KeystoneService_V1();
+        const targetKeystone = await keystoneService.getLatestKeystone({
+            addr: keystoneAddr,
+            metaspace,
+            space
+        });
+        if (!targetKeystone) {
+            throw new Error(`Keystone not found for address: ${keystoneAddr} (E: 8a9c2b1d3e5f6a7b8c9d0e1f2a3b4c5d)`);
+        }
+        // 2. Locate native manage pool
+        const userManagePool = targetKeystone.data?.challengePools.find(p => p.id === POOL_ID_MANAGE);
+        if (!userManagePool) {
+            throw new Error(`Keystone manage pool not found. Custodian manage pool must match the user manage pool's security config. (E: 7c4e5f6a7b8c9d0e1f2a3b4c5e6f7a8b)`);
+        }
+        // 3. Dynamic poolId based on providerId with regex validation
+        if (!providerId || !KEYSTONE_POOL_ID_REGEXP.test(providerId)) {
+            throw new Error(`Invalid providerId: "${providerId}". Must match ${KEYSTONE_POOL_ID_REGEXP} (E: 3a2c4e5f6a7b8c9d0e1f2a3b4c5e6f)`);
+        }
+        const poolId = `custodian-manage-${providerId}`;
+        // 4. Derive delegate secrets
+        const custodianSecret = await this.deriveServerDelegateSecret(providerKey, userNonce);
+        const poolSalt = await hash({
+            s: `${providerKey}:${userNonce}:salt`,
+            algorithm: HashAlgorithm.sha_256
+        });
+        const poolSaltShort = poolSalt.substring(0, 16);
+        // 5. Clone user's manage pool config, updating only ID, salt, and allowedVerbs
+        const config = {
+            ...userManagePool.config,
+            id: poolId,
+            salt: poolSaltShort,
+            allowedVerbs: [KEYSTONE_VERB_MANAGE, KEYSTONE_VERB_REVOKE]
+        };
+        const strategy = KeystoneStrategyFactory.create({ config });
+        const poolSecret = await strategy.derivePoolSecret({ masterSecret: custodianSecret });
+        const challenges = {};
+        const timestamp = Date.now().toString();
+        for (let i = 0; i < config.behavior.size; i++) {
+            const challengeId = await generateOpaqueChallengeId({
+                salt: config.salt,
+                timestamp,
+                index: i
+            });
+            const solution = await strategy.generateSolution({
+                poolSecret,
+                poolId: config.id,
+                challengeId
+            });
+            challenges[challengeId] = await strategy.generateChallenge({ solution });
+        }
+        return {
+            id: poolId,
+            config,
+            challenges,
+            isForeign: true,
+            metadata: {
+                owner: 'custodian',
+                providerKey
+            }
+        };
+    }
+    /**
+     * Maps private server configuration to safe public client configurations.
+     *
+     * @param hostUrl The root URL host address of the server (e.g. `https://space-gib.localhost` or `https://ibgib.space`).
+     *   - Visibility: Public (Non-sensitive hostname configuration).
+     *   - Generator: Server (Extracted from the HTTP request context headers/protocol).
+     */
+    getSsoClientConfigs(hostUrl) {
+        const configs = [];
+        if (this.config.providers.google) {
+            configs.push({
+                providerId: 'google',
+                clientId: this.config.providers.google.clientId,
+                authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
+                redirectUri: `${hostUrl}/`,
+                scope: 'openid email profile'
+            });
+        }
+        if (this.config.providers.github) {
+            configs.push({
+                providerId: 'github',
+                clientId: this.config.providers.github.clientId,
+                authUrl: 'https://github.com/login/oauth/authorize',
+                redirectUri: `${hostUrl}/`,
+                scope: 'read:user user:email'
+            });
+        }
+        return configs;
+    }
+    /**
+     * Revokes an active OAuth access or refresh token with the provider.
+     * Keeps token revocation logic DRY and centralized.
+     */
+    async revokeToken(providerId, token) {
+        const lc = `${this.lc}[${this.revokeToken.name}]`;
+        const providerConfig = this.config.providers[providerId];
+        if (!providerConfig) {
+            throw new Error(`SSO provider "${providerId}" config is missing. (E: r28900abfefd23e89cf78f57)`);
+        }
+        try {
+            if (providerId === 'google') {
+                const res = await fetch(`https://oauth2.googleapis.com/revoke?token=${encodeURIComponent(token)}`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded'
+                    }
+                });
+                if (!res.ok) {
+                    const text = await res.text();
+                    console.warn(`${lc} Google token revocation returned status ${res.status}: ${text}`);
+                }
+            }
+            else if (providerId === 'github') {
+                const auth = Buffer.from(`${providerConfig.clientId}:${providerConfig.clientSecret}`).toString('base64');
+                const res = await fetch(`https://api.github.com/applications/${providerConfig.clientId}/grant`, {
+                    method: 'DELETE',
+                    headers: {
+                        'Authorization': `Basic ${auth}`,
+                        'Accept': 'application/vnd.github.v3+json',
+                        'User-Agent': 'space-gib-server'
+                    },
+                    body: JSON.stringify({ access_token: token })
+                });
+                if (!res.ok && res.status !== 404) {
+                    const text = await res.text();
+                    console.warn(`${lc} GitHub token revocation returned status ${res.status}: ${text}`);
+                }
+            }
+            else {
+                throw new Error(`Unsupported provider: ${providerId} (E: e28900abfefd23e89cf78f58)`);
+            }
+        }
+        catch (error) {
+            console.error(`${lc} Token revocation failed for provider ${providerId}: ${extractErrorMsg(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=sso-custodian-service.mjs.map

package/dist/identity/sso/sso-custodian-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sso-custodian-service.mjs","sourceRoot":"","sources":["../../../src/identity/sso/sso-custodian-service.mts"],"names":[],"mappings":"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"}

package/dist/identity/sso/sso-types.d.mts

@@ -0,0 +1,71 @@
+/**
+ * @module identity/sso/sso-types
+ *
+ * Core types and interfaces for extensible SSO (OAuth2) authentication on the server.
+ */
+export type SsoProviderId = 'google' | 'github';
+export interface SsoProviderClientConfig {
+    providerId: SsoProviderId;
+    clientId: string;
+    authUrl: string;
+    redirectUri: string;
+    scope: string;
+}
+export interface SsoProviderServerConfig {
+    providerId: SsoProviderId;
+    clientId: string;
+    clientSecret: string;
+    tokenUrl: string;
+    userInfoUrl: string;
+    jwksUrl?: string;
+}
+export interface SsoServerConfig {
+    /** Server's private KDF secret used to derive server-delegate keystones. */
+    ssoServerKdfSecret: string;
+    /** Server's private session encryption secret. */
+    sessionSecret: string;
+    /** Map of active OAuth2 providers. */
+    providers: Partial<Record<SsoProviderId, SsoProviderServerConfig>>;
+}
+export interface OAuthUserInfo {
+    /** Unique identity key combining provider and sub ID (e.g., `google:107632...`). */
+    providerKey: string;
+    providerId: SsoProviderId;
+    /** Unique user ID within the provider. */
+    sub: string;
+    email?: string;
+    name?: string;
+    picture?: string;
+}
+/**
+ * Single-turn authorization requirements object issued by the custodian server
+ * after successful passwordless SSO/Email authentication.
+ *
+ * Placed in `delegateKeystone.data.frameDetails.custodianReqs` when registering
+ * a client delegate keystone via passwordless onboarding.
+ */
+export interface CustodianRequirements {
+    /**
+     * The primary identity keystone TJP address (`ib^gib`) to which the delegate keystone will be registered.
+     * Prevents Man-In-The-Middle reuse of authorization requirements across different primary identities.
+     */
+    primaryTjpAddr: string;
+    /**
+     * High-entropy, single-turn random nonce generated by the server.
+     * Prevents replay attacks when registering delegate keystones.
+     */
+    nonce: string;
+    /**
+     * Single-turn authorization code computed by the server over `Omit<CustodianRequirements, 'authCode'>`.
+     */
+    authCode: string;
+    /**
+     * Expiration timestamp in epoch milliseconds after which this requirements object is invalid.
+     */
+    expiresAt: number;
+    /**
+     * Explicit list of permitted keystone verbs allowed for the delegate keystone (e.g., `['sync', 'connect']`).
+     */
+    allowedVerbs: string[];
+}
+//# sourceMappingURL=sso-types.d.mts.map

package/dist/identity/sso/sso-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sso-types.d.mts","sourceRoot":"","sources":["../../../src/identity/sso/sso-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,aAAa;IAC1B,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,aAAa,CAAC;IAC1B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/identity/sso/sso-types.mjs

@@ -0,0 +1,7 @@
+/**
+ * @module identity/sso/sso-types
+ *
+ * Core types and interfaces for extensible SSO (OAuth2) authentication on the server.
+ */
+export {};
+//# sourceMappingURL=sso-types.mjs.map

package/dist/identity/sso/sso-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sso-types.mjs","sourceRoot":"","sources":["../../../src/identity/sso/sso-types.mts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.mts

@@ -8,6 +8,10 @@ export * from './foo.mjs';
 export * from './helpers.mjs';
 export * from './types.mjs';
 export * from './serve-gib/index.mjs';
-export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, } from './email/index.mjs';
+export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, createMagicLinkToken, verifyMagicLinkToken, markNonceUsed, isNonceUsed, clearConsumedNonces, DEFAULT_MAGIC_LINK_TTL_MS, getMagicLinkSecret, } from './email/index.mjs';
 export type * from './email/email-types.mjs';
+export * from './identity/sso/sso-custodian-service.mjs';
+export * from './identity/sso/sso-config-helper.mjs';
+export * from './identity/sso/custodian-auth-helpers.mjs';
+export type * from './identity/sso/sso-types.mjs';
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAG5B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAG5B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,yBAAyB,CAAC;AAG7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2CAA2C,CAAC;AAC1D,mBAAmB,8BAA8B,CAAC"}

package/dist/index.mjs

@@ -10,5 +10,9 @@ export * from './types.mjs';
 // serve-gib microframework
 export * from './serve-gib/index.mjs';
 // email infrastructure
-export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, } from './email/index.mjs';
+export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, createMagicLinkToken, verifyMagicLinkToken, markNonceUsed, isNonceUsed, clearConsumedNonces, DEFAULT_MAGIC_LINK_TTL_MS, getMagicLinkSecret, } from './email/index.mjs';
+// identity & SSO custodian infrastructure
+export * from './identity/sso/sso-custodian-service.mjs';
+export * from './identity/sso/sso-config-helper.mjs';
+export * from './identity/sso/custodian-auth-helpers.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B,2BAA2B;AAC3B,cAAc,uBAAuB,CAAC;AAEtC,uBAAuB;AACvB,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B,2BAA2B;AAC3B,cAAc,uBAAuB,CAAC;AAEtC,uBAAuB;AACvB,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,0CAA0C;AAC1C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2CAA2C,CAAC"}

package/dist/serve-gib/handlers/api/email/email-outbound.handler.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"email-outbound.handler.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/email/email-outbound.handler.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAiB,MAAM,mCAAmC,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,2BAA2B;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;IACzD,UAAmB,EAAE,SAAoC;IACzD,UAAmB,MAAM,EAAE,kBAAkB,CAAU;IACvD,UAAmB,KAAK,SAA+B;IAEvD,OAAO,CAAC,MAAM,CAAc;IAE5B,YAAY,OAAO,GAAE,2BAAgC,EAiBpD;IAED,UAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAgC3F;CACJ"}
+{"version":3,"file":"email-outbound.handler.d.mts","sourceRoot":"","sources":["../../../../../src/serve-gib/handlers/api/email/email-outbound.handler.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAiB,MAAM,mCAAmC,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,2BAA2B;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;IACzD,UAAmB,EAAE,SAAoC;IACzD,UAAmB,MAAM,EAAE,kBAAkB,CAAU;IACvD,UAAmB,KAAK,SAA+B;IAEvD,OAAO,CAAC,MAAM,CAAc;IAE5B,YAAY,OAAO,GAAE,2BAAgC,EAuBpD;IAED,UAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAgC3F;CACJ"}