@orpc/shared 0.0.0-next.ef3ba82 → 0.0.0-next.f17a1a0

package/README.md

@@ -0,0 +1,68 @@
+<div align="center">
+  <image align="center" src="https://orpc.unnoq.com/logo.webp" width=280 />
+</div>
+
+<h1></h1>
+
+<div align="center">
+  <a href="https://codecov.io/gh/unnoq/orpc">
+    <img alt="codecov" src="https://codecov.io/gh/unnoq/orpc/branch/main/graph/badge.svg">
+  </a>
+  <a href="https://www.npmjs.com/package/@orpc/shared">
+    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fshared?logo=npm" />
+  </a>
+  <a href="https://github.com/unnoq/orpc/blob/main/LICENSE">
+    <img alt="MIT License" src="https://img.shields.io/github/license/unnoq/orpc?logo=open-source-initiative" />
+  </a>
+  <a href="https://discord.gg/TXEbwRBvQn">
+    <img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
+  </a>
+</div>
+
+<h3 align="center">Typesafe APIs Made Simple 🪄</h3>
+
+**oRPC is a powerful combination of RPC and OpenAPI**, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards, ensuring a smooth and enjoyable developer experience.
+
+---
+
+## Highlights
+
+- **End-to-End Type Safety 🔒**: Ensure complete type safety from inputs to outputs and errors, bridging server and client seamlessly.
+- **First-Class OpenAPI 📄**: Adheres to the OpenAPI standard out of the box, ensuring seamless integration and comprehensive API documentation.
+- **Contract-First Development 📜**: (Optional) Define your API contract upfront and implement it with confidence.
+- **Exceptional Developer Experience ✨**: Enjoy a streamlined workflow with robust typing and clear, in-code documentation.
+- **Multi-Runtime Support 🌍**: Run your code seamlessly on Cloudflare, Deno, Bun, Node.js, and more.
+- **Framework Integrations 🧩**: Supports Tanstack Query (React, Vue), Pinia Colada, and more.
+- **Server Actions ⚡️**: Fully compatible with React Server Actions on Next.js, TanStack Start, and more.
+- **Standard Schema Support 🗂️**: Effortlessly work with Zod, Valibot, ArkType, and others right out of the box.
+- **Fast & Lightweight 💨**: Built on native APIs across all runtimes – optimized for speed and efficiency.
+- **Native Types 📦**: Enjoy built-in support for Date, File, Blob, BigInt, URL and more with no extra setup.
+- **Lazy Router ⏱️**: Improve cold start times with our lazy routing feature.
+- **SSE & Streaming 📡**: Provides SSE and streaming features – perfect for real-time notifications and AI-powered streaming responses.
+- **Reusability 🔄**: Write once and reuse your code across multiple purposes effortlessly.
+- **Extendability 🔌**: Easily enhance oRPC with plugins, middleware, and interceptors.
+- **Reliability 🛡️**: Well-tested, fully TypeScript, production-ready, and MIT licensed for peace of mind.
+- **Simplicity 💡**: Enjoy straightforward, clean code with no hidden magic.
+
+## Documentation
+
+You can find the full documentation [here](https://orpc.unnoq.com).
+
+## Packages
+
+- [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
+- [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
+- [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
+- [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
+- [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
+- [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
+- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
+
+## `@orpc/shared`
+
+Provides shared utilities for oRPC packages.
+
+## License
+
+Distributed under the MIT License. See [LICENSE](https://github.com/unnoq/orpc/blob/main/LICENSE) for more information.

package/dist/index.js

@@ -1,16 +1,4 @@
-// src/json.ts
-function parseJSONSafely(text) {
-  if (text === "")
-    return void 0;
-  try {
-    return JSON.parse(text);
-  } catch {
-    return text;
-  }
-}
-
 // src/object.ts
-import { isPlainObject } from "is-what";
 function set(root, segments, value2) {
   const ref = { root };
   let currentRef = ref;
@@ -46,35 +34,122 @@ function findDeepMatches(check, payload, segments = [], maps = [], values = [])
     payload.forEach((v, i) => {
       findDeepMatches(check, v, [...segments, i], maps, values);
     });
-  } else if (isPlainObject(payload)) {
+  } else if (isObject(payload)) {
     for (const key in payload) {
       findDeepMatches(check, payload[key], [...segments, key], maps, values);
     }
   }
   return { maps, values };
 }
+function isObject(value2) {
+  if (!value2 || typeof value2 !== "object") {
+    return false;
+  }
+  const proto = Object.getPrototypeOf(value2);
+  return proto === Object.prototype || !proto || !proto.constructor;
+}
+
+// src/error.ts
+function toError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  if (typeof error === "string") {
+    return new Error(error, { cause: error });
+  }
+  if (isObject(error)) {
+    if ("message" in error && typeof error.message === "string") {
+      return new Error(error.message, { cause: error });
+    }
+    if ("name" in error && typeof error.name === "string") {
+      return new Error(error.name, { cause: error });
+    }
+  }
+  return new Error("Unknown error", { cause: error });
+}
+
+// src/interceptor.ts
+function onStart(callback) {
+  return async (options, ...rest) => {
+    await callback(options, ...rest);
+    return await options.next();
+  };
+}
+function onSuccess(callback) {
+  return async (options, ...rest) => {
+    const result = await options.next();
+    await callback(result, options, ...rest);
+    return result;
+  };
+}
+function onError(callback) {
+  return async (options, ...rest) => {
+    try {
+      return await options.next();
+    } catch (error) {
+      await callback(error, options, ...rest);
+      throw error;
+    }
+  };
+}
+function onFinish(callback) {
+  let state;
+  return async (options, ...rest) => {
+    try {
+      const result = await options.next();
+      state = [result, void 0, "success"];
+      return result;
+    } catch (error) {
+      state = [void 0, error, "error"];
+      throw error;
+    } finally {
+      await callback(state, options, ...rest);
+    }
+  };
+}
+async function intercept(interceptors, options, main) {
+  let index = 0;
+  const next = async (options2) => {
+    const interceptor = interceptors[index++];
+    if (!interceptor) {
+      return await main(options2);
+    }
+    return await interceptor({
+      ...options2,
+      next: (newOptions = options2) => next(newOptions)
+    });
+  };
+  return await next(options);
+}
 
 // src/value.ts
-function value(value2) {
+function value(value2, ...args) {
   if (typeof value2 === "function") {
-    return value2();
+    return value2(...args);
   }
   return value2;
 }
 
 // src/index.ts
-import { isPlainObject as isPlainObject2 } from "is-what";
-import { guard, mapEntries, mapValues, omit, trim } from "radash";
+import { group, guard, mapEntries, mapValues, omit, retry, trim } from "radash";
 export {
   findDeepMatches,
   get,
+  group,
   guard,
-  isPlainObject2 as isPlainObject,
+  intercept,
+  isObject,
   mapEntries,
   mapValues,
   omit,
-  parseJSONSafely,
+  onError,
+  onFinish,
+  onStart,
+  onSuccess,
+  retry,
   set,
+  toError,
   trim,
   value
 };
+//# sourceMappingURL=index.js.map

package/dist/src/chain.d.ts

@@ -0,0 +1,5 @@
+import type { AnyFunction } from './function';
+export type OmitChainMethodDeep<T extends object, K extends keyof any> = {
+    [P in keyof Omit<T, K>]: T[P] extends AnyFunction ? ((...args: Parameters<T[P]>) => OmitChainMethodDeep<ReturnType<T[P]>, K>) : T[P];
+};
+//# sourceMappingURL=chain.d.ts.map

package/dist/src/error.d.ts

@@ -1,57 +1,2 @@
-import { type ZodIssue } from 'zod';
-export declare const ORPC_ERROR_CODE_STATUSES: {
-    readonly BAD_REQUEST: 400;
-    readonly UNAUTHORIZED: 401;
-    readonly FORBIDDEN: 403;
-    readonly NOT_FOUND: 404;
-    readonly METHOD_NOT_SUPPORTED: 405;
-    readonly NOT_ACCEPTABLE: 406;
-    readonly TIMEOUT: 408;
-    readonly CONFLICT: 409;
-    readonly PRECONDITION_FAILED: 412;
-    readonly PAYLOAD_TOO_LARGE: 413;
-    readonly UNSUPPORTED_MEDIA_TYPE: 415;
-    readonly UNPROCESSABLE_CONTENT: 422;
-    readonly TOO_MANY_REQUESTS: 429;
-    readonly CLIENT_CLOSED_REQUEST: 499;
-    readonly INTERNAL_SERVER_ERROR: 500;
-    readonly NOT_IMPLEMENTED: 501;
-    readonly BAD_GATEWAY: 502;
-    readonly SERVICE_UNAVAILABLE: 503;
-    readonly GATEWAY_TIMEOUT: 504;
-};
-export type ORPCErrorCode = keyof typeof ORPC_ERROR_CODE_STATUSES;
-export declare class ORPCError<TCode extends ORPCErrorCode, TData> extends Error {
-    zz$oe: {
-        code: TCode;
-        status?: number;
-        message?: string;
-        cause?: unknown;
-    } & (undefined extends TData ? {
-        data?: TData;
-    } : {
-        data: TData;
-    });
-    constructor(zz$oe: {
-        code: TCode;
-        status?: number;
-        message?: string;
-        cause?: unknown;
-    } & (undefined extends TData ? {
-        data?: TData;
-    } : {
-        data: TData;
-    }));
-    get code(): TCode;
-    get status(): number;
-    get data(): TData;
-    get issues(): ZodIssue[] | undefined;
-    toJSON(): {
-        code: TCode;
-        status: number;
-        message: string;
-        data: TData;
-        issues?: ZodIssue[];
-    };
-    static fromJSON(json: unknown): ORPCError<ORPCErrorCode, any> | undefined;
-}
+export declare function toError(error: unknown): Error;
+//# sourceMappingURL=error.d.ts.map

package/dist/src/function.d.ts

@@ -0,0 +1,2 @@
+export type AnyFunction = (...args: any[]) => any;
+//# sourceMappingURL=function.d.ts.map

package/dist/src/index.d.ts

@@ -1,6 +1,10 @@
-export * from './json';
+export * from './chain';
+export * from './error';
+export * from './function';
+export * from './interceptor';
 export * from './object';
+export * from './types';
 export * from './value';
-export { isPlainObject } from 'is-what';
-export { guard, mapEntries, mapValues, omit, trim } from 'radash';
-export type * from 'type-fest';
+export { group, guard, mapEntries, mapValues, omit, retry, trim } from 'radash';
+export type { IsEqual, IsNever, PartialDeep, Promisable } from 'type-fest';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/interceptor.d.ts

@@ -0,0 +1,45 @@
+import type { Promisable } from 'type-fest';
+export type InterceptableOptions = Record<string, any>;
+export type InterceptorOptions<TOptions extends InterceptableOptions, TResult> = Omit<TOptions, 'next'> & {
+    next(options?: TOptions): Promise<TResult>;
+};
+export type Interceptor<TOptions extends InterceptableOptions, TResult, TError> = (options: InterceptorOptions<TOptions, TResult>) => Promise<TResult> & {
+    __error?: {
+        type: TError;
+    };
+};
+/**
+ * Can used for interceptors or middlewares
+ */
+export declare function onStart<TOptions extends {
+    next(): any;
+}, TRest extends any[]>(callback: NoInfer<(options: TOptions, ...rest: TRest) => Promisable<void>>): (options: TOptions, ...rest: TRest) => Promise<Awaited<ReturnType<TOptions['next']>>>;
+/**
+ * Can used for interceptors or middlewares
+ */
+export declare function onSuccess<TOptions extends {
+    next(): any;
+}, TRest extends any[]>(callback: NoInfer<(result: Awaited<ReturnType<TOptions['next']>>, options: TOptions, ...rest: TRest) => Promisable<void>>): (options: TOptions, ...rest: TRest) => Promise<Awaited<ReturnType<TOptions['next']>>>;
+/**
+ * Can used for interceptors or middlewares
+ */
+export declare function onError<TError, TOptions extends {
+    next(): any;
+}, TRest extends any[]>(callback: NoInfer<(error: TError, options: TOptions, ...rest: TRest) => Promisable<void>>): (options: TOptions, ...rest: TRest) => Promise<Awaited<ReturnType<TOptions['next']>>> & {
+    __error?: {
+        type: TError;
+    };
+};
+export type OnFinishState<TResult, TError> = [TResult, undefined, 'success'] | [undefined, TError, 'error'];
+/**
+ * Can used for interceptors or middlewares
+ */
+export declare function onFinish<TError, TOptions extends {
+    next(): any;
+}, TRest extends any[]>(callback: NoInfer<(state: OnFinishState<Awaited<ReturnType<TOptions['next']>>, TError>, options: TOptions, ...rest: TRest) => Promisable<void>>): (options: TOptions, ...rest: TRest) => Promise<Awaited<ReturnType<TOptions['next']>>> & {
+    __error?: {
+        type: TError;
+    };
+};
+export declare function intercept<TOptions extends InterceptableOptions, TResult, TError>(interceptors: Interceptor<TOptions, TResult, TError>[], options: NoInfer<TOptions>, main: NoInfer<(options: TOptions) => Promisable<TResult>>): Promise<TResult>;
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/src/object.d.ts

@@ -1,7 +1,12 @@
 export type Segment = string | number;
-export declare function set(root: Readonly<Record<string, unknown> | unknown[]>, segments: Readonly<Segment[]>, value: unknown): unknown;
+export declare function set(root: unknown, segments: Readonly<Segment[]>, value: unknown): unknown;
 export declare function get(root: Readonly<Record<string, unknown> | unknown[]>, segments: Readonly<Segment[]>): unknown;
 export declare function findDeepMatches(check: (value: unknown) => boolean, payload: unknown, segments?: Segment[], maps?: Segment[][], values?: unknown[]): {
     maps: Segment[][];
     values: unknown[];
 };
+/**
+ * Check if the value is an object even it created by `Object.create(null)` or more tricky way.
+ */
+export declare function isObject(value: unknown): value is Record<PropertyKey, unknown>;
+//# sourceMappingURL=object.d.ts.map

package/dist/src/types.d.ts

@@ -0,0 +1,3 @@
+export type MaybeOptionalOptions<TOptions> = [options: TOptions] | (Record<never, never> extends TOptions ? [] : never);
+export type SetOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/value.d.ts

@@ -1,3 +1,4 @@
 import type { Promisable } from 'type-fest';
-export type Value<T> = T | (() => Promisable<T>);
-export declare function value<T extends Value<any>>(value: T): Promise<T extends Value<infer U> ? U : never>;
+export type Value<T, TArgs extends any[] = []> = T | ((...args: TArgs) => Promisable<T>);
+export declare function value<T, TArgs extends any[]>(value: Value<T, TArgs>, ...args: NoInfer<TArgs>): Promise<T extends Value<infer U, any> ? U : never>;
+//# sourceMappingURL=value.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/shared",
   "type": "module",
-  "version": "0.0.0-next.ef3ba82",
+  "version": "0.0.0-next.f17a1a0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -19,27 +19,21 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./error": {
-      "types": "./dist/src/error.d.ts",
-      "import": "./dist/error.js",
-      "default": "./dist/error.js"
-    },
     "./🔒/*": {
       "types": "./dist/src/*.d.ts"
     }
   },
   "files": [
-    "!dist/*.tsbuildinfo",
+    "!**/*.map",
+    "!**/*.tsbuildinfo",
     "dist"
   ],
   "dependencies": {
-    "is-what": "^5.0.2",
     "radash": "^12.1.0",
-    "type-fest": "^4.26.1",
-    "zod": "^3.23.8"
+    "type-fest": "^4.26.1"
   },
   "scripts": {
-    "build": "tsup --clean --entry.index=src/index.ts --entry.error=src/error.ts --format=esm --onSuccess='tsc -b --noCheck'",
+    "build": "tsup --clean --sourcemap --entry.index=src/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
     "build:watch": "pnpm run build --watch",
     "type:check": "tsc -b"
   }

package/dist/error.js

@@ -1,72 +0,0 @@
-// src/error.ts
-import { ZodError } from "zod";
-var ORPC_ERROR_CODE_STATUSES = {
-  BAD_REQUEST: 400,
-  UNAUTHORIZED: 401,
-  FORBIDDEN: 403,
-  NOT_FOUND: 404,
-  METHOD_NOT_SUPPORTED: 405,
-  NOT_ACCEPTABLE: 406,
-  TIMEOUT: 408,
-  CONFLICT: 409,
-  PRECONDITION_FAILED: 412,
-  PAYLOAD_TOO_LARGE: 413,
-  UNSUPPORTED_MEDIA_TYPE: 415,
-  UNPROCESSABLE_CONTENT: 422,
-  TOO_MANY_REQUESTS: 429,
-  CLIENT_CLOSED_REQUEST: 499,
-  INTERNAL_SERVER_ERROR: 500,
-  NOT_IMPLEMENTED: 501,
-  BAD_GATEWAY: 502,
-  SERVICE_UNAVAILABLE: 503,
-  GATEWAY_TIMEOUT: 504
-};
-var ORPCError = class _ORPCError extends Error {
-  constructor(zz$oe) {
-    if (zz$oe.status && (zz$oe.status < 400 || zz$oe.status >= 600)) {
-      throw new Error("The ORPCError status code must be in the 400-599 range.");
-    }
-    super(zz$oe.message, { cause: zz$oe.cause });
-    this.zz$oe = zz$oe;
-  }
-  get code() {
-    return this.zz$oe.code;
-  }
-  get status() {
-    return this.zz$oe.status ?? ORPC_ERROR_CODE_STATUSES[this.code];
-  }
-  get data() {
-    return this.zz$oe.data;
-  }
-  get issues() {
-    if (this.code === "BAD_REQUEST" && this.zz$oe.cause instanceof ZodError) {
-      return this.zz$oe.cause.issues;
-    }
-    return void 0;
-  }
-  toJSON() {
-    return {
-      code: this.code,
-      status: this.status,
-      message: this.message,
-      data: this.data,
-      issues: this.issues
-    };
-  }
-  static fromJSON(json) {
-    if (typeof json !== "object" || json === null || !("code" in json) || !Object.keys(ORPC_ERROR_CODE_STATUSES).find((key) => json.code === key) || !("status" in json) || typeof json.status !== "number" || "message" in json && json.message !== void 0 && typeof json.message !== "string" || "issues" in json && json.issues !== void 0 && !Array.isArray(json.issues)) {
-      return void 0;
-    }
-    return new _ORPCError({
-      code: json.code,
-      status: json.status,
-      message: Reflect.get(json, "message"),
-      data: Reflect.get(json, "data"),
-      cause: "issues" in json ? new ZodError(json.issues) : void 0
-    });
-  }
-};
-export {
-  ORPCError,
-  ORPC_ERROR_CODE_STATUSES
-};

package/dist/src/json.d.ts

@@ -1 +0,0 @@
-export declare function parseJSONSafely(text: string): unknown;