@relyper/sp-auth 0.1.0 → 0.4.0

package/dist/coins.d.ts.map

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

package/dist/coins.js

@@ -0,0 +1,210 @@
+/**
+ * Client for the Relyper Coins integration API.
+ *
+ * Relyper Coins are held centrally: the wallet at the identity provider is the
+ * single source of truth for what a user can spend across every Relyper product.
+ * A service provider therefore never keeps its own balance -- it asks, and it
+ * debits, and anything it stores locally is a mirror for its own reporting.
+ *
+ * The service provider authenticates with the same client ID and secret it uses
+ * for the OIDC login, so every debit is attributable to one registered client
+ * and an operator can allow or refuse coin spending per app.
+ */
+export class RelyperCoinsError extends Error {
+    code;
+    status;
+    /** Present on insufficient_funds. */
+    balanceRc;
+    requestedRc;
+    cause;
+    /**
+     * What the service actually answered, and where it was asked.
+     *
+     * Kept because a status code alone does not identify a cause: a 403 from the
+     * coins service and a 403 from a proxy in front of it are the same number and
+     * mean entirely different things. Without the body, an operator holding a
+     * correctly configured client has nothing to go on but a message this library
+     * guessed. `responseError` is the service's own error code when it sent one.
+     */
+    url;
+    responseError;
+    responseBody;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = 'RelyperCoinsError';
+        this.code = code;
+        this.status = options.status ?? 502;
+        this.balanceRc = options.balanceRc;
+        this.requestedRc = options.requestedRc;
+        this.cause = options.cause;
+        this.url = options.url;
+        this.responseError = options.responseError;
+        this.responseBody = options.responseBody;
+    }
+}
+/**
+ * Derives the coins API base URL from an OIDC issuer.
+ *
+ * The Relyper IdP publishes OIDC at the issuer root but mounts its regular API
+ * under `/api`, so the two differ by exactly that segment.
+ */
+export function coinsBaseUrlFromIssuer(issuer) {
+    const trimmed = trimTrailingSlashes(issuer);
+    return trimmed.endsWith('/api') ? trimmed : trimmed + '/api';
+}
+export function createRelyperCoinsClient(options) {
+    for (const key of ['baseUrl', 'clientId', 'clientSecret']) {
+        if (!options[key] || typeof options[key] !== 'string') {
+            throw new TypeError('@relyper/sp-auth/coins: ' + key + ' is required.');
+        }
+    }
+    const doFetch = options.fetch ?? globalThis.fetch;
+    if (typeof doFetch !== 'function') {
+        throw new TypeError('@relyper/sp-auth/coins: no fetch implementation available.');
+    }
+    const baseUrl = trimTrailingSlashes(options.baseUrl);
+    const timeout = options.requestTimeoutMs ?? 10_000;
+    // RFC 6749 section 2.3.1: both halves are form-urlencoded before the base64.
+    const authorization = 'Basic ' + Buffer.from(encodeURIComponent(options.clientId) + ':' + encodeURIComponent(options.clientSecret), 'utf8').toString('base64');
+    async function call(path, init) {
+        const url = baseUrl + path;
+        let response;
+        try {
+            response = await doFetch(url, {
+                method: init.method,
+                headers: {
+                    authorization,
+                    accept: 'application/json',
+                    ...(init.body === undefined ? {} : { 'content-type': 'application/json' })
+                },
+                body: init.body === undefined ? undefined : JSON.stringify(init.body),
+                signal: AbortSignal.timeout(timeout)
+            });
+        }
+        catch (cause) {
+            throw new RelyperCoinsError('unavailable', 'The Relyper coin service could not be reached.', { cause });
+        }
+        const { payload, raw } = await readBody(response);
+        if (response.ok)
+            return payload ?? {};
+        const error = typeof payload?.error === 'string' ? payload.error : '';
+        // Passed to every throw below so the caller can log what was actually
+        // answered instead of only what this library concluded from it.
+        const evidence = { url, responseError: error || undefined, responseBody: raw || undefined };
+        if (response.status === 402 || error === 'insufficient_funds') {
+            throw new RelyperCoinsError('insufficient_funds', 'Not enough Relyper Coins.', {
+                status: 402,
+                balanceRc: numberOrUndefined(payload?.balanceRc),
+                requestedRc: numberOrUndefined(payload?.requestedRc),
+                ...evidence
+            });
+        }
+        // Only the service's own error code identifies this cause. A bare 403 is
+        // not evidence of it: an unmatched route, a gateway or a WAF in front of
+        // the service answers with the same status, and reporting those as a
+        // permission the operator has already granted sends them looking in the
+        // wrong place.
+        if (error === 'coins_not_enabled_for_client') {
+            throw new RelyperCoinsError('coins_not_enabled', 'This application is not allowed to spend Relyper Coins.', {
+                status: response.status,
+                ...evidence
+            });
+        }
+        if (response.status === 401) {
+            throw new RelyperCoinsError('unauthorized', 'The Relyper coin service rejected this application.', {
+                status: 401,
+                ...evidence
+            });
+        }
+        if (response.status === 403) {
+            throw new RelyperCoinsError('forbidden', 'The Relyper coin service refused this request with 403.', {
+                status: 403,
+                ...evidence
+            });
+        }
+        if (response.status === 400) {
+            throw new RelyperCoinsError('invalid_request', 'The coin request was rejected as invalid.', {
+                status: 400,
+                ...evidence
+            });
+        }
+        throw new RelyperCoinsError('unavailable', 'The Relyper coin service answered unexpectedly.', {
+            ...evidence,
+            status: response.status
+        });
+    }
+    function walletPath(subject) {
+        if (!subject)
+            throw new TypeError('@relyper/sp-auth/coins: subject is required.');
+        return '/integrations/coins/user/' + encodeURIComponent(subject);
+    }
+    return {
+        async getWallet(subject) {
+            return (await call(walletPath(subject), { method: 'GET' }));
+        },
+        async getLedger(subject, limit = 50) {
+            const payload = await call(walletPath(subject) + '/ledger?limit=' + encodeURIComponent(String(limit)), {
+                method: 'GET'
+            });
+            return Array.isArray(payload?.items) ? payload.items : [];
+        },
+        async debit(input) {
+            if (!(input.amountRc > 0)) {
+                throw new TypeError('@relyper/sp-auth/coins: amountRc must be greater than zero.');
+            }
+            const payload = await call(walletPath(input.subject) + '/debit', {
+                method: 'POST',
+                body: {
+                    amountRc: input.amountRc,
+                    reason: input.reason,
+                    idempotencyKey: input.idempotencyKey,
+                    product: input.product,
+                    provider: input.provider,
+                    model: input.model,
+                    tenantId: input.tenantId,
+                    meta: input.meta ?? {}
+                }
+            });
+            const { ledgerEntry, dedup, ...wallet } = payload ?? {};
+            return {
+                wallet: wallet,
+                entry: ledgerEntry ?? null,
+                deduplicated: dedup === true
+            };
+        }
+    };
+}
+function trimTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/')
+        end -= 1;
+    return value.slice(0, end);
+}
+function numberOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Reads the body once, as text, and parses JSON from that text.
+ *
+ * `response.json()` consumes the stream, so a body that is not JSON -- an HTML
+ * error page from a gateway, most importantly -- would be lost before anyone
+ * could look at it. The raw text is what makes those cases diagnosable, so it
+ * is kept and truncated rather than discarded.
+ */
+async function readBody(response) {
+    let raw = '';
+    try {
+        raw = await response.text();
+    }
+    catch {
+        return { payload: null, raw: '' };
+    }
+    const trimmed = raw.length > 500 ? raw.slice(0, 500) + '...' : raw;
+    try {
+        return { payload: JSON.parse(raw), raw: trimmed };
+    }
+    catch {
+        return { payload: null, raw: trimmed };
+    }
+}
+//# sourceMappingURL=coins.js.map

package/dist/coins.js.map

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

package/dist/oidc/claims.d.ts

@@ -0,0 +1,4 @@
+import type { RelyperIdentity } from '../types.js';
+export declare function asStringList(value: unknown): string[];
+export declare function defaultClaimsToIdentity(claims: Record<string, unknown>): RelyperIdentity;
+//# sourceMappingURL=claims.d.ts.map

package/dist/oidc/claims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.d.ts","sourceRoot":"","sources":["../../src/oidc/claims.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAcnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAQrD;AAkBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAcxF"}

package/dist/oidc/claims.js

@@ -0,0 +1,50 @@
+/**
+ * Maps the claims of a Relyper ID token onto the identity the application sees.
+ *
+ * The IdP sends tenant information under several names for backwards
+ * compatibility (`tenant`, `tenant_id`, `tenant_ids`, `tenants`); this collapses
+ * them into one shape so service providers do not each reinvent the reading.
+ */
+function asString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export function asStringList(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => asString(item)).filter(Boolean);
+    }
+    const single = asString(value);
+    if (!single)
+        return [];
+    // Some providers send space- or comma-separated lists in a single claim.
+    return single.split(/[\s,]+/).map((item) => item.trim()).filter(Boolean);
+}
+function tenantIdsFrom(claims) {
+    const explicit = asStringList(claims.tenant_ids);
+    if (explicit.length)
+        return explicit;
+    const tenants = claims.tenants;
+    if (Array.isArray(tenants)) {
+        const ids = tenants
+            .map((entry) => (entry && typeof entry === 'object' ? asString(entry.tenantId) : ''))
+            .filter(Boolean);
+        if (ids.length)
+            return ids;
+    }
+    const single = asString(claims.tenant_id) || asString(claims.tenant);
+    return single ? [single] : [];
+}
+export function defaultClaimsToIdentity(claims) {
+    const email = asString(claims.email);
+    const tenantIds = tenantIdsFrom(claims);
+    return {
+        subject: asString(claims.sub),
+        email,
+        displayName: asString(claims.name) || asString(claims.preferred_username) || email || 'Relyper User',
+        roles: asStringList(claims.roles),
+        tenantId: tenantIds[0] ?? null,
+        tenantIds,
+        tenantName: asString(claims.tenant_name) || null,
+        teams: asStringList(claims.teams)
+    };
+}
+//# sourceMappingURL=claims.js.map

package/dist/oidc/claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.js","sourceRoot":"","sources":["../../src/oidc/claims.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,yEAAyE;IACzE,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B;IACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO;aAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAE,KAAiC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACjH,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7B,KAAK;QACL,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,KAAK,IAAI,cAAc;QACpG,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;QACjC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI;QAC9B,SAAS;QACT,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI;QAChD,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/oidc/client.d.ts

@@ -0,0 +1,44 @@
+import type { RelyperIdentity } from '../types.js';
+import { type OidcDiscoveryDocument, type RelyperAuthorizationRequest, type RelyperLoginResult, type RelyperLoginTransaction, type RelyperOidcOptions, type ResolvedRelyperOidcOptions } from './types.js';
+export type AuthorizationRequestOptions = {
+    /** Local path to return to after the login. Anything else falls back to '/'. */
+    returnTo?: string;
+    /** OIDC `prompt`, e.g. 'login' to force re-authentication. */
+    prompt?: string;
+    /** OIDC `login_hint`, usually an e-mail address. */
+    loginHint?: string;
+};
+export type RelyperOidcClient = {
+    readonly options: ResolvedRelyperOidcOptions;
+    /** Discovery document, fetched on first use and cached afterwards. */
+    discover(): Promise<OidcDiscoveryDocument>;
+    /**
+     * Starts a login. Returns the IdP URL to redirect to plus the transaction the
+     * caller has to hand back to {@link RelyperOidcClient.completeLogin}.
+     */
+    createAuthorizationRequest(options?: AuthorizationRequestOptions): Promise<RelyperAuthorizationRequest>;
+    /**
+     * Completes a login: checks `state`, exchanges the code, verifies the ID token
+     * and returns the identity. Throws {@link RelyperOidcError} on every failure.
+     */
+    completeLogin(params: {
+        query: Record<string, string | string[] | undefined>;
+        transaction: RelyperLoginTransaction;
+    }): Promise<RelyperLoginResult>;
+    /** Role check, identical in semantics to the header-based variant. */
+    hasRole(identity: RelyperIdentity, role: string | string[], match?: 'any' | 'all'): boolean;
+    /** URL that ends the IdP session, or null if the IdP advertises none. */
+    endSessionUrl(options?: {
+        idTokenHint?: string;
+        postLogoutRedirectUri?: string;
+    }): Promise<string | null>;
+};
+export declare function createRelyperOidcClient(options: RelyperOidcOptions): RelyperOidcClient;
+/**
+ * Only a local path is ever used as a post-login target. An absolute URL, or a
+ * protocol-relative one starting with two slashes, would turn the login route
+ * into an open redirect. Backslashes are rejected too, because some browsers
+ * normalise them to forward slashes and would follow "/\\evil.example".
+ */
+export declare function safeReturnTo(value: unknown, fallback?: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/oidc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/oidc/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EAEvB,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAC;AAapB,MAAM,MAAM,2BAA2B,GAAG;IACxC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,sEAAsE;IACtE,QAAQ,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC3C;;;OAGG;IACH,0BAA0B,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACxG;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QACrD,WAAW,EAAE,uBAAuB,CAAC;KACtC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAC5F,yEAAyE;IACzE,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3G,CAAC;AA+BF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6RtF;AA2BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAM,GAAG,MAAM,CAOnE"}