@outfoxx/sunday 1.1.0 → 2.0.0-beta.10

package/build/security-binding.d.ts

@@ -0,0 +1,22 @@
+/** Acquisition endpoints selected by generation; deployment overrides never select another profile. */
+export interface SecurityEndpoints {
+    readonly discoveryUrl?: string;
+    readonly authorizationUrl?: string;
+    readonly tokenUrl?: string;
+    readonly refreshUrl?: string;
+}
+/** One logical scheme in the complete alternative selected for an operation. */
+export interface SecurityBinding extends SecurityEndpoints {
+    readonly scheme: string;
+    readonly provider: string;
+    readonly profile?: string;
+    readonly flow: 'clientCredentials' | 'authorizationCode' | 'external' | 'static';
+    readonly scopes: readonly string[];
+    readonly audience?: string;
+    readonly resource?: string;
+    readonly transport: {
+        readonly location: 'header' | 'query' | 'cookie';
+        readonly name: string;
+        readonly prefix?: string;
+    };
+}

package/build/{result-response.js → security-binding.js}

@@ -12,4 +12,4 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 export {};
-//# sourceMappingURL=result-response.js.map
+//# sourceMappingURL=security-binding.js.map

package/build/security-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-binding.js","sourceRoot":"","sources":["../src/security-binding.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"}

package/build/streaming-body.d.ts

@@ -0,0 +1,21 @@
+/** Binary chunk values supported by streaming request bodies. */
+export type StreamingBodyChunk = ArrayBuffer | Uint8Array;
+/** Creates a fresh async byte sequence for a streaming request body. */
+export type StreamingBodyBytesFactory = () => AsyncIterable<StreamingBodyChunk>;
+/** Creates a fresh web readable stream for a streaming request body. */
+export type StreamingBodyStreamFactory = () => ReadableStream<Uint8Array>;
+/** A lazily-created request body for streaming uploads. */
+export declare class StreamingBody {
+    private readonly createBody;
+    private constructor();
+    /** Creates a streaming body from a reusable web platform `Blob`. */
+    static blob(blob: Blob): StreamingBody;
+    /** Creates a streaming body from a fresh web `ReadableStream` factory. */
+    static stream(factory: StreamingBodyStreamFactory): StreamingBody;
+    /** Creates a streaming body from a fresh async byte iterable factory. */
+    static bytes(factory: StreamingBodyBytesFactory): StreamingBody;
+    /** Creates the web platform body value consumed by `fetch`. */
+    toBodyInit(): BodyInit;
+}
+/** Returns true when a value is a Sunday streaming request body. */
+export declare function isStreamingBody(value: unknown): value is StreamingBody;

package/build/streaming-body.js

@@ -0,0 +1,65 @@
+// 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.
+/** A lazily-created request body for streaming uploads. */
+export class StreamingBody {
+    createBody;
+    constructor(createBody) {
+        this.createBody = createBody;
+    }
+    /** Creates a streaming body from a reusable web platform `Blob`. */
+    static blob(blob) {
+        return new StreamingBody(() => blob);
+    }
+    /** Creates a streaming body from a fresh web `ReadableStream` factory. */
+    static stream(factory) {
+        return new StreamingBody(factory);
+    }
+    /** Creates a streaming body from a fresh async byte iterable factory. */
+    static bytes(factory) {
+        return new StreamingBody(() => asyncBytesToReadableStream(factory()));
+    }
+    /** Creates the web platform body value consumed by `fetch`. */
+    toBodyInit() {
+        return this.createBody();
+    }
+}
+/** Returns true when a value is a Sunday streaming request body. */
+export function isStreamingBody(value) {
+    return value instanceof StreamingBody;
+}
+function asyncBytesToReadableStream(bytes) {
+    const iterator = bytes[Symbol.asyncIterator]();
+    return new ReadableStream({
+        async pull(controller) {
+            try {
+                const next = await iterator.next();
+                if (next.done === true) {
+                    controller.close();
+                    return;
+                }
+                controller.enqueue(toUint8Array(next.value));
+            }
+            catch (error) {
+                controller.error(error);
+            }
+        },
+        async cancel(reason) {
+            await iterator.return?.(reason);
+        },
+    });
+}
+function toUint8Array(chunk) {
+    return chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk);
+}
+//# sourceMappingURL=streaming-body.js.map

package/build/streaming-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-body.js","sourceRoot":"","sources":["../src/streaming-body.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;AAWjC,2DAA2D;AAC3D,MAAM,OAAO,aAAa;IAEL;IADnB,YACmB,UAA0B;QAA1B,eAAU,GAAV,UAAU,CAAgB;IAE7C,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,IAAI,CAAC,IAAU;QACpB,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,0EAA0E;IAC1E,MAAM,CAAC,MAAM,CAAC,OAAmC;QAC/C,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,yEAAyE;IACzE,MAAM,CAAC,KAAK,CAAC,OAAkC;QAC7C,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,+DAA+D;IAC/D,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAwC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAE/C,OAAO,IAAI,cAAc,CAAa;QACpC,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBACvB,UAAU,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO;gBACT,CAAC;gBACD,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,OAAO,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC"}

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/{request-factory.d.ts → transport.d.ts}

@@ -1,18 +1,19 @@
+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';
-import { ResultResponse } from './result-response.js';
+import { OperationResponse } from './operation-response.js';
 import { SchemaLike } from './schema-runtime.js';
 import { URLTemplate } from './url-template.js';
 import { Logger } from './logger.js';
-export interface RequestFactory {
+export interface Transport<NativeRequest = Request> {
     readonly baseUrl: URLTemplate;
     registerProblem(type: URL | string, problemType: SchemaLike<Problem>): void;
-    request(requestSpec: RequestSpec<unknown>): Promise<Request>;
-    response(request: Request, dataExpected?: boolean): Promise<Response>;
-    response<B>(requestSpec: RequestSpec<B>, dataExpected?: boolean): Promise<Response>;
-    resultResponse<B, R>(requestSpec: RequestSpec<B>, resultType: SchemaLike<R>): Promise<ResultResponse<R>>;
-    resultResponse<B>(requestSpec: RequestSpec<B>): Promise<ResultResponse<void>>;
+    transportRequest(requestSpec: RequestSpec<unknown>): Promise<NativeRequest>;
+    transportResponse(request: NativeRequest, dataExpected?: boolean): Promise<Response>;
+    transportResponse<B>(requestSpec: RequestSpec<B>, dataExpected?: boolean): Promise<Response>;
+    response<B, R>(requestSpec: RequestSpec<B>, resultType: SchemaLike<R>): Promise<OperationResponse<R>>;
+    response<B>(requestSpec: RequestSpec<B>): Promise<OperationResponse<void>>;
     result<B, R>(requestSpec: RequestSpec<B>, resultType: SchemaLike<R>): Promise<R>;
     result<B>(requestSpec: RequestSpec<B>): Promise<void>;
     eventSource(requestSpec: RequestSpec<void>): ExtEventSource;
@@ -29,11 +30,15 @@ export interface RequestSpec<B> {
     queryParameters?: Record<string, unknown>;
     body?: B;
     bodyType?: SchemaLike<B>;
+    /** Revalidates typed parameters on every request build, before wire conversion. */
+    parameterValidation?: () => void;
     contentTypes?: MediaType[];
     acceptTypes?: MediaType[];
     headers?: Record<string, unknown>;
     signal?: AbortSignal;
+    /** Complete, explicitly selected credential bindings for this operation. */
+    security?: readonly SecurityBinding[];
 }
 export interface RequestAdapter {
-    adapt(requestFactory: RequestFactory, request: Request): Promise<Request>;
+    adapt(transport: Transport, request: Request): Promise<Request>;
 }

package/build/{request-factory.js → transport.js}

@@ -12,4 +12,4 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 export {};
-//# sourceMappingURL=request-factory.js.map
+//# sourceMappingURL=transport.js.map

package/build/transport.js.map

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

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/build/url-template.d.ts

@@ -1,6 +1,9 @@
+/** An RFC 6570 URL template with reusable parameter defaults. */
 export declare class URLTemplate {
     template: string;
     parameters: Record<string, unknown>;
+    /** Creates a template whose stored parameters can be overridden for each expansion. */
     constructor(template: string, parameters?: Record<string, unknown>);
+    /** Expands base and relative templates, preserving empty values and omitting null or missing values. */
     complete(relativeTemplate: string, parameters: Record<string, unknown>): URL;
 }

package/build/url-template.js

@@ -11,14 +11,17 @@
 // 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 { parse } from 'uri-template';
+import { expandExpression, parse } from 'uri-template';
+/** An RFC 6570 URL template with reusable parameter defaults. */
 export class URLTemplate {
     template;
     parameters;
+    /** Creates a template whose stored parameters can be overridden for each expansion. */
     constructor(template, parameters = {}) {
         this.template = template;
         this.parameters = parameters;
     }
+    /** Expands base and relative templates, preserving empty values and omitting null or missing values. */
     complete(relativeTemplate, parameters) {
         const allParameters = { ...this.parameters, ...parameters };
         const baseTempl = this.template.endsWith('/')
@@ -27,7 +30,32 @@ export class URLTemplate {
         const relTempl = relativeTemplate.startsWith('/') || !relativeTemplate.length
             ? relativeTemplate
             : `/${relativeTemplate}`;
-        return new URL(parse(baseTempl + relTempl).expand(allParameters));
+        const template = parse(baseTempl + relTempl);
+        const expanded = template.ast.parts
+            .map((part) => {
+            if (part.type === 'literal')
+                return part.value;
+            const value = expandExpression(part, allParameters);
+            // uri-template 2 drops the path prefix when defined variables expand to an empty string.
+            if (part.operator === '/' &&
+                value === '' &&
+                part.variables.some((variable) => isDefined(allParameters[variable.name]))) {
+                return '/';
+            }
+            return value;
+        })
+            .join('');
+        return new URL(expanded);
     }
 }
+// RFC 6570 treats empty collections as undefined, but an empty string is defined.
+function isDefined(value) {
+    if (value == null)
+        return false;
+    if (typeof value !== 'object')
+        return true;
+    if (Array.isArray(value))
+        return value.length > 0;
+    return Object.values(value).some((entry) => entry != null);
+}
 //# sourceMappingURL=url-template.js.map