@outfoxx/sunday 1.1.0 → 2.0.0-beta.10

package/build/model-schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { SchemaDef, SchemaRuntime } from './schema-runtime.js';
+/** Defines a generated synchronous model codec with native Zod cycle diagnostics in both directions. */
+export declare function defineModelSchema<Output, Input = unknown>(build: (runtime: SchemaRuntime) => z.ZodType<Output, Input>, options?: {
+    id?: symbol;
+    debugName?: string;
+}): SchemaDef<z.ZodType<Output, Input>>;
+/** Applies common native schema assertions without replacing a reusable union's payload type. */
+export declare function withModelConstraints<Output, Input>(payload: z.ZodType<Output, Input>, common: z.ZodType, discriminator?: string): z.ZodType<Output, Input>;

package/build/model-schema.js

@@ -0,0 +1,131 @@
+// 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 { Instant, LocalDate, LocalDateTime, LocalTime, OffsetDateTime, ZonedDateTime } from '@js-joda/core';
+import { z } from 'zod';
+import { defineSchema } from './schema-runtime.js';
+// Generated schemas and their transformations are synchronous. A root invocation owns the
+// untyped-payload cycle check; nested schemas protect only their own recursive entry points.
+let invocationDepth = 0;
+/** Defines a generated synchronous model codec with native Zod cycle diagnostics in both directions. */
+export function defineModelSchema(build, options) {
+    return defineSchema((runtime) => {
+        const schema = build(runtime);
+        const ancestors = new WeakSet();
+        function evaluate(value, context, direction) {
+            const object = typeof value === 'object' && value !== null ? value : undefined;
+            if (object && ancestors.has(object)) {
+                context.issues.push(cycleIssue([]));
+                return z.NEVER;
+            }
+            if (object)
+                ancestors.add(object);
+            const root = invocationDepth++ === 0;
+            try {
+                const result = direction === 'decode' ? schema.safeParse(value) : schema.safeEncode(value);
+                if (!result.success) {
+                    context.issues.push(...result.error.issues.map(issue => ({ ...issue, input: undefined })));
+                    return z.NEVER;
+                }
+                // Native object parsing has already removed non-participating fields. Inspecting its result
+                // also covers raw extension payloads without rejecting discarded input or invoking constructors.
+                const path = root ? cyclePath(result.data) : undefined;
+                if (path) {
+                    context.issues.push(cycleIssue(path));
+                    return z.NEVER;
+                }
+                return result.data;
+            }
+            finally {
+                invocationDepth--;
+                if (object)
+                    ancestors.delete(object);
+            }
+        }
+        return z.codec(z.custom(), z.custom(), {
+            decode: (value, context) => evaluate(value, context, 'decode'),
+            encode: (value, context) => evaluate(value, context, 'encode'),
+        });
+    }, options);
+}
+/** Applies common native schema assertions without replacing a reusable union's payload type. */
+export function withModelConstraints(payload, common, discriminator) {
+    function evaluate(value, context, direction) {
+        let fields = value;
+        if (direction === 'encode' && discriminator && typeof value === 'object' && value !== null && discriminator in value) {
+            const tag = value[discriminator];
+            if (typeof tag === 'object' && tag !== null && 'rawValue' in tag && typeof tag.rawValue === 'string') {
+                // Reused payload enums may have another nominal type; common tag rules inspect their wire value.
+                fields = { ...value, [discriminator]: tag.rawValue };
+            }
+        }
+        const constraints = direction === 'decode' ? common.safeParse(fields) : common.safeEncode(fields);
+        if (!constraints.success) {
+            context.issues.push(...constraints.error.issues.map(issue => ({ ...issue, input: undefined })));
+            return z.NEVER;
+        }
+        // Keep the selected payload's native conversion and identity. The common schema is assertion-only.
+        const result = direction === 'decode' ? payload.safeParse(value) : payload.safeEncode(value);
+        if (!result.success) {
+            context.issues.push(...result.error.issues.map(issue => ({ ...issue, input: undefined })));
+            return z.NEVER;
+        }
+        return result.data;
+    }
+    // A refinement attached directly to a union loses its issues during Zod's reverse union pass.
+    return z.codec(z.custom(), z.custom(), {
+        decode: (value, context) => evaluate(value, context, 'decode'),
+        encode: (value, context) => evaluate(value, context, 'encode'),
+    });
+}
+function cycleIssue(path) {
+    return { code: 'custom', input: undefined, message: 'Object cycles cannot be serialized', path, params: { reason: 'cycle' } };
+}
+function cyclePath(value) {
+    const ancestors = new WeakSet();
+    const pending = [{ value, path: [] }];
+    while (pending.length) {
+        const entry = pending.pop();
+        if (typeof entry.value !== 'object' || entry.value === null)
+            continue;
+        // Temporal codecs serialize these native values as scalars, not their cyclic zone-rule internals.
+        if (entry.value instanceof Instant || entry.value instanceof LocalDate ||
+            entry.value instanceof LocalDateTime || entry.value instanceof LocalTime ||
+            entry.value instanceof OffsetDateTime || entry.value instanceof ZonedDateTime)
+            continue;
+        if (entry.leave) {
+            ancestors.delete(entry.value);
+            continue;
+        }
+        if (ancestors.has(entry.value))
+            return entry.path;
+        ancestors.add(entry.value);
+        pending.push({ ...entry, leave: true });
+        const children = modelChildren(entry.value);
+        for (let index = children.length - 1; index >= 0; index--) {
+            const [key, item] = children[index];
+            pending.push({ value: item, path: [...entry.path, key] });
+        }
+    }
+    return undefined;
+}
+function modelChildren(value) {
+    if (Array.isArray(value))
+        return value.map((item, index) => [index, item]);
+    if (value instanceof Map)
+        return [...value].flatMap(([key, item], index) => [[`key:${index}`, key], [String(key), item]]);
+    if (value instanceof Set)
+        return [...value].map((item, index) => [index, item]);
+    return Object.entries(value);
+}
+//# sourceMappingURL=model-schema.js.map

package/build/model-schema.js.map

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

package/build/oauth-wire.d.ts

@@ -0,0 +1,33 @@
+import { TokenSet } from './token-provider.js';
+/** Internal wire decoding; client/session policy remains in the provider. */
+export declare class DiscoveryMetadata {
+    readonly issuer: string;
+    readonly tokenUrl: string | undefined;
+    readonly authorizationUrl: string | undefined;
+    readonly methods: readonly string[] | undefined;
+    private constructor();
+    static parse(body: string): DiscoveryMetadata;
+}
+/** Internal token message, validated before conversion to application credentials. */
+export declare class TokenSuccessResponse {
+    private readonly accessToken;
+    private readonly tokenType;
+    private readonly expiresIn;
+    private readonly refreshToken;
+    private readonly scope;
+    private constructor();
+    static parse(body: string): Promise<TokenSuccessResponse>;
+    tokens(scopes: readonly string[], now: number): TokenSet;
+    toString(): string;
+    toJSON(): string;
+}
+/** Internal error message; provider diagnostics never use descriptions from the server. */
+export declare class TokenErrorResponse {
+    readonly code: string;
+    private constructor();
+    static parse(body: string): TokenErrorResponse;
+    toString(): string;
+    toJSON(): string;
+}
+/** Validates a selected or advertised endpoint before application authorization. */
+export declare function endpoint(value: string | undefined): string;

package/build/oauth-wire.js

@@ -0,0 +1,143 @@
+// 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 * as oauth from 'oauth4webapi';
+import { parse, isLosslessNumber, isSafeNumber } from 'lossless-json';
+import { TokenProviderError } from './token-provider.js';
+/** Internal wire decoding; client/session policy remains in the provider. */
+export class DiscoveryMetadata {
+    issuer;
+    tokenUrl;
+    authorizationUrl;
+    methods;
+    constructor(issuer, tokenUrl, authorizationUrl, methods) {
+        this.issuer = issuer;
+        this.tokenUrl = tokenUrl;
+        this.authorizationUrl = authorizationUrl;
+        this.methods = methods;
+    }
+    static parse(body) {
+        const data = document(body);
+        const issuer = string(data, 'issuer', true);
+        const tokenUrl = string(data, 'token_endpoint');
+        const authorizationUrl = string(data, 'authorization_endpoint');
+        if (tokenUrl !== undefined)
+            endpoint(tokenUrl);
+        if (authorizationUrl !== undefined)
+            endpoint(authorizationUrl);
+        for (const name of ['jwks_uri', 'registration_endpoint', 'revocation_endpoint', 'introspection_endpoint']) {
+            const value = string(data, name);
+            if (value !== undefined)
+                endpoint(value);
+        }
+        let methods;
+        if ('token_endpoint_auth_methods_supported' in data) {
+            const raw = data.token_endpoint_auth_methods_supported;
+            if (!Array.isArray(raw) || raw.some(value => typeof value !== 'string'))
+                throw new TokenProviderError();
+            methods = raw;
+        }
+        return new DiscoveryMetadata(issuer, tokenUrl, authorizationUrl, methods);
+    }
+}
+/** Internal token message, validated before conversion to application credentials. */
+export class TokenSuccessResponse {
+    accessToken;
+    tokenType;
+    expiresIn;
+    refreshToken;
+    scope;
+    constructor(accessToken, tokenType, expiresIn, refreshToken, scope) {
+        this.accessToken = accessToken;
+        this.tokenType = tokenType;
+        this.expiresIn = expiresIn;
+        this.refreshToken = refreshToken;
+        this.scope = scope;
+    }
+    static async parse(body) {
+        const data = document(body);
+        let expiresIn;
+        if ('expires_in' in data) {
+            const raw = data.expires_in;
+            if (!isLosslessNumber(raw) || !isSafeNumber(raw.value) || !Number.isInteger(Number(raw.value)))
+                throw new TokenProviderError();
+            expiresIn = Number(raw.value);
+            data.expires_in = expiresIn;
+        }
+        const scope = string(data, 'scope');
+        if (scope !== undefined && !/^[\x21\x23-\x5b\x5d-\x7e]+(?: [\x21\x23-\x5b\x5d-\x7e]+)*(?![\s\S])/.test(scope))
+            throw new TokenProviderError();
+        // ID tokens are outside this OAuth-only API. Pass only the fields it consumes;
+        // oauth4webapi would otherwise also perform OIDC claim validation.
+        const protocolFields = Object.fromEntries(['access_token', 'token_type', 'expires_in', 'refresh_token', 'scope']
+            .filter(key => key in data).map(key => [key, data[key]]));
+        const parsed = await oauth.processGenericTokenEndpointResponse({ issuer: 'https://oauth.invalid' }, { client_id: 'sunday' }, Response.json(protocolFields));
+        return new TokenSuccessResponse(parsed.access_token, parsed.token_type, expiresIn, parsed.refresh_token, scope);
+    }
+    tokens(scopes, now) {
+        if (this.tokenType.toLowerCase() !== 'bearer' || (this.scope !== undefined && !scopes.every(scope => this.scope.split(' ').includes(scope))))
+            throw new TokenProviderError();
+        let expiresAt;
+        if (this.expiresIn !== undefined) {
+            expiresAt = Math.floor(now) + this.expiresIn * 1000;
+            if (this.expiresIn <= 0 || !Number.isSafeInteger(expiresAt))
+                throw new TokenProviderError();
+        }
+        return { accessToken: this.accessToken, expiresAt, refreshToken: this.refreshToken };
+    }
+    toString() { return 'OAuthSuccess()'; }
+    toJSON() { return this.toString(); }
+}
+/** Internal error message; provider diagnostics never use descriptions from the server. */
+export class TokenErrorResponse {
+    code;
+    constructor(code) {
+        this.code = code;
+    }
+    static parse(body) {
+        const data = document(body);
+        string(data, 'error_description', false, true);
+        string(data, 'error_uri');
+        return new TokenErrorResponse(string(data, 'error', true));
+    }
+    toString() { return 'OAuthError()'; }
+    toJSON() { return this.toString(); }
+}
+/** Validates a selected or advertised endpoint before application authorization. */
+export function endpoint(value) {
+    if (!value)
+        throw new TokenProviderError();
+    const url = new URL(value);
+    if (url.username || url.password || url.hash)
+        throw new TokenProviderError();
+    if (url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname)))
+        throw new TokenProviderError();
+    return url.toString();
+}
+function document(body) {
+    const data = parse(body);
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        throw new TokenProviderError();
+    return data;
+}
+function string(data, key, required = false, allowEmpty = false) {
+    if (!(key in data)) {
+        if (required)
+            throw new TokenProviderError();
+        return undefined;
+    }
+    if (typeof data[key] !== 'string' || (!allowEmpty && !data[key]))
+        throw new TokenProviderError();
+    return data[key];
+}
+//# sourceMappingURL=oauth-wire.js.map

package/build/oauth-wire.js.map

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

package/build/operation-response.d.ts

@@ -0,0 +1,33 @@
+import { MediaType } from './media-type.js';
+/** A single HTTP response header entry. */
+export interface ResponseHeaderEntry {
+    readonly name: string;
+    readonly value: string;
+}
+/** HTTP response headers with case-insensitive lookup. */
+export declare class ResponseHeaders {
+    readonly entries: readonly ResponseHeaderEntry[];
+    constructor(entries: readonly ResponseHeaderEntry[]);
+    /** Creates response headers from a Fetch API `Headers` value. */
+    static from(headers: Headers): ResponseHeaders;
+    /** Retrieves all values matching `name` case-insensitively. */
+    getAll(name: string): readonly string[];
+    /** Retrieves the first value matching `name` case-insensitively. */
+    get(name: string): string | undefined;
+    /** Parsed `Content-Type` header value. */
+    get contentType(): MediaType | undefined;
+}
+/** A decoded operation result with HTTP response metadata. */
+export declare class OperationResponse<R> {
+    readonly result: R;
+    readonly transportResponse: Response;
+    readonly status: number;
+    readonly headers: ResponseHeaders;
+    constructor(result: R, transportResponse: Response);
+    /** Retrieves all response header values matching `name`. */
+    getHeaders(name: string): readonly string[];
+    /** Retrieves the first response header value matching `name`. */
+    getHeader(name: string): string | undefined;
+    /** Parsed `Content-Type` header value. */
+    get contentType(): MediaType | undefined;
+}

package/build/operation-response.js

@@ -0,0 +1,140 @@
+// 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 { MediaType } from './media-type.js';
+const commaSeparatedResponseHeaders = new Set([
+    'accept-ranges',
+    'access-control-allow-headers',
+    'access-control-allow-methods',
+    'access-control-expose-headers',
+    'allow',
+    'cache-control',
+    'connection',
+    'content-encoding',
+    'link',
+    'transfer-encoding',
+    'upgrade',
+    'vary',
+]);
+/** HTTP response headers with case-insensitive lookup. */
+export class ResponseHeaders {
+    entries;
+    constructor(entries) {
+        this.entries = entries;
+    }
+    /** Creates response headers from a Fetch API `Headers` value. */
+    static from(headers) {
+        const entries = [];
+        const setCookies = headers.getSetCookie?.() ?? [];
+        headers.forEach((value, name) => {
+            if (name.toLowerCase() === 'set-cookie' && setCookies.length > 0) {
+                return;
+            }
+            splitHeaderValue(name, value).forEach((value) => {
+                entries.push({ name, value });
+            });
+        });
+        setCookies.forEach((value) => {
+            entries.push({ name: 'set-cookie', value });
+        });
+        return new ResponseHeaders(entries);
+    }
+    /** Retrieves all values matching `name` case-insensitively. */
+    getAll(name) {
+        return this.entries
+            .filter((entry) => entry.name.toLowerCase() === name.toLowerCase())
+            .map((entry) => entry.value);
+    }
+    /** Retrieves the first value matching `name` case-insensitively. */
+    get(name) {
+        return this.entries.find((entry) => entry.name.toLowerCase() === name.toLowerCase())?.value;
+    }
+    /** Parsed `Content-Type` header value. */
+    get contentType() {
+        const value = this.get('content-type');
+        if (!value) {
+            return undefined;
+        }
+        try {
+            return MediaType.from(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function splitHeaderValue(name, value) {
+    if (!commaSeparatedResponseHeaders.has(name.toLowerCase())) {
+        return [value];
+    }
+    const values = [];
+    let start = 0;
+    let inQuotes = false;
+    let inAngleBrackets = false;
+    let escaping = false;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (escaping) {
+            escaping = false;
+            continue;
+        }
+        if (char === '\\' && inQuotes) {
+            escaping = true;
+            continue;
+        }
+        if (char === '"' && !inAngleBrackets) {
+            inQuotes = !inQuotes;
+            continue;
+        }
+        if (char === '<' && !inQuotes) {
+            inAngleBrackets = true;
+            continue;
+        }
+        if (char === '>' && !inQuotes) {
+            inAngleBrackets = false;
+            continue;
+        }
+        if (char === ',' && !inQuotes && !inAngleBrackets) {
+            values.push(value.slice(start, index).trim());
+            start = index + 1;
+        }
+    }
+    values.push(value.slice(start).trim());
+    return values.filter((value) => value.length > 0);
+}
+/** A decoded operation result with HTTP response metadata. */
+export class OperationResponse {
+    result;
+    transportResponse;
+    status;
+    headers;
+    constructor(result, transportResponse) {
+        this.result = result;
+        this.transportResponse = transportResponse;
+        this.status = transportResponse.status;
+        this.headers = ResponseHeaders.from(transportResponse.headers);
+    }
+    /** Retrieves all response header values matching `name`. */
+    getHeaders(name) {
+        return this.headers.getAll(name);
+    }
+    /** Retrieves the first response header value matching `name`. */
+    getHeader(name) {
+        return this.headers.get(name);
+    }
+    /** Parsed `Content-Type` header value. */
+    get contentType() {
+        return this.headers.contentType;
+    }
+}
+//# sourceMappingURL=operation-response.js.map

package/build/operation-response.js.map

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

package/build/operation.d.ts

@@ -0,0 +1,64 @@
+import { Transport, RequestSpec } from './transport.js';
+import { OperationResponse } from './operation-response.js';
+import { SchemaLike } from './schema-runtime.js';
+import { StreamingBody } from './streaming-body.js';
+import { type ProblemMatcher } from './util/nullify.js';
+/** Extracts the native request type from a transport. */
+export type TransportRequest<Factory> = Factory extends {
+    transportRequest(requestSpec: RequestSpec<unknown>): Promise<infer NativeRequest>;
+} ? NativeRequest : never;
+/** Options used when converting an operation into a native request. */
+export interface BuildRequestOptions {
+    readonly signal?: AbortSignal;
+}
+/** Options used when executing an operation. */
+export interface ExecuteOptions {
+    readonly signal?: AbortSignal;
+}
+/** Describes the generated HTTP request and optional response decoder for an operation. */
+export interface OperationSpec<RequestBody, ResponseBody> {
+    readonly request: RequestSpec<RequestBody>;
+    readonly responseType?: SchemaLike<ResponseBody>;
+}
+/** Describes an operation with no decoded response body. */
+export interface VoidOperationSpec<RequestBody = void> extends OperationSpec<RequestBody, void> {
+    readonly responseType?: undefined;
+}
+/** Describes an operation with a decoded response body. */
+export interface TypedOperationSpec<RequestBody, ResponseBody> extends OperationSpec<RequestBody, ResponseBody> {
+    readonly responseType: SchemaLike<ResponseBody>;
+}
+/** Describes problems that should be translated into a null response value. */
+export interface NullifySpec {
+    readonly statuses: readonly number[];
+    readonly problemTypes: readonly ProblemMatcher[];
+}
+/** A generated operation that can be executed or converted into a native transport request. */
+export interface Operation<RequestBody, ResponseBody, Factory extends Transport<unknown> = Transport> {
+    readonly spec: OperationSpec<RequestBody, ResponseBody>;
+    execute(options?: ExecuteOptions): Promise<ResponseBody>;
+    response(options?: ExecuteOptions): Promise<OperationResponse<ResponseBody>>;
+    transportRequest(options?: BuildRequestOptions): Promise<TransportRequest<Factory>>;
+    transportResponse(options?: ExecuteOptions): Promise<Response>;
+}
+/** A generated streaming upload operation. */
+export interface StreamingOperation<ResponseBody, Factory extends Transport<unknown> = Transport> extends Operation<StreamingBody, ResponseBody, Factory> {
+}
+/** A generated operation that can execute select problems as null responses. */
+export interface NullableOperation<RequestBody, ResponseBody, Factory extends Transport<unknown> = Transport> extends Operation<RequestBody, ResponseBody, Factory> {
+    readonly nullify: NullifySpec;
+    executeOrNull(options?: ExecuteOptions): Promise<ResponseBody | null>;
+    responseOrNull(options?: ExecuteOptions): Promise<OperationResponse<ResponseBody> | null>;
+}
+/** Creates an operation with a decoded response body. */
+export declare function createOperation<RequestBody = void, ResponseBody = void, Factory extends Transport<unknown> = Transport>(transport: Factory, spec: TypedOperationSpec<RequestBody, ResponseBody>): Operation<RequestBody, ResponseBody, Factory>;
+/** Creates an operation with no decoded response body. */
+export declare function createOperation<RequestBody = void, Factory extends Transport<unknown> = Transport>(transport: Factory, spec: VoidOperationSpec<RequestBody>): Operation<RequestBody, void, Factory>;
+/** Creates a streaming upload operation with a decoded response body. */
+export declare function createStreamingOperation<ResponseBody = void, Factory extends Transport<unknown> = Transport>(transport: Factory, spec: TypedOperationSpec<StreamingBody, ResponseBody>): StreamingOperation<ResponseBody, Factory>;
+/** Creates a streaming upload operation with no decoded response body. */
+export declare function createStreamingOperation<Factory extends Transport<unknown> = Transport>(transport: Factory, spec: VoidOperationSpec<StreamingBody>): StreamingOperation<void, Factory>;
+/** Creates a nullable operation with a decoded response body. */
+export declare function createNullableOperation<RequestBody = void, ResponseBody = void, Factory extends Transport<unknown> = Transport>(transport: Factory, spec: TypedOperationSpec<RequestBody, ResponseBody>, nullify: NullifySpec): NullableOperation<RequestBody, ResponseBody, Factory>;
+/** Creates a nullable operation with no decoded response body. */
+export declare function createNullableOperation<RequestBody = void, Factory extends Transport<unknown> = Transport>(transport: Factory, spec: VoidOperationSpec<RequestBody>, nullify: NullifySpec): NullableOperation<RequestBody, void, Factory>;