@orpc/contract 0.24.0 → 0.25.0

package/dist/index.js

@@ -27,7 +27,10 @@ var DecoratedContractProcedure = class _DecoratedContractProcedure extends Contr
   route(route) {
     return new _DecoratedContractProcedure({
       ...this["~orpc"],
-      route
+      route: {
+        ...this["~orpc"].route,
+        ...route
+      }
     });
   }
   prefix(prefix) {
@@ -145,6 +148,32 @@ var ContractBuilder = class {
   }
 };
 
+// src/config.ts
+var DEFAULT_CONFIG = {
+  defaultMethod: "POST",
+  defaultSuccessStatus: 200,
+  defaultSuccessDescription: "OK",
+  defaultInputStructure: "compact",
+  defaultOutputStructure: "compact"
+};
+var GLOBAL_CONFIG_REF = { value: DEFAULT_CONFIG };
+function configGlobal(config) {
+  if (config.defaultSuccessStatus !== void 0 && (config.defaultSuccessStatus < 200 || config.defaultSuccessStatus > 299)) {
+    throw new Error("[configGlobal] The defaultSuccessStatus must be between 200 and 299");
+  }
+  GLOBAL_CONFIG_REF.value = config;
+}
+function fallbackToGlobalConfig(key, value) {
+  if (value === void 0) {
+    const fallback = GLOBAL_CONFIG_REF.value[key];
+    if (fallback === void 0) {
+      return DEFAULT_CONFIG[key];
+    }
+    return fallback;
+  }
+  return value;
+}
+
 // src/index.ts
 var oc = new ContractBuilder();
 export {
@@ -152,6 +181,8 @@ export {
   ContractProcedure,
   ContractRouterBuilder,
   DecoratedContractProcedure,
+  configGlobal,
+  fallbackToGlobalConfig,
   isContractProcedure,
   oc
 };

package/dist/src/config.d.ts

@@ -0,0 +1,36 @@
+import type { HTTPMethod, InputStructure } from './types';
+export interface ORPCConfig {
+    /**
+     * @default 'POST'
+     */
+    defaultMethod?: HTTPMethod;
+    /**
+     *
+     * @default 200
+     */
+    defaultSuccessStatus?: number;
+    /**
+     *
+     * @default 'OK'
+     */
+    defaultSuccessDescription?: string;
+    /**
+     *
+     * @default 'compact'
+     */
+    defaultInputStructure?: InputStructure;
+    /**
+     *
+     * @default 'compact'
+     */
+    defaultOutputStructure?: InputStructure;
+}
+/**
+ * Set the global configuration, this configuration can effect entire project
+ */
+export declare function configGlobal(config: ORPCConfig): void;
+/**
+ * Fallback the value to the global config if it is undefined
+ */
+export declare function fallbackToGlobalConfig<T extends keyof ORPCConfig>(key: T, value: ORPCConfig[T]): Exclude<ORPCConfig[T], undefined>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 /** unnoq */
 import { ContractBuilder } from './builder';
 export * from './builder';
+export * from './config';
 export * from './procedure';
 export * from './procedure-decorated';
 export * from './router';

package/dist/src/procedure.d.ts

@@ -1,4 +1,4 @@
-import type { HTTPMethod, HTTPPath, Schema, SchemaOutput } from './types';
+import type { HTTPMethod, HTTPPath, InputStructure, OutputStructure, Schema, SchemaOutput } from './types';
 export interface RouteOptions {
     method?: HTTPMethod;
     path?: HTTPPath;
@@ -12,6 +12,12 @@ export interface RouteOptions {
      * @default 200
      */
     successStatus?: number;
+    /**
+     * The description of the response when the procedure is successful.
+     *
+     * @default 'OK'
+     */
+    successDescription?: string;
     /**
      * Determines how the input should be structured based on `params`, `query`, `headers`, and `body`.
      *
@@ -33,7 +39,7 @@ export interface RouteOptions {
      *
      * @default 'compact'
      */
-    inputStructure?: 'compact' | 'detailed';
+    inputStructure?: InputStructure;
     /**
      * Determines how the response should be structured based on the output.
      *
@@ -55,7 +61,7 @@ export interface RouteOptions {
      *
      * @default 'compact'
      */
-    outputStructure?: 'compact' | 'detailed';
+    outputStructure?: OutputStructure;
 }
 export interface ContractProcedureDef<TInputSchema extends Schema, TOutputSchema extends Schema> {
     route?: RouteOptions;

package/dist/src/types.d.ts

@@ -1,6 +1,8 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 export type HTTPPath = `/${string}`;
 export type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export type InputStructure = 'compact' | 'detailed';
+export type OutputStructure = 'compact' | 'detailed';
 export type Schema = StandardSchemaV1 | undefined;
 export type SchemaInput<TSchema extends Schema, TFallback = unknown> = TSchema extends undefined ? TFallback : TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TSchema> : TFallback;
 export type SchemaOutput<TSchema extends Schema, TFallback = unknown> = TSchema extends undefined ? TFallback : TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/contract",
   "type": "module",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -30,7 +30,7 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "1.0.0-beta.4",
-    "@orpc/shared": "0.24.0"
+    "@orpc/shared": "0.25.0"
   },
   "devDependencies": {
     "arktype": "2.0.0-rc.26",