@dr_nikson/effect-grpc 0.2.0-mvp-9971208edee70b39058f12d8c2a1fcfaeecd3b51 → 3.0.0-mvp-e2b78b1c4be4bb339577d68dfce008ef1b56218c

package/dist/client.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.internal.d.ts","sourceRoot":"","sources":["../src/client.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAahD,OAAO,KAAK,KAAK,CAAC,MAAM,aAAa,CAAC;AAGtC,eAAO,MAAM,uBAAuB,eAAqD,CAAC;AAE1F,eAAO,MAAM,oBAAoB,uDAEhC,CAAC;AAGF,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CA8BxE;AAoCD,wBAAgB,uBAAuB,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,yEAI/E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,MAAM,EACzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAK9C,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CACjC"}
+{"version":3,"file":"client.internal.d.ts","sourceRoot":"","sources":["../src/client.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAQhD,OAAO,KAAK,KAAK,CAAC,MAAM,aAAa,CAAC;AAGtC,eAAO,MAAM,uBAAuB,eAAqD,CAAC;AAE1F,eAAO,MAAM,oBAAoB,uDAEhC,CAAC;AAGF,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CA8BxE;AAoCD,wBAAgB,uBAAuB,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,yEAI/E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,MAAM,EACzD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,GAK9C,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CACjC"}

package/dist/client.internal.js

@@ -1,6 +1,7 @@
 import { Context, Effect, Layer } from "effect";
-import { createClient, createContextValues, } from "@connectrpc/connect";
+import { createClient, createContextValues } from "@connectrpc/connect";
 import { createGrpcTransport } from "@connectrpc/connect-node";
+import * as protoRuntime from "./protoRuntime.js";
 export const grpcClientRuntimeTypeId = Symbol("@dr_nikson/effect-grpc/GrpcClientRuntime");
 export const grpcClientRuntimeTag = Context.GenericTag(grpcClientRuntimeTypeId.toString());
 // TODO: this abstraction is kinda useless, right? We can make more in use .. can we?

package/dist/client.internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.internal.js","sourceRoot":"","sources":["../src/client.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhD,OAAO,EAIL,YAAY,EACZ,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAK/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,0CAA0C,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,CACpD,uBAAuB,CAAC,QAAQ,EAAE,CACnC,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAwB;QACpC,IAAI,EAAE,uBAAuB;QAE7B,YAAY,CACV,iBAAoC,EACpC,WAA6D;YAE7D,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,MAAM,SAAS,GAAc,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CACnD,mBAAmB,CAAC;oBAClB,OAAO,EAAE,uBAAuB;iBACjC,CAAC,CACH,CAAC;gBACF,MAAM,MAAM,GAA8B,YAAY,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;gBACrF,MAAM,QAAQ,GAAuC,WAAW,CAAC,MAAM,CACrE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;oBAClB,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;oBAEzE,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;gBAClE,CAAC,EACD,EAAS,CACV,CAAC;gBAEF,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAOD,SAAS,kBAAkB,CACzB,MAAiC,EACjC,UAA6C,EAC7C,iBAAoC;IAEpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEpD,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,CAAC,GAAQ,EAAE,IAAmB,EAAsB,EAAE;gBAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;oBAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAsB,CAAC;oBAEpE,OAAO,MAAM,CAAC,GAAG,EAAE;wBACjB,mBAAmB;wBACnB,gBAAgB;wBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,MAAM;wBACN,kBAAkB;wBAClB,mBAAmB;wBACnB,aAAa,EAAE,mBAAmB,EAAE;qBACtB,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAyB,OAAgB;IAC9E,OAAO,OAAO,CAAC,UAAU,CACvB,2CAA2C,OAAO,GAAG,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAmD;IAEnD,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;KACQ,CAAC;AACnC,CAAC"}
+{"version":3,"file":"client.internal.js","sourceRoot":"","sources":["../src/client.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAKhD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,0CAA0C,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,CACpD,uBAAuB,CAAC,QAAQ,EAAE,CACnC,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAwB;QACpC,IAAI,EAAE,uBAAuB;QAE7B,YAAY,CACV,iBAAoC,EACpC,WAA6D;YAE7D,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,MAAM,SAAS,GAAc,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CACnD,mBAAmB,CAAC;oBAClB,OAAO,EAAE,uBAAuB;iBACjC,CAAC,CACH,CAAC;gBACF,MAAM,MAAM,GAA8B,YAAY,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;gBACrF,MAAM,QAAQ,GAAuC,WAAW,CAAC,MAAM,CACrE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;oBAClB,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;oBAEzE,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;gBAClE,CAAC,EACD,EAAS,CACV,CAAC;gBAEF,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAOD,SAAS,kBAAkB,CACzB,MAAiC,EACjC,UAA6C,EAC7C,iBAAoC;IAEpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEpD,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,CAAC,GAAQ,EAAE,IAAmB,EAAsB,EAAE;gBAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;oBAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAsB,CAAC;oBAEpE,OAAO,MAAM,CAAC,GAAG,EAAE;wBACjB,mBAAmB;wBACnB,gBAAgB;wBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,MAAM;wBACN,kBAAkB;wBAClB,mBAAmB;wBACnB,aAAa,EAAE,mBAAmB,EAAE;qBACtB,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAyB,OAAgB;IAC9E,OAAO,OAAO,CAAC,UAAU,CACvB,2CAA2C,OAAO,GAAG,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAmD;IAEnD,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;KACQ,CAAC;AACnC,CAAC"}

package/dist/client.js

@@ -1,3 +1,6 @@
+// packages/effect-grpc/src/client.ts
+import { Context, Effect, Layer, Types } from "effect";
+import {} from "@connectrpc/connect";
 import * as internal from "./client.internal.js";
 /**
  * Context tag for accessing the GrpcClient service.

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAwCjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,QAAQ,CAAC,oBAAoB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAEnC,QAAQ,CAAC,qBAAqB,CAAC;AAmEnC,MAAM,CAAC,MAAM,gBAAgB,GAQzB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IAC1D,OAAO,EAAE,QAAQ,CAAC,uBAAuB;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIvD,OAAO,EAAsB,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAwCjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,QAAQ,CAAC,oBAAoB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAEnC,QAAQ,CAAC,qBAAqB,CAAC;AAmEnC,MAAM,CAAC,MAAM,gBAAgB,GAQzB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IAC1D,OAAO,EAAE,QAAQ,CAAC,uBAAuB;CAC1C,CAAC,CAAC"}

package/dist/grpcException.d.ts

@@ -0,0 +1,243 @@
+import type { Code, ConnectError } from "@connectrpc/connect";
+declare const GrpcException_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "@dr_nikson/effect-grpc/grpcException/GrpcException";
+} & Readonly<A>;
+/**
+ * A high-level error type for gRPC operations in Effect programs.
+ *
+ * GrpcException is a tagged error that extends Data.TaggedError, designed as part of the DSL
+ * for gRPC error handling. It focuses on application-level concerns (code, message, description, cause)
+ * rather than low-level wire-format details.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * // Create an exception with a code and message
+ * const notFoundError = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ *
+ * // Use in Effect programs with catchTag
+ * const program = Effect.gen(function* () {
+ *   yield* notFoundError; // The error is yieldable
+ *   yield* Effect.fail(notFoundError);
+ * }).pipe(
+ *   Effect.catchTag(GrpcException, (error) => {
+ *     console.log(`gRPC error [${Code[error.code]}]: ${error.message}`);
+ *     return Effect.succeed("recovered");
+ *   })
+ * );
+ *
+ * // Convert from unknown error
+ * try {
+ *   // some operation
+ * } catch (error) {
+ *   yield* GrpcException.from(Code.Internal, error);
+ * }
+ *
+ * // Add context with description
+ * const enriched = GrpcException.withDescription(
+ *   notFoundError,
+ *   "Database query failed"
+ * );
+ * ```
+ *
+ * @category Error Handling
+ * @since 0.2.0
+ */
+export declare class GrpcException extends GrpcException_base<{
+    /**
+     * The gRPC status code for this error.
+     */
+    readonly code: Code;
+    /**
+     * The error message describing what went wrong.
+     */
+    readonly message: string;
+    /**
+     * Optional description providing additional context about the error.
+     * This can be used to add higher-level context without modifying the original message.
+     *
+     * Unlike the message field, description can be easily modified as errors bubble up
+     * through the call stack using withDescription.
+     */
+    readonly description?: string;
+    /**
+     * Optional cause of this error.
+     * Used to chain errors and preserve the original error that caused this exception.
+     * Can be a native Error, Effect tagged error.
+     */
+    readonly cause?: unknown;
+}> {
+    /**
+     * Returns a formatted error message including the status code, message, and description (if present).
+     * This is called automatically when the error is converted to a string.
+     *
+     * Format:
+     * - Without description: "[code] message"
+     * - With description: "[code] message (description)"
+     *
+     * @example
+     * ```typescript
+     * import { GrpcException } from "@dr_nikson/effect-grpc";
+     * import { Code } from "@connectrpc/connect";
+     *
+     * const error1 = GrpcException.create(
+     *   Code.NotFound,
+     *   "User not found"
+     * );
+     * console.log(error1.toString());
+     * // Output: "[not_found] User not found"
+     *
+     * const error2 = GrpcException.withDescription(
+     *   error1,
+     *   "Database query failed"
+     * );
+     * console.log(error2.toString());
+     * // Output: "[not_found] User not found (Database query failed)"
+     * ```
+     */
+    toString(): string;
+}
+/**
+ * Creates a new GrpcException from the provided parameters.
+ *
+ * This is the primary constructor for creating GrpcException instances.
+ * Code and message are required; cause is optional.
+ *
+ * @param code - The gRPC status code (required)
+ * @param message - The error message (required)
+ * @param cause - Optional cause of the error
+ * @returns A new GrpcException instance
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * // Simple error
+ * const error1 = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ *
+ * // With cause
+ * try {
+ *   // some operation
+ * } catch (err) {
+ *   const error2 = GrpcException.create(
+ *     Code.Internal,
+ *     "Operation failed",
+ *     err
+ *   );
+ * }
+ * ```
+ */
+export declare const create: {
+    (code: Code, message: string, cause?: unknown): GrpcException;
+};
+/**
+ * Converts any value into a GrpcException, following these rules:
+ * - If the cause is a ConnectError, wraps it preserving code and message
+ * - For other Errors, creates a GrpcException with the error message and sets it as cause
+ * - For other values, converts to string and uses as message
+ *
+ * @param code - The gRPC status code to use (required)
+ * @param cause - The error/value to convert (native Error, ConnectError, or any value)
+ * @returns A GrpcException instance
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code, ConnectError } from "@connectrpc/connect";
+ *
+ * const handleError = (error: unknown) =>
+ *   Effect.fail(GrpcException.from(Code.Internal, error));
+ *
+ * // From ConnectError - preserves code and message
+ * const connectErr = new ConnectError("Not found", Code.NotFound);
+ * const grpcErr1 = GrpcException.from(Code.Internal, connectErr);
+ * // grpcErr1.code === Code.NotFound (from ConnectError, not the parameter)
+ * // grpcErr1.message === "Not found"
+ *
+ * // From regular Error - sets as cause
+ * const regularErr = new Error("Network timeout");
+ * const grpcErr2 = GrpcException.from(Code.Unavailable, regularErr);
+ * // grpcErr2.code === Code.Unavailable
+ * // grpcErr2.message === "Network timeout"
+ * // grpcErr2.cause === regularErr
+ * ```
+ */
+export declare const from: {
+    (code: Code, cause: unknown): GrpcException;
+};
+/**
+ * Sets or replaces the description field of a GrpcException.
+ * Returns a new GrpcException with the specified description.
+ *
+ * @param error - The GrpcException to modify
+ * @param description - The description to set
+ * @returns A new GrpcException with the description
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * const error = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ * const enriched = GrpcException.withDescription(
+ *   error,
+ *   "Database query failed"
+ * );
+ * // enriched.description === "Database query failed"
+ * ```
+ */
+export declare const withDescription: {
+    (error: GrpcException, description: string): GrpcException;
+};
+/**
+ * Converts a GrpcException to a ConnectError for use with Connect-RPC.
+ * This is useful when you need to throw or return errors in Connect-RPC handlers.
+ *
+ * Only the code, message, and cause are preserved. Description is not included
+ * as ConnectError doesn't have a corresponding field.
+ *
+ * @param error - The GrpcException to convert
+ * @returns A ConnectError instance
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * const error = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ * const withDesc = GrpcException.withDescription(
+ *   error,
+ *   "Database query failed"
+ * );
+ *
+ * const connectError = GrpcException.toConnectError(withDesc);
+ * // connectError.code === Code.NotFound
+ * // connectError.rawMessage === "User not found"
+ * // Note: description is lost in conversion
+ *
+ * // Can be thrown in Connect-RPC handlers
+ * throw GrpcException.toConnectError(error);
+ * ```
+ */
+export declare const toConnectError: {
+    (error: GrpcException): ConnectError;
+};
+export {};
+//# sourceMappingURL=grpcException.d.ts.map

package/dist/grpcException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpcException.d.ts","sourceRoot":"","sources":["../src/grpcException.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;;;;AAI9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,aAAc,SAAQ,mBAEjC;IACA;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;IACA;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ,IAAI,MAAM;CAUnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAC7C,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC;CAC7B,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,eAAe,EAAE;IAC5B,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC;CACjC,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,cAAc,EAAE;IAC3B,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAAC;CACZ,CAAC"}

package/dist/grpcException.internal.d.ts

@@ -0,0 +1,28 @@
+import { ConnectError } from "@connectrpc/connect";
+import type { Code } from "@connectrpc/connect";
+import { GrpcException } from "./grpcException.js";
+/**
+ * @internal
+ */
+export declare const create: (code: Code, message: string, cause?: unknown) => GrpcException;
+/**
+ * @internal
+ */
+export declare const from: (code: Code, cause: unknown) => GrpcException;
+/**
+ * @internal
+ */
+export declare const withDescription: (error: GrpcException, description: string) => GrpcException;
+/**
+ * @internal
+ */
+export declare const toConnectError: (error: GrpcException) => ConnectError;
+/**
+ * @internal
+ */
+export declare const toString: (error: GrpcException) => string;
+/**
+ * @internal
+ */
+export declare const inspect: (error: GrpcException) => string;
+//# sourceMappingURL=grpcException.internal.d.ts.map

package/dist/grpcException.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpcException.internal.d.ts","sourceRoot":"","sources":["../src/grpcException.internal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,EAAE,SAAS,MAAM,EAAE,QAAQ,OAAO,KAAG,aAErE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,IAAI,EAAE,OAAO,OAAO,KAAG,aA2BjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,EAAE,aAAa,MAAM,KAAG,aAO3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,KAAG,YAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,KAAG,MAO/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,aAAa,KAAG,MAE9C,CAAC"}

package/dist/grpcException.internal.js

@@ -0,0 +1,72 @@
+// packages/effect-grpc/src/grpcException.internal.ts
+import { ConnectError } from "@connectrpc/connect";
+import { GrpcException } from "./grpcException.js";
+/**
+ * @internal
+ */
+export const create = (code, message, cause) => {
+    return new GrpcException({ code, message, cause });
+};
+/**
+ * @internal
+ */
+export const from = (code, cause) => {
+    // Handle ConnectError - preserve code and message
+    if (cause instanceof ConnectError) {
+        return new GrpcException({
+            code: cause.code,
+            message: cause.rawMessage,
+            cause,
+        });
+    }
+    // Handle regular Error - use error message and set as cause
+    if (cause instanceof Error) {
+        return new GrpcException({
+            code,
+            message: cause.message,
+            cause,
+        });
+    }
+    // For other values, convert to string and use as message
+    const message = String(cause);
+    return new GrpcException({
+        code,
+        message,
+        cause,
+    });
+};
+/**
+ * @internal
+ */
+export const withDescription = (error, description) => {
+    return new GrpcException({
+        code: error.code,
+        message: error.message,
+        description,
+        cause: error.cause,
+    });
+};
+/**
+ * @internal
+ */
+export const toConnectError = (error) => {
+    return new ConnectError(error.message, error.code, undefined, undefined, error.cause);
+};
+/**
+ * @internal
+ */
+export const toString = (error) => {
+    const codeStr = error.code;
+    const parts = [`[${codeStr}]`, error.message];
+    if (error.description) {
+        parts.push(`(${error.description})`);
+    }
+    return parts.join(" ");
+};
+/**
+ * @internal
+ */
+export const inspect = (error) => {
+    return toString(error);
+};
+//# sourceMappingURL=grpcException.internal.js.map

package/dist/grpcException.internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpcException.internal.js","sourceRoot":"","sources":["../src/grpcException.internal.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,OAAe,EAAE,KAAe,EAAiB,EAAE;IACpF,OAAO,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAU,EAAE,KAAc,EAAiB,EAAE;IAChE,kDAAkD;IAClD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,UAAU;YACzB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI;YACJ,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9B,OAAO,IAAI,aAAa,CAAC;QACvB,IAAI;QACJ,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAoB,EAAE,WAAmB,EAAiB,EAAE;IAC1F,OAAO,IAAI,aAAa,CAAC;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW;QACX,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAgB,EAAE;IACnE,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAoB,EAAU,EAAE;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAoB,EAAU,EAAE;IACtD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC,CAAC"}

package/dist/grpcException.js

@@ -0,0 +1,218 @@
+// packages/effect-grpc/src/grpcException.ts
+import { Data } from "effect";
+import * as internal from "./grpcException.internal.js";
+/**
+ * A high-level error type for gRPC operations in Effect programs.
+ *
+ * GrpcException is a tagged error that extends Data.TaggedError, designed as part of the DSL
+ * for gRPC error handling. It focuses on application-level concerns (code, message, description, cause)
+ * rather than low-level wire-format details.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * // Create an exception with a code and message
+ * const notFoundError = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ *
+ * // Use in Effect programs with catchTag
+ * const program = Effect.gen(function* () {
+ *   yield* notFoundError; // The error is yieldable
+ *   yield* Effect.fail(notFoundError);
+ * }).pipe(
+ *   Effect.catchTag(GrpcException, (error) => {
+ *     console.log(`gRPC error [${Code[error.code]}]: ${error.message}`);
+ *     return Effect.succeed("recovered");
+ *   })
+ * );
+ *
+ * // Convert from unknown error
+ * try {
+ *   // some operation
+ * } catch (error) {
+ *   yield* GrpcException.from(Code.Internal, error);
+ * }
+ *
+ * // Add context with description
+ * const enriched = GrpcException.withDescription(
+ *   notFoundError,
+ *   "Database query failed"
+ * );
+ * ```
+ *
+ * @category Error Handling
+ * @since 0.2.0
+ */
+export class GrpcException extends Data.TaggedError("@dr_nikson/effect-grpc/grpcException/GrpcException") {
+    /**
+     * Returns a formatted error message including the status code, message, and description (if present).
+     * This is called automatically when the error is converted to a string.
+     *
+     * Format:
+     * - Without description: "[code] message"
+     * - With description: "[code] message (description)"
+     *
+     * @example
+     * ```typescript
+     * import { GrpcException } from "@dr_nikson/effect-grpc";
+     * import { Code } from "@connectrpc/connect";
+     *
+     * const error1 = GrpcException.create(
+     *   Code.NotFound,
+     *   "User not found"
+     * );
+     * console.log(error1.toString());
+     * // Output: "[not_found] User not found"
+     *
+     * const error2 = GrpcException.withDescription(
+     *   error1,
+     *   "Database query failed"
+     * );
+     * console.log(error2.toString());
+     * // Output: "[not_found] User not found (Database query failed)"
+     * ```
+     */
+    toString() {
+        return internal.toString(this);
+    }
+    /**
+     * Custom inspection for Node.js util.inspect
+     */
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return internal.inspect(this);
+    }
+}
+/**
+ * Creates a new GrpcException from the provided parameters.
+ *
+ * This is the primary constructor for creating GrpcException instances.
+ * Code and message are required; cause is optional.
+ *
+ * @param code - The gRPC status code (required)
+ * @param message - The error message (required)
+ * @param cause - Optional cause of the error
+ * @returns A new GrpcException instance
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * // Simple error
+ * const error1 = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ *
+ * // With cause
+ * try {
+ *   // some operation
+ * } catch (err) {
+ *   const error2 = GrpcException.create(
+ *     Code.Internal,
+ *     "Operation failed",
+ *     err
+ *   );
+ * }
+ * ```
+ */
+export const create = internal.create;
+/**
+ * Converts any value into a GrpcException, following these rules:
+ * - If the cause is a ConnectError, wraps it preserving code and message
+ * - For other Errors, creates a GrpcException with the error message and sets it as cause
+ * - For other values, converts to string and uses as message
+ *
+ * @param code - The gRPC status code to use (required)
+ * @param cause - The error/value to convert (native Error, ConnectError, or any value)
+ * @returns A GrpcException instance
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code, ConnectError } from "@connectrpc/connect";
+ *
+ * const handleError = (error: unknown) =>
+ *   Effect.fail(GrpcException.from(Code.Internal, error));
+ *
+ * // From ConnectError - preserves code and message
+ * const connectErr = new ConnectError("Not found", Code.NotFound);
+ * const grpcErr1 = GrpcException.from(Code.Internal, connectErr);
+ * // grpcErr1.code === Code.NotFound (from ConnectError, not the parameter)
+ * // grpcErr1.message === "Not found"
+ *
+ * // From regular Error - sets as cause
+ * const regularErr = new Error("Network timeout");
+ * const grpcErr2 = GrpcException.from(Code.Unavailable, regularErr);
+ * // grpcErr2.code === Code.Unavailable
+ * // grpcErr2.message === "Network timeout"
+ * // grpcErr2.cause === regularErr
+ * ```
+ */
+export const from = internal.from;
+/**
+ * Sets or replaces the description field of a GrpcException.
+ * Returns a new GrpcException with the specified description.
+ *
+ * @param error - The GrpcException to modify
+ * @param description - The description to set
+ * @returns A new GrpcException with the description
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * const error = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ * const enriched = GrpcException.withDescription(
+ *   error,
+ *   "Database query failed"
+ * );
+ * // enriched.description === "Database query failed"
+ * ```
+ */
+export const withDescription = internal.withDescription;
+/**
+ * Converts a GrpcException to a ConnectError for use with Connect-RPC.
+ * This is useful when you need to throw or return errors in Connect-RPC handlers.
+ *
+ * Only the code, message, and cause are preserved. Description is not included
+ * as ConnectError doesn't have a corresponding field.
+ *
+ * @param error - The GrpcException to convert
+ * @returns A ConnectError instance
+ *
+ * @example
+ * ```typescript
+ * import { GrpcException } from "@dr_nikson/effect-grpc";
+ * import { Code } from "@connectrpc/connect";
+ *
+ * const error = GrpcException.create(
+ *   Code.NotFound,
+ *   "User not found"
+ * );
+ * const withDesc = GrpcException.withDescription(
+ *   error,
+ *   "Database query failed"
+ * );
+ *
+ * const connectError = GrpcException.toConnectError(withDesc);
+ * // connectError.code === Code.NotFound
+ * // connectError.rawMessage === "User not found"
+ * // Note: description is lost in conversion
+ *
+ * // Can be thrown in Connect-RPC handlers
+ * throw GrpcException.toConnectError(error);
+ * ```
+ */
+export const toConnectError = internal.toConnectError;
+//# sourceMappingURL=grpcException.js.map

package/dist/grpcException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpcException.js","sourceRoot":"","sources":["../src/grpcException.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAI9B,OAAO,KAAK,QAAQ,MAAM,6BAA6B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CACjD,oDAAoD,CA2BpD;IACA;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ;QACN,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,MAAM,GAEf,QAAQ,CAAC,MAAM,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,IAAI,GAEb,QAAQ,CAAC,IAAI,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,eAAe,GAExB,QAAQ,CAAC,eAAe,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,cAAc,GAEvB,QAAQ,CAAC,cAAc,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * as EffectGrpcServer from "./server.js";
 export * as EffectGrpcClient from "./client.js";
+export * as GrpcException from "./grpcException.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export * as EffectGrpcServer from "./server.js";
 export * as EffectGrpcClient from "./client.js";
+export * as GrpcException from "./grpcException.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC"}

package/dist/protoRuntime.d.ts

@@ -1,8 +1,9 @@
 import { Effect, Runtime } from "effect";
 import type { DescMessage, MessageInitShape, MessageShape } from "@bufbuild/protobuf";
 import type { GenMessage, GenServiceMethods } from "@bufbuild/protobuf/codegenv2";
-import { HandlerContext } from "@connectrpc/connect";
-import { RequestMeta } from "./client.js";
+import type { HandlerContext } from "@connectrpc/connect";
+import * as GrpcException from "./grpcException.js";
+import type { RequestMeta } from "./client.js";
 /**
  * Type-safe executor interface for gRPC service methods.
  *
@@ -69,14 +70,14 @@ type UnaryClientExecutorFn<I extends DescMessage, O extends DescMessage> = (requ
  * ```
  */
 export interface ServerExecutor<Ctx> {
-    unary<In, Out>(req: In, ctx: HandlerContext, prog: (req: In, ctx: Ctx) => Effect.Effect<Out>): Promise<Out>;
+    unary<In, Out>(req: In, ctx: HandlerContext, prog: (req: In, ctx: Ctx) => Effect.Effect<Out, GrpcException.GrpcException>): Promise<Out>;
 }
 export declare const ServerExecutor: {
     (runtime: Runtime.Runtime<never>): ServerExecutor<HandlerContext>;
 };
 export interface ServerExecutorTransformer<Ctx> {
     readonly transformation: (underlying: ServerExecutor<HandlerContext>) => ServerExecutor<Ctx>;
-    transformContext<Ctx1>(f: (ctx: Ctx) => Effect.Effect<Ctx1>): ServerExecutorTransformer<Ctx1>;
+    transformContext<Ctx1>(f: (ctx: Ctx) => Effect.Effect<Ctx1, GrpcException.GrpcException>): ServerExecutorTransformer<Ctx1>;
 }
 export declare const ServerExecutorTransformer: {
     (): ServerExecutorTransformer<HandlerContext>;