@temporary-name/server 1.9.3-alpha.30822ad82102dcf9276d473ba372416778807e52 → 1.9.3-alpha.3f3cdc28e4c507442c043c8988bb757a44b8785b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/adapters/aws-lambda/index.d.mts +12 -6
  2. package/dist/adapters/aws-lambda/index.d.ts +12 -6
  3. package/dist/adapters/aws-lambda/index.mjs +12 -4
  4. package/dist/adapters/fetch/index.d.mts +12 -6
  5. package/dist/adapters/fetch/index.d.ts +12 -6
  6. package/dist/adapters/fetch/index.mjs +12 -11
  7. package/dist/adapters/node/index.d.mts +12 -6
  8. package/dist/adapters/node/index.d.ts +12 -6
  9. package/dist/adapters/node/index.mjs +12 -11
  10. package/dist/adapters/standard/index.d.mts +23 -13
  11. package/dist/adapters/standard/index.d.ts +23 -13
  12. package/dist/adapters/standard/index.mjs +8 -100
  13. package/dist/index.d.mts +41 -282
  14. package/dist/index.d.ts +41 -282
  15. package/dist/index.mjs +102 -156
  16. package/dist/openapi/index.d.mts +220 -0
  17. package/dist/openapi/index.d.ts +220 -0
  18. package/dist/openapi/index.mjs +742 -0
  19. package/dist/plugins/index.d.mts +2 -2
  20. package/dist/plugins/index.d.ts +2 -2
  21. package/dist/shared/server.B93y_8tj.d.mts +23 -0
  22. package/dist/shared/{server.BEQrAa3A.mjs → server.BYYf0Wn6.mjs} +35 -40
  23. package/dist/shared/{server.C1YnHvvf.d.ts → server.C3RuMHWl.d.mts} +31 -31
  24. package/dist/shared/{server.C1YnHvvf.d.mts → server.C3RuMHWl.d.ts} +31 -31
  25. package/dist/shared/{server.Btxrgkj5.d.ts → server.CT1xhSmE.d.mts} +7 -24
  26. package/dist/shared/server.DIOj33oh.mjs +262 -0
  27. package/dist/shared/server.D_fags8X.d.ts +23 -0
  28. package/dist/shared/server.Kxw442A9.mjs +247 -0
  29. package/dist/shared/{server.Bo94xDTv.d.mts → server.cjcgLdr1.d.ts} +7 -24
  30. package/package.json +17 -10
  31. package/dist/shared/server.D6K9uoPI.mjs +0 -35
  32. package/dist/shared/server.DZ5BIITo.mjs +0 -9
  33. package/dist/shared/server.X0YaZxSJ.mjs +0 -13
package/dist/index.mjs CHANGED
@@ -1,50 +1,11 @@
1
- import { isContractProcedure, mergeErrorMap, mergeMeta, mergeRoute, mergePrefix, enhanceRoute, mergeTags, getContractRouter } from '@temporary-name/contract';
2
- export { ValidationError, eventIterator, type, validateORPCError } from '@temporary-name/contract';
3
1
  import { onError, resolveMaybeOptionalOptions } from '@temporary-name/shared';
4
2
  export { AsyncIteratorClass, EventPublisher, ORPCError, asyncIteratorToStream as eventIteratorToStream, isDefinedError, onError, onFinish, onStart, onSuccess, safe, streamToAsyncIteratorClass as streamToEventIterator } from '@temporary-name/shared';
5
- import { g as gatingContext } from './shared/server.D6K9uoPI.mjs';
6
- import { c as createProcedureClient, i as isLazy, g as getLazyMeta, l as lazy, u as unlazy } from './shared/server.BEQrAa3A.mjs';
7
- export { L as LAZY_SYMBOL, a as createORPCErrorConstructorMap, m as mergeCurrentContext, b as middlewareOutputFn } from './shared/server.BEQrAa3A.mjs';
3
+ import { isContractProcedure, mergePrefix, mergeErrorMap, enhanceRoute, mergeTags, ContractProcedure, mergeMeta, mergeRoute, prefixRoute, getContractRouter } from '@temporary-name/contract';
4
+ export { ValidationError, eventIterator, validateORPCError } from '@temporary-name/contract';
5
+ import { SchemaClass, gatingContext } from '@temporary-name/zod';
6
+ import { c as createProcedureClient, i as isLazy, g as getLazyMeta, l as lazy, u as unlazy } from './shared/server.BYYf0Wn6.mjs';
7
+ export { L as LAZY_SYMBOL, a as createORPCErrorConstructorMap, m as mergeCurrentContext, b as middlewareOutputFn } from './shared/server.BYYf0Wn6.mjs';
8
8
  export { getEventMeta, withEventMeta } from '@temporary-name/standard-server';
9
- import 'node:async_hooks';
10
- import 'zod';
11
- import 'zod/v4/core';
12
-
13
- function decorateMiddleware(middleware) {
14
- const decorated = ((...args) => middleware(...args));
15
- decorated.mapInput = (mapInput) => {
16
- const mapped = decorateMiddleware(
17
- (options, input, ...rest) => middleware(options, mapInput(input), ...rest)
18
- );
19
- return mapped;
20
- };
21
- decorated.concat = (concatMiddleware, mapInput) => {
22
- const mapped = mapInput ? decorateMiddleware(concatMiddleware).mapInput(mapInput) : concatMiddleware;
23
- const concatted = decorateMiddleware((options, input, output, ...rest) => {
24
- const merged = middleware(
25
- {
26
- ...options,
27
- next: (...[nextOptions1]) => mapped(
28
- {
29
- ...options,
30
- context: { ...options.context, ...nextOptions1?.context },
31
- next: (...[nextOptions2]) => options.next({ context: { ...nextOptions1?.context, ...nextOptions2?.context } })
32
- },
33
- input,
34
- output,
35
- ...rest
36
- )
37
- },
38
- input,
39
- output,
40
- ...rest
41
- );
42
- return merged;
43
- });
44
- return concatted;
45
- };
46
- return decorated;
47
- }
48
9
 
49
10
  function isStartWithMiddlewares(middlewares, compare) {
50
11
  if (compare.length > middlewares.length) {
@@ -83,55 +44,10 @@ function isProcedure(item) {
83
44
  if (item instanceof Procedure) {
84
45
  return true;
85
46
  }
86
- return isContractProcedure(item) && "middlewares" in item["~orpc"] && "inputValidationIndex" in item["~orpc"] && "outputValidationIndex" in item["~orpc"] && "handler" in item["~orpc"];
47
+ return isContractProcedure(item) && "middlewares" in item["~orpc"] && "handler" in item["~orpc"];
87
48
  }
88
49
 
89
50
  class DecoratedProcedure extends Procedure {
90
- /**
91
- * Adds type-safe custom errors.
92
- * The provided errors are spared-merged with any existing errors.
93
- *
94
- * @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
95
- */
96
- errors(errors) {
97
- return new DecoratedProcedure({
98
- ...this["~orpc"],
99
- errorMap: mergeErrorMap(this["~orpc"].errorMap, errors)
100
- });
101
- }
102
- /**
103
- * Sets or updates the metadata.
104
- * The provided metadata is spared-merged with any existing metadata.
105
- *
106
- * @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
107
- */
108
- meta(meta) {
109
- return new DecoratedProcedure({
110
- ...this["~orpc"],
111
- meta: mergeMeta(this["~orpc"].meta, meta)
112
- });
113
- }
114
- /**
115
- * Sets or updates the route definition.
116
- * The provided route is spared-merged with any existing route.
117
- * This option is typically relevant when integrating with OpenAPI.
118
- *
119
- * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
120
- * @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
121
- */
122
- route(route) {
123
- return new DecoratedProcedure({
124
- ...this["~orpc"],
125
- route: mergeRoute(this["~orpc"].route, route)
126
- });
127
- }
128
- use(middleware, mapInput) {
129
- const mapped = mapInput ? decorateMiddleware(middleware).mapInput(mapInput) : middleware;
130
- return new DecoratedProcedure({
131
- ...this["~orpc"],
132
- middlewares: addMiddleware(this["~orpc"].middlewares, mapped)
133
- });
134
- }
135
51
  /**
136
52
  * Make this procedure callable (works like a function while still being a procedure).
137
53
  *
@@ -296,87 +212,49 @@ async function unlazyRouter(router) {
296
212
  return unlazied;
297
213
  }
298
214
 
299
- class Builder {
300
- /**
301
- * This property holds the defined options.
302
- */
303
- "~orpc";
215
+ class ProcedureBuilder extends ContractProcedure {
216
+ z;
304
217
  constructor(def) {
305
- this["~orpc"] = def;
306
- }
307
- /**
308
- * Set or override the initial context.
309
- *
310
- * @see {@link https://orpc.unnoq.com/docs/context Context Docs}
311
- */
312
- $context() {
313
- return this;
314
- }
315
- /**
316
- * Creates a middleware.
317
- *
318
- * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
319
- */
320
- middleware(middleware) {
321
- return decorateMiddleware(middleware);
218
+ super(def);
219
+ this.z = new SchemaClass();
322
220
  }
323
221
  /**
324
- * Adds type-safe custom errors.
325
- * The provided errors are spared-merged with any existing errors.
222
+ * Adds type-safe custom errors to the contract.
223
+ * The provided errors are spared-merged with any existing errors in the contract.
326
224
  *
327
225
  * @see {@link https://orpc.unnoq.com/docs/error-handling#type%E2%80%90safe-error-handling Type-Safe Error Handling Docs}
328
226
  */
329
227
  errors(errors) {
330
- return new Builder({
228
+ return new ProcedureBuilder({
331
229
  ...this["~orpc"],
332
230
  errorMap: mergeErrorMap(this["~orpc"].errorMap, errors)
333
231
  });
334
232
  }
335
233
  /**
336
- * Uses a middleware to modify the context or improve the pipeline.
337
- *
338
- * @info Supports both normal middleware and inline middleware implementations.
339
- * @note The current context must be satisfy middleware dependent-context
340
- * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
341
- */
342
- use(middleware) {
343
- return new Builder({
344
- ...this["~orpc"],
345
- middlewares: addMiddleware(this["~orpc"].middlewares, middleware)
346
- });
347
- }
348
- useGating(gates, isGateEnabled) {
349
- return this.use(({ next, context }) => {
350
- return gatingContext.run(
351
- (gate) => isGateEnabled(gate, context),
352
- () => next({ context: { isGateEnabled } })
353
- );
354
- });
355
- }
356
- /**
357
- * Sets or updates the metadata.
358
- * The provided metadata is spared-merged with any existing metadata.
234
+ * Sets or updates the metadata for the contract.
235
+ * The provided metadata is spared-merged with any existing metadata in the contract.
359
236
  *
360
237
  * @see {@link https://orpc.unnoq.com/docs/metadata Metadata Docs}
361
238
  */
362
239
  meta(meta) {
363
- return new Builder({
240
+ return new ProcedureBuilder({
364
241
  ...this["~orpc"],
365
242
  meta: mergeMeta(this["~orpc"].meta, meta)
366
243
  });
367
244
  }
368
245
  /**
369
- * Sets or updates the route definition.
370
- * The provided route is spared-merged with any existing route.
246
+ * Sets or updates the route definition for the contract.
247
+ * The provided route is spared-merged with any existing route in the contract.
371
248
  * This option is typically relevant when integrating with OpenAPI.
372
249
  *
373
250
  * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
374
251
  * @see {@link https://orpc.unnoq.com/docs/openapi/input-output-structure OpenAPI Input/Output Structure Docs}
375
252
  */
376
253
  route(route) {
377
- return new Builder({
254
+ const { prefix } = this["~orpc"];
255
+ return new ProcedureBuilder({
378
256
  ...this["~orpc"],
379
- route: mergeRoute(this["~orpc"].route, route)
257
+ route: mergeRoute(this["~orpc"].route, prefix ? prefixRoute(route, prefix) : route)
380
258
  });
381
259
  }
382
260
  /**
@@ -385,7 +263,7 @@ class Builder {
385
263
  * @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Input Validation Docs}
386
264
  */
387
265
  input(schema) {
388
- return new Builder({
266
+ return new ProcedureBuilder({
389
267
  ...this["~orpc"],
390
268
  inputSchema: schema,
391
269
  inputValidationIndex: this["~orpc"].middlewares.length
@@ -397,12 +275,33 @@ class Builder {
397
275
  * @see {@link https://orpc.unnoq.com/docs/procedure#input-output-validation Output Validation Docs}
398
276
  */
399
277
  output(schema) {
400
- return new Builder({
278
+ return new ProcedureBuilder({
401
279
  ...this["~orpc"],
402
280
  outputSchema: schema,
403
281
  outputValidationIndex: this["~orpc"].middlewares.length
404
282
  });
405
283
  }
284
+ /**
285
+ * Uses a middleware to modify the context or improve the pipeline.
286
+ *
287
+ * @info Supports both normal middleware and inline middleware implementations.
288
+ * @note The current context must be satisfy middleware dependent-context
289
+ * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
290
+ */
291
+ use(middleware) {
292
+ return new this.constructor({
293
+ ...this["~orpc"],
294
+ middlewares: addMiddleware(this["~orpc"].middlewares, middleware)
295
+ });
296
+ }
297
+ useGating(gates, isGateEnabled) {
298
+ return this.use(({ next, context }) => {
299
+ return gatingContext.run(
300
+ (gate) => isGateEnabled(gate, context),
301
+ () => next({ context: { isGateEnabled } })
302
+ );
303
+ });
304
+ }
406
305
  /**
407
306
  * Defines the handler of the procedure.
408
307
  *
@@ -414,6 +313,8 @@ class Builder {
414
313
  handler
415
314
  });
416
315
  }
316
+ }
317
+ class BuilderWithMiddlewares extends ProcedureBuilder {
417
318
  /**
418
319
  * Prefixes all procedures in the router.
419
320
  * The provided prefix is post-appended to any existing router prefix.
@@ -423,7 +324,7 @@ class Builder {
423
324
  * @see {@link https://orpc.unnoq.com/docs/openapi/routing#route-prefixes OpenAPI Route Prefixes Docs}
424
325
  */
425
326
  prefix(prefix) {
426
- return new Builder({
327
+ return new this.constructor({
427
328
  ...this["~orpc"],
428
329
  prefix: mergePrefix(this["~orpc"].prefix, prefix)
429
330
  });
@@ -435,7 +336,7 @@ class Builder {
435
336
  * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata OpenAPI Operation Metadata Docs}
436
337
  */
437
338
  tag(...tags) {
438
- return new Builder({
339
+ return new this.constructor({
439
340
  ...this["~orpc"],
440
341
  tags: mergeTags(this["~orpc"].tags, tags)
441
342
  });
@@ -448,25 +349,71 @@ class Builder {
448
349
  router(router) {
449
350
  return enhanceRouter(router, this["~orpc"]);
450
351
  }
352
+ }
353
+
354
+ function decorateMiddleware(middleware) {
355
+ const decorated = ((...args) => middleware(...args));
356
+ decorated.mapInput = (mapInput) => {
357
+ const mapped = decorateMiddleware(
358
+ (options, input, ...rest) => middleware(options, mapInput(input), ...rest)
359
+ );
360
+ return mapped;
361
+ };
362
+ decorated.concat = (concatMiddleware, mapInput) => {
363
+ const mapped = mapInput ? decorateMiddleware(concatMiddleware).mapInput(mapInput) : concatMiddleware;
364
+ const concatted = decorateMiddleware((options, input, output, ...rest) => {
365
+ const merged = middleware(
366
+ {
367
+ ...options,
368
+ next: (...[nextOptions1]) => mapped(
369
+ {
370
+ ...options,
371
+ context: { ...options.context, ...nextOptions1?.context },
372
+ next: (...[nextOptions2]) => options.next({ context: { ...nextOptions1?.context, ...nextOptions2?.context } })
373
+ },
374
+ input,
375
+ output,
376
+ ...rest
377
+ )
378
+ },
379
+ input,
380
+ output,
381
+ ...rest
382
+ );
383
+ return merged;
384
+ });
385
+ return concatted;
386
+ };
387
+ return decorated;
388
+ }
389
+
390
+ class Builder extends BuilderWithMiddlewares {
391
+ /**
392
+ * Set or override the initial context.
393
+ *
394
+ * @see {@link https://orpc.unnoq.com/docs/context Context Docs}
395
+ */
396
+ $context() {
397
+ return this;
398
+ }
451
399
  /**
452
- * Create a lazy router
453
- * And applies all of the previously defined options to the specified router.
400
+ * Creates a middleware.
454
401
  *
455
- * @see {@link https://orpc.unnoq.com/docs/router#extending-router Extending Router Docs}
402
+ * @see {@link https://orpc.unnoq.com/docs/middleware Middleware Docs}
456
403
  */
457
- lazyRoute(loader) {
458
- return enhanceRouter(lazy(loader), this["~orpc"]);
404
+ middleware(middleware) {
405
+ return decorateMiddleware(middleware);
459
406
  }
460
407
  }
461
408
  function createApiBuilder(opts = {}) {
462
- const base = new Builder({
409
+ return new Builder({
463
410
  route: {},
464
411
  meta: opts.meta ?? {},
465
412
  errorMap: {},
466
413
  inputValidationIndex: 0,
467
414
  outputValidationIndex: 0,
468
415
  middlewares: [
469
- onError((error, options) => {
416
+ onError((error, _options) => {
470
417
  console.dir(error, { depth: null });
471
418
  })
472
419
  ],
@@ -474,7 +421,6 @@ function createApiBuilder(opts = {}) {
474
421
  // the best solution). For now I've removed the interface to configure it externally.
475
422
  dedupeLeadingMiddlewares: true
476
423
  });
477
- return base;
478
424
  }
479
425
  const os = createApiBuilder();
480
426
 
@@ -615,4 +561,4 @@ function createRouterClient(router, ...rest) {
615
561
  return recursive;
616
562
  }
617
563
 
618
- export { Builder, DecoratedProcedure, Procedure, addMiddleware, call, createAccessibleLazyRouter, createApiBuilder, createAssertedLazyProcedure, createContractedProcedure, createProcedureClient, createRouterClient, decorateMiddleware, enhanceRouter, getHiddenRouterContract, getLazyMeta, getRouter, implement, implementerInternal, isLazy, isProcedure, isStartWithMiddlewares, lazy, mergeMiddlewares, os, resolveContractProcedures, setHiddenRouterContract, traverseContractProcedures, unlazy, unlazyRouter };
564
+ export { Builder, BuilderWithMiddlewares, DecoratedProcedure, Procedure, ProcedureBuilder, addMiddleware, call, createAccessibleLazyRouter, createApiBuilder, createAssertedLazyProcedure, createContractedProcedure, createProcedureClient, createRouterClient, decorateMiddleware, enhanceRouter, getHiddenRouterContract, getLazyMeta, getRouter, implement, implementerInternal, isLazy, isProcedure, isStartWithMiddlewares, lazy, mergeMiddlewares, os, resolveContractProcedures, setHiddenRouterContract, traverseContractProcedures, unlazy, unlazyRouter };
@@ -0,0 +1,220 @@
1
+ import { OpenAPI, AnyContractProcedure, AnySchema, AnyContractRouter } from '@temporary-name/contract';
2
+ export { OpenAPI } from '@temporary-name/contract';
3
+ import { AnyProcedure, TraverseContractProcedureCallbackOptions, AnyRouter, ORPCError, ClientContext, Lazyable, CreateProcedureClientOptions, InferRouterInitialContext, Schema, ErrorMap, Meta, RouterClient } from '@temporary-name/server';
4
+ import { Promisable, Value, HTTPPath, HTTPMethod, NestedClient, Client, MaybeOptionalOptions } from '@temporary-name/shared';
5
+ import { JSONSchema } from '@temporary-name/interop/json-schema-typed/draft-2020-12';
6
+ export { JSONSchema, ContentEncoding as JSONSchemaContentEncoding, Format as JSONSchemaFormat, TypeName as JSONSchemaTypeName } from '@temporary-name/interop/json-schema-typed/draft-2020-12';
7
+
8
+ type OverrideOperationValue = Partial<OpenAPI.OperationObject> | ((current: OpenAPI.OperationObject, procedure: AnyContractProcedure) => OpenAPI.OperationObject);
9
+ /**
10
+ * Customize The Operation Object by proxy an error map item or a middleware.
11
+ *
12
+ * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#customizing-operation-objects Customizing Operation Objects Docs}
13
+ */
14
+ declare function customOpenAPIOperation<T extends object>(o: T, extend: OverrideOperationValue): T;
15
+ declare function getCustomOpenAPIOperation(o: object): OverrideOperationValue | undefined;
16
+ declare function applyCustomOpenAPIOperation(operation: OpenAPI.OperationObject, contract: AnyContractProcedure): OpenAPI.OperationObject;
17
+
18
+ /**
19
+ * @internal
20
+ */
21
+ type ObjectSchema = JSONSchema & {
22
+ type: 'object';
23
+ } & object;
24
+ /**
25
+ * @internal
26
+ */
27
+ type FileSchema = JSONSchema & {
28
+ type: 'string';
29
+ contentMediaType: string;
30
+ } & object;
31
+ /**
32
+ * @internal
33
+ */
34
+ declare const LOGIC_KEYWORDS: string[];
35
+
36
+ interface SchemaConverterComponent {
37
+ allowedStrategies: readonly SchemaConvertOptions['strategy'][];
38
+ schema: AnySchema;
39
+ required: boolean;
40
+ ref: string;
41
+ }
42
+ interface SchemaConvertOptions {
43
+ strategy: 'input' | 'output';
44
+ /**
45
+ * Common components should use `$ref` to represent themselves if matched.
46
+ */
47
+ components?: readonly SchemaConverterComponent[];
48
+ /**
49
+ * Minimum schema structure depth required before using `$ref` for components.
50
+ *
51
+ * For example, if set to 2, `$ref` will only be used for schemas nested at depth 2 or greater.
52
+ *
53
+ * @default 0 - No depth limit;
54
+ */
55
+ minStructureDepthForRef?: number;
56
+ }
57
+ interface SchemaConverter {
58
+ convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<[required: boolean, jsonSchema: JSONSchema]>;
59
+ }
60
+ interface ConditionalSchemaConverter extends SchemaConverter {
61
+ condition(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<boolean>;
62
+ }
63
+ declare class CompositeSchemaConverter implements SchemaConverter {
64
+ private readonly converters;
65
+ constructor(converters: readonly ConditionalSchemaConverter[]);
66
+ convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promise<[required: boolean, jsonSchema: JSONSchema]>;
67
+ }
68
+
69
+ interface OpenAPIGeneratorOptions {
70
+ schemaConverters?: ConditionalSchemaConverter[];
71
+ }
72
+ interface OpenAPIGeneratorGenerateOptions extends Partial<Omit<OpenAPI.Document, 'openapi'>> {
73
+ /**
74
+ * Exclude procedures from the OpenAPI specification.
75
+ *
76
+ * @deprecated Use `filter` option instead.
77
+ * @default () => false
78
+ */
79
+ exclude?: (procedure: AnyProcedure | AnyContractProcedure, path: readonly string[]) => boolean;
80
+ /**
81
+ * Filter procedures. Return `false` to exclude a procedure from the OpenAPI specification.
82
+ *
83
+ * @default true
84
+ */
85
+ filter?: Value<boolean, [options: TraverseContractProcedureCallbackOptions]>;
86
+ /**
87
+ * Common schemas to be used for $ref resolution.
88
+ */
89
+ commonSchemas?: Record<string, {
90
+ /**
91
+ * Determines which schema definition to use when input and output schemas differ.
92
+ * This is needed because some schemas transform data differently between input and output,
93
+ * making it impossible to use a single $ref for both cases.
94
+ *
95
+ * @example
96
+ * ```ts
97
+ * // This schema transforms a string input into a number output
98
+ * const Schema = z.string()
99
+ * .transform(v => Number(v))
100
+ * .pipe(z.number())
101
+ *
102
+ * // Input schema: { type: 'string' }
103
+ * // Output schema: { type: 'number' }
104
+ * ```
105
+ *
106
+ * When schemas differ between input and output, you must explicitly choose
107
+ * which version to use for the OpenAPI specification.
108
+ *
109
+ * @default 'input' - Uses the input schema definition by default
110
+ */
111
+ strategy?: SchemaConvertOptions['strategy'];
112
+ schema: AnySchema;
113
+ } | {
114
+ error: 'UndefinedError';
115
+ schema?: never;
116
+ }>;
117
+ }
118
+ /**
119
+ * The generator that converts oRPC routers/contracts to OpenAPI specifications.
120
+ *
121
+ * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
122
+ */
123
+ declare class OpenAPIGenerator {
124
+ #private;
125
+ private readonly converter;
126
+ constructor(options?: OpenAPIGeneratorOptions);
127
+ /**
128
+ * Generates OpenAPI specifications from oRPC routers/contracts.
129
+ *
130
+ * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification OpenAPI Specification Docs}
131
+ */
132
+ generate(router: AnyContractRouter | AnyRouter, options?: OpenAPIGeneratorGenerateOptions): Promise<OpenAPI.Document>;
133
+ }
134
+
135
+ /**
136
+ * @internal
137
+ */
138
+ declare function toOpenAPIPath(path: HTTPPath): string;
139
+ /**
140
+ * @internal
141
+ */
142
+ declare function toOpenAPIMethod(method: HTTPMethod): Lowercase<HTTPMethod>;
143
+ /**
144
+ * @internal
145
+ */
146
+ declare function toOpenAPIContent(schema: JSONSchema): Record<string, OpenAPI.MediaTypeObject>;
147
+ /**
148
+ * @internal
149
+ */
150
+ declare function toOpenAPIEventIteratorContent([yieldsRequired, yieldsSchema]: [boolean, JSONSchema], [returnsRequired, returnsSchema]: [boolean, JSONSchema]): Record<string, OpenAPI.MediaTypeObject>;
151
+ /**
152
+ * @internal
153
+ */
154
+ declare function toOpenAPIParameters(schema: ObjectSchema, parameterIn: 'path' | 'query' | 'header' | 'cookie'): OpenAPI.ParameterObject[];
155
+ /**
156
+ * @internal
157
+ */
158
+ declare function checkParamsSchema(schema: ObjectSchema, params: string[]): boolean;
159
+ /**
160
+ * @internal
161
+ */
162
+ declare function toOpenAPISchema(schema: JSONSchema): OpenAPI.SchemaObject & object;
163
+ declare function resolveOpenAPIJsonSchemaRef(doc: OpenAPI.Document, schema: JSONSchema): JSONSchema;
164
+
165
+ type JsonifiedValue<T> = T extends string ? T : T extends number ? T : T extends boolean ? T : T extends null ? T : T extends undefined ? T : T extends Array<unknown> ? JsonifiedArray<T> : T extends Record<string, unknown> ? {
166
+ [K in keyof T]: JsonifiedValue<T[K]>;
167
+ } : T extends Date ? string : T extends bigint ? string : T extends File ? File : T extends Blob ? Blob : T extends RegExp ? string : T extends URL ? string : T extends Map<infer K, infer V> ? JsonifiedArray<[K, V][]> : T extends Set<infer U> ? JsonifiedArray<U[]> : T extends AsyncIteratorObject<infer U, infer V> ? AsyncIteratorObject<JsonifiedValue<U>, JsonifiedValue<V>> : unknown;
168
+ type JsonifiedArray<T extends Array<unknown>> = T extends readonly [] ? [] : T extends readonly [infer U, ...infer V] ? [
169
+ U extends undefined ? null : JsonifiedValue<U>,
170
+ ...JsonifiedArray<V>
171
+ ] : T extends Array<infer U> ? Array<JsonifiedValue<U>> : unknown;
172
+ /**
173
+ * Convert types that JSON not support to corresponding json types
174
+ *
175
+ * @see {@link https://orpc.unnoq.com/docs/openapi/client/openapi-link OpenAPI Link Docs}
176
+ */
177
+ type JsonifiedClient<T extends NestedClient<any>> = T extends Client<infer UClientContext, infer UInput, infer UOutput, infer UError> ? Client<UClientContext, UInput, JsonifiedValue<UOutput>, UError extends ORPCError<infer UCode, infer UData> ? ORPCError<UCode, JsonifiedValue<UData>> : UError> : {
178
+ [K in keyof T]: T[K] extends NestedClient<any> ? JsonifiedClient<T[K]> : T[K];
179
+ };
180
+ declare function createJsonifiedRouterClient<T extends AnyRouter, TClientContext extends ClientContext>(router: Lazyable<T | undefined>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<InferRouterInitialContext<T>, Schema<unknown, unknown>, ErrorMap, Meta, TClientContext>>): JsonifiedClient<RouterClient<T, TClientContext>>;
181
+
182
+ /**
183
+ *@internal
184
+ */
185
+ declare function isFileSchema(schema: JSONSchema): schema is FileSchema;
186
+ /**
187
+ * @internal
188
+ */
189
+ declare function isObjectSchema(schema: JSONSchema): schema is ObjectSchema;
190
+ /**
191
+ * @internal
192
+ */
193
+ declare function isAnySchema(schema: JSONSchema): boolean;
194
+ /**
195
+ * @internal
196
+ */
197
+ declare function separateObjectSchema(schema: ObjectSchema, separatedProperties: string[]): [matched: ObjectSchema, rest: ObjectSchema];
198
+ /**
199
+ * @internal
200
+ */
201
+ declare function filterSchemaBranches(schema: JSONSchema, check: (schema: JSONSchema) => boolean, matches?: JSONSchema[]): [matches: JSONSchema[], rest: JSONSchema | undefined];
202
+ declare function applySchemaOptionality(required: boolean, schema: JSONSchema): JSONSchema;
203
+ /**
204
+ * Takes a JSON schema and, if it's primarily a union type (anyOf, oneOf),
205
+ * recursively expands it into an array of its constituent, non-union base schemas.
206
+ * If the schema is not a simple union or is a base type, it's returned as a single-element array.
207
+ */
208
+ declare function expandUnionSchema(schema: JSONSchema): JSONSchema[];
209
+ declare function expandArrayableSchema(schema: JSONSchema): undefined | [items: JSONSchema, array: JSONSchema & {
210
+ type: 'array';
211
+ items?: JSONSchema;
212
+ }];
213
+ declare function isPrimitiveSchema(schema: JSONSchema): boolean;
214
+
215
+ declare const oo: {
216
+ spec: typeof customOpenAPIOperation;
217
+ };
218
+
219
+ export { CompositeSchemaConverter, LOGIC_KEYWORDS, OpenAPIGenerator, applyCustomOpenAPIOperation, applySchemaOptionality, checkParamsSchema, createJsonifiedRouterClient, customOpenAPIOperation, expandArrayableSchema, expandUnionSchema, filterSchemaBranches, getCustomOpenAPIOperation, isAnySchema, isFileSchema, isObjectSchema, isPrimitiveSchema, oo, resolveOpenAPIJsonSchemaRef, separateObjectSchema, toOpenAPIContent, toOpenAPIEventIteratorContent, toOpenAPIMethod, toOpenAPIParameters, toOpenAPIPath, toOpenAPISchema };
220
+ export type { ConditionalSchemaConverter, FileSchema, JsonifiedArray, JsonifiedClient, JsonifiedValue, ObjectSchema, OpenAPIGeneratorGenerateOptions, OpenAPIGeneratorOptions, OverrideOperationValue, SchemaConvertOptions, SchemaConverter, SchemaConverterComponent };