@outfoxx/sunday 2.0.0-beta.2 → 2.0.0-beta.4

package/build/token-manager.d.ts

@@ -0,0 +1,33 @@
+import { SecurityBinding } from './security-binding.js';
+import { TokenProvider, TokenSet, TokenStore } from './token-provider.js';
+/** A credential receipt used for conditional invalidation after an invalid-token response. */
+export interface TokenLease {
+    readonly key: string;
+    readonly tokens: TokenSet;
+}
+/**
+ * Shared token lifecycle with one renewal per cache key. Canceling one caller leaves other waiters
+ * running; canceling the last waiter signals the provider. A failed renewal is never cached.
+ */
+export declare class TokenManager {
+    private readonly providers;
+    private readonly store;
+    private readonly renewals;
+    private readonly authorizationAttempts;
+    private readonly locks;
+    private readonly now;
+    private readonly skew;
+    constructor(providers: Readonly<Record<string, TokenProvider>>, options?: {
+        store?: TokenStore;
+        expirySkewMs?: number;
+        now?: () => number;
+    });
+    /** Acquires current credentials without invoking authorization twice for an expired interactive session. */
+    credentials(binding: SecurityBinding, signal?: AbortSignal): Promise<TokenLease>;
+    /** Invalidates only the credential that failed, preserving a token already renewed by another caller. */
+    invalidate(lease: TokenLease): Promise<void>;
+    private exclusive;
+    private renew;
+    private acquireOrRefresh;
+    private join;
+}

package/build/token-manager.js

@@ -0,0 +1,199 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { AuthorizationRequiredError, TokenProviderError, } from './token-provider.js';
+/**
+ * Shared token lifecycle with one renewal per cache key. Canceling one caller leaves other waiters
+ * running; canceling the last waiter signals the provider. A failed renewal is never cached.
+ */
+export class TokenManager {
+    providers;
+    store;
+    renewals = new Map();
+    authorizationAttempts = new Set();
+    locks = new Map();
+    now;
+    skew;
+    constructor(providers, options = {}) {
+        this.providers = new Map(Object.entries(providers));
+        this.store = options.store ?? new MemoryTokenStore();
+        this.now = options.now ?? Date.now;
+        this.skew = options.expirySkewMs ?? 30_000;
+        if (!Number.isFinite(this.skew) || this.skew < 0)
+            throw new RangeError('Invalid token expiry skew');
+    }
+    /** Acquires current credentials without invoking authorization twice for an expired interactive session. */
+    async credentials(binding, signal) {
+        signal?.throwIfAborted();
+        const provider = this.providers.get(binding.provider);
+        if (!provider)
+            throw new TokenProviderError();
+        let configuration;
+        try {
+            configuration = provider.configure(binding);
+        }
+        catch {
+            throw new TokenProviderError();
+        }
+        if (!provider.identity.trim() || !configuration.clientIdentity.trim() ||
+            (binding.flow === 'authorizationCode' && !configuration.grantIdentity?.trim()))
+            throw new TokenProviderError();
+        const request = Object.freeze({
+            ...binding,
+            discoveryUrl: configuration.endpoints?.discoveryUrl ?? binding.discoveryUrl,
+            authorizationUrl: configuration.endpoints?.authorizationUrl ?? binding.authorizationUrl,
+            tokenUrl: configuration.endpoints?.tokenUrl ?? binding.tokenUrl,
+            refreshUrl: configuration.endpoints?.refreshUrl ?? binding.refreshUrl,
+            clientIdentity: configuration.clientIdentity,
+            grantIdentity: configuration.grantIdentity,
+            scopes: Object.freeze([...new Set(binding.scopes)].sort(compareScopes)),
+            transport: Object.freeze({ ...binding.transport }),
+        });
+        const key = JSON.stringify([
+            request.scheme, binding.provider, provider.identity, request.clientIdentity, request.grantIdentity,
+            request.profile, request.flow, request.discoveryUrl, request.authorizationUrl, request.tokenUrl,
+            request.refreshUrl, request.scopes, request.audience, request.resource,
+        ]);
+        let renewal = this.renewals.get(key);
+        if (!renewal || renewal.controller.signal.aborted) {
+            const controller = new AbortController();
+            const created = {
+                controller, waiters: 0, settled: false, committing: false,
+                promise: this.exclusive(key, () => this.renew(key, provider, request, controller.signal)),
+            };
+            this.renewals.set(key, created);
+            void created.promise.finally(() => {
+                created.settled = true;
+                if (this.renewals.get(key) === created)
+                    this.renewals.delete(key);
+            }).catch(() => undefined);
+            renewal = created;
+        }
+        return this.join(renewal, signal);
+    }
+    /** Invalidates only the credential that failed, preserving a token already renewed by another caller. */
+    async invalidate(lease) {
+        try {
+            await this.exclusive(lease.key, async () => {
+                const current = await this.store.load(lease.key);
+                if (current?.accessToken === lease.tokens.accessToken) {
+                    await this.store.save(lease.key, Object.freeze({ ...current, expiresAt: 0 }));
+                }
+            });
+        }
+        catch {
+            throw new TokenProviderError();
+        }
+    }
+    exclusive(key, action) {
+        const prior = this.locks.get(key) ?? Promise.resolve();
+        const next = prior.catch(() => undefined).then(action);
+        this.locks.set(key, next);
+        void next.finally(() => {
+            if (this.locks.get(key) === next)
+                this.locks.delete(key);
+        }).catch(() => undefined);
+        return next;
+    }
+    async renew(key, provider, request, signal) {
+        try {
+            signal.throwIfAborted();
+            const stored = await this.store.load(key);
+            signal.throwIfAborted();
+            if (stored && (stored.expiresAt === undefined || stored.expiresAt > this.now() + this.skew)) {
+                return { key, tokens: Object.freeze({ ...stored }) };
+            }
+            const tokens = await this.acquireOrRefresh(key, stored, provider, request, signal);
+            if (!tokens.accessToken || (tokens.expiresAt !== undefined &&
+                (!Number.isFinite(tokens.expiresAt) || tokens.expiresAt <= this.now())))
+                throw new TokenProviderError();
+            const snapshot = Object.freeze({ ...tokens });
+            signal.throwIfAborted();
+            const renewal = this.renewals.get(key);
+            if (renewal?.controller.signal !== signal)
+                throw new DOMException('Renewal expired', 'AbortError');
+            // Once persistence begins, cancellation must not discard a rotated refresh token.
+            renewal.committing = true;
+            await this.store.save(key, snapshot);
+            return { key, tokens: snapshot };
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw signal.reason;
+            if (error instanceof AuthorizationRequiredError || error instanceof TokenProviderError)
+                throw error;
+            throw new TokenProviderError();
+        }
+    }
+    async acquireOrRefresh(key, stored, provider, request, signal) {
+        if (stored?.refreshToken && provider.refresh) {
+            try {
+                const refreshed = await provider.refresh(request, stored.refreshToken, signal);
+                return { ...refreshed, refreshToken: refreshed.refreshToken ?? stored.refreshToken };
+            }
+            catch (error) {
+                if (!(error instanceof TokenProviderError) || error.reason !== 'invalidGrant' || request.flow !== 'clientCredentials')
+                    throw error;
+                signal.throwIfAborted();
+                await this.store.remove(key);
+                return provider.acquire(request, signal);
+            }
+        }
+        else if (request.flow === 'authorizationCode' && (stored || this.authorizationAttempts.has(key))) {
+            throw new AuthorizationRequiredError();
+        }
+        else {
+            if (request.flow === 'authorizationCode')
+                this.authorizationAttempts.add(key);
+            return provider.acquire(request, signal);
+        }
+    }
+    join(renewal, signal) {
+        renewal.waiters++;
+        return new Promise((resolve, reject) => {
+            let completed = false;
+            const finish = (value, error) => {
+                if (completed)
+                    return;
+                completed = true;
+                signal?.removeEventListener('abort', abort);
+                renewal.waiters--;
+                if (renewal.waiters === 0 && !renewal.settled && !renewal.committing)
+                    renewal.controller.abort();
+                if (value)
+                    resolve(value);
+                else
+                    reject(error);
+            };
+            const abort = () => finish(undefined, signal?.reason);
+            signal?.addEventListener('abort', abort, { once: true });
+            if (signal?.aborted)
+                abort();
+            renewal.promise.then(value => finish(value), error => finish(undefined, error));
+        });
+    }
+}
+class MemoryTokenStore {
+    tokens = new Map();
+    load(key) { return Promise.resolve(this.tokens.get(key)); }
+    save(key, tokens) { this.tokens.set(key, tokens); return Promise.resolve(); }
+    remove(key) { this.tokens.delete(key); return Promise.resolve(); }
+}
+function compareScopes(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=token-manager.js.map

package/build/token-manager.js.map

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

package/build/token-provider.d.ts

@@ -0,0 +1,44 @@
+import { SecurityBinding, SecurityEndpoints } from './security-binding.js';
+/** Credentials returned by an application provider; values are never included in runtime diagnostics. */
+export interface TokenSet {
+    readonly accessToken: string;
+    readonly expiresAt?: number;
+    readonly refreshToken?: string;
+}
+/** Non-secret identities isolate cache entries; grantIdentity must change with session or grant inputs. */
+export interface TokenConfiguration {
+    readonly clientIdentity: string;
+    readonly grantIdentity?: string;
+    readonly endpoints?: SecurityEndpoints;
+}
+/** Fully selected acquisition parameters; this contains neither client secrets nor authorization codes. */
+export interface TokenRequest extends SecurityBinding {
+    readonly clientIdentity: string;
+    readonly grantIdentity?: string;
+}
+/**
+ * Application credential binding. OAuth providers exchange fresh authorization and refresh tokens;
+ * the shared manager owns caching, rotation, renewal coalescing, and cancellation.
+ */
+export interface TokenProvider {
+    readonly identity: string;
+    configure(binding: SecurityBinding): TokenConfiguration;
+    acquire(request: TokenRequest, signal: AbortSignal): Promise<TokenSet>;
+    refresh?(request: TokenRequest, refreshToken: string, signal: AbortSignal): Promise<TokenSet>;
+}
+/** Application-owned storage. Implementations must serialize writes and keep credentials private. */
+export interface TokenStore {
+    load(key: string): Promise<TokenSet | undefined>;
+    save(key: string, tokens: TokenSet): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/** Signals that an interactive application must supply a fresh authorization session. */
+export declare class AuthorizationRequiredError extends Error {
+    constructor();
+}
+/** Safe provider failure without a provider's potentially credential-bearing error message. */
+export declare class TokenProviderError extends Error {
+    readonly reason: 'unavailable' | 'temporary' | 'invalidGrant';
+    /** Safe recovery classification; provider messages and credentials are never retained. */
+    constructor(reason?: 'unavailable' | 'temporary' | 'invalidGrant');
+}

package/build/token-provider.js

@@ -0,0 +1,31 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/** Signals that an interactive application must supply a fresh authorization session. */
+export class AuthorizationRequiredError extends Error {
+    constructor() {
+        super('Fresh application authorization is required');
+        this.name = 'AuthorizationRequiredError';
+    }
+}
+/** Safe provider failure without a provider's potentially credential-bearing error message. */
+export class TokenProviderError extends Error {
+    reason;
+    /** Safe recovery classification; provider messages and credentials are never retained. */
+    constructor(reason = 'unavailable') {
+        super('The credential provider could not supply usable credentials');
+        this.reason = reason;
+        this.name = 'TokenProviderError';
+    }
+}
+//# sourceMappingURL=token-provider.js.map

package/build/token-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-provider.js","sourceRoot":"","sources":["../src/token-provider.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,gDAAgD;AAChD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AA0CjC,yFAAyF;AACzF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD;QACE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEtB;IADrB,0FAA0F;IAC1F,YAAqB,SAAuD,aAAa;QACvF,KAAK,CAAC,6DAA6D,CAAC,CAAC;QADlD,WAAM,GAAN,MAAM,CAA8D;QAEvF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/build/transport.d.ts

@@ -1,3 +1,4 @@
+import { SecurityBinding } from './security-binding.js';
 import { MediaType } from './media-type.js';
 import { TextMediaTypeDecoder } from './media-type-codecs/media-type-decoder.js';
 import { Problem } from './problem.js';
@@ -33,6 +34,8 @@ export interface RequestSpec<B> {
     acceptTypes?: MediaType[];
     headers?: Record<string, unknown>;
     signal?: AbortSignal;
+    /** Complete, explicitly selected credential bindings for this operation. */
+    security?: readonly SecurityBinding[];
 }
 export interface RequestAdapter {
     adapt(transport: Transport, request: Request): Promise<Request>;

package/build/unknown-variant.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Marks a fallback independently of its discriminator or structural fields. */
+export declare const UnknownVariantTag: unique symbol;
+/** An unknown discriminated payload whose original wire fields are preserved. */
+export interface UnknownVariant {
+    readonly [UnknownVariantTag]: true;
+    readonly rawBody: Readonly<Record<string, unknown>>;
+}
+/** Identifies fallback instances even when their discriminator resembles a known branch. */
+export declare function isUnknownVariant(value: unknown): value is UnknownVariant;
+/** Dispatches encoding by fallback identity while retaining native schema validation. */
+export declare function unionWithUnknown<K extends z.ZodType, U extends z.ZodType<UnknownVariant>>(known: K, unknown: U): z.ZodType<z.output<K> | z.output<U>>;

package/build/unknown-variant.js

@@ -0,0 +1,45 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { z } from 'zod';
+/** Marks a fallback independently of its discriminator or structural fields. */
+export const UnknownVariantTag = Symbol.for('@outfoxx/sunday/UnknownVariant');
+/** Identifies fallback instances even when their discriminator resembles a known branch. */
+export function isUnknownVariant(value) {
+    return typeof value === 'object' && value !== null
+        && UnknownVariantTag in value && value[UnknownVariantTag] === true;
+}
+/** Dispatches encoding by fallback identity while retaining native schema validation. */
+export function unionWithUnknown(known, unknown) {
+    const wire = z.union([known, unknown]);
+    return z.codec(z.unknown(), z.custom(), {
+        decode(value, context) {
+            const result = wire.safeParse(value);
+            if (!result.success) {
+                context.issues.push(...result.error.issues.map(issue => ({ ...issue, input: undefined })));
+                return z.NEVER;
+            }
+            return result.data;
+        },
+        encode(value, context) {
+            const schema = isUnknownVariant(value) ? unknown : known;
+            const result = schema.safeEncode(value);
+            if (!result.success) {
+                context.issues.push(...result.error.issues.map(issue => ({ ...issue, input: undefined })));
+                return z.NEVER;
+            }
+            return result.data;
+        },
+    });
+}
+//# sourceMappingURL=unknown-variant.js.map

package/build/unknown-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-variant.js","sourceRoot":"","sources":["../src/unknown-variant.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,gDAAgD;AAChD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAQ7F,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;WAC7C,iBAAiB,IAAI,KAAK,IAAI,KAAK,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;AACvE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAC9B,KAAQ,EACR,OAAU;IAEV,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAA6B,EAAE;QACjE,MAAM,CAAC,KAAK,EAAE,OAAO;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC3F,OAAO,CAAC,CAAC,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,OAAO;YACnB,MAAM,MAAM,GAAc,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC3F,OAAO,CAAC,CAAC,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outfoxx/sunday",
-  "version": "v2.0.0-beta.2",
+  "version": "v2.0.0-beta.4",
   "description": "Sunday 🙏 The framework of REST for TypeScript/JavaScript",
   "packageManager": "bun@1.3.10",
   "type": "module",