@scrawn/core 0.0.2 → 0.0.6

package/dist/core/errors/index.js

@@ -0,0 +1,280 @@
+/**
+ * Comprehensive error handling system for the Scrawn SDK.
+ *
+ * Provides structured error classes with rich metadata for better debugging
+ * and error handling by SDK consumers.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await scrawn.sdkCallEventConsumer({ ... });
+ * } catch (error) {
+ *   if (error instanceof ScrawnAuthenticationError) {
+ *     console.error('Auth failed:', error.message);
+ *     // Refresh API key
+ *   } else if (error instanceof ScrawnNetworkError && error.retryable) {
+ *     // Retry the request
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Base error class for all Scrawn SDK errors.
+ * Extends native Error with additional metadata fields.
+ */
+export class ScrawnError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = "ScrawnError";
+        this.code = options.code;
+        this.retryable = options.retryable ?? false;
+        this.statusCode = options.statusCode;
+        this.requestId = options.requestId;
+        this.details = options.details;
+        this.cause = options.cause;
+        // Maintains proper stack trace for where our error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to a plain object for logging/serialization.
+     */
+    // fallow-ignore-next-line unused-class-member
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            retryable: this.retryable,
+            statusCode: this.statusCode,
+            requestId: this.requestId,
+            details: this.details,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Authentication or authorization error (401, 403).
+ * Thrown when API key is invalid, expired, or lacks permissions.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnAuthenticationError('Invalid API key', {
+ *   statusCode: 401,
+ *   requestId: 'req_123'
+ * });
+ * ```
+ */
+export class ScrawnAuthenticationError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "AUTHENTICATION_ERROR",
+            retryable: false,
+            statusCode: options?.statusCode ?? 401,
+            requestId: options?.requestId,
+            details: options?.details,
+            cause: options?.cause,
+        });
+        this.name = "ScrawnAuthenticationError";
+    }
+}
+/**
+ * Validation error (400).
+ * Thrown when request payload fails validation.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnValidationError('Invalid userId', {
+ *   details: { field: 'userId', constraint: 'non-empty' }
+ * });
+ * ```
+ */
+export class ScrawnValidationError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "VALIDATION_ERROR",
+            retryable: false,
+            statusCode: 400,
+            requestId: options?.requestId,
+            details: options?.details,
+            cause: options?.cause,
+        });
+        this.name = "ScrawnValidationError";
+    }
+}
+/**
+ * Rate limit error (429).
+ * Thrown when API rate limits are exceeded.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnRateLimitError('Rate limit exceeded', {
+ *   details: { retryAfter: 60 }
+ * });
+ * ```
+ */
+export class ScrawnRateLimitError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "RATE_LIMIT_ERROR",
+            retryable: true,
+            statusCode: 429,
+            requestId: options?.requestId,
+            details: options?.details,
+            cause: options?.cause,
+        });
+        this.name = "ScrawnRateLimitError";
+        this.retryAfter = options?.retryAfter;
+    }
+}
+/**
+ * Network-related error (timeout, connection failure, DNS issues).
+ * These are typically retryable.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnNetworkError('Connection timeout', {
+ *   cause: originalError,
+ *   details: { timeout: 30000 }
+ * });
+ * ```
+ */
+export class ScrawnNetworkError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "NETWORK_ERROR",
+            retryable: true,
+            requestId: options?.requestId,
+            details: options?.details,
+            cause: options?.cause,
+        });
+        this.name = "ScrawnNetworkError";
+    }
+}
+/**
+ * API error from the Scrawn backend (5xx or other server errors).
+ * May be retryable depending on status code.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnAPIError('Internal server error', {
+ *   statusCode: 500,
+ *   retryable: true,
+ *   requestId: 'req_123'
+ * });
+ * ```
+ */
+export class ScrawnAPIError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "API_ERROR",
+            retryable: options.retryable ?? options.statusCode >= 500,
+            statusCode: options.statusCode,
+            requestId: options.requestId,
+            details: options.details,
+            cause: options.cause,
+        });
+        this.name = "ScrawnAPIError";
+    }
+}
+/**
+ * Configuration error (invalid SDK initialization or settings).
+ * Not retryable - requires code changes.
+ *
+ * @example
+ * ```typescript
+ * throw new ScrawnConfigError('Invalid baseURL format', {
+ *   details: { baseURL: 'invalid-url' }
+ * });
+ * ```
+ */
+export class ScrawnConfigError extends ScrawnError {
+    constructor(message, options) {
+        super(message, {
+            code: "CONFIG_ERROR",
+            retryable: false,
+            details: options?.details,
+            cause: options?.cause,
+        });
+        this.name = "ScrawnConfigError";
+    }
+}
+/**
+ * Helper function to convert gRPC errors to Scrawn errors.
+ * Maps gRPC status codes to appropriate Scrawn error types.
+ *
+ * @internal
+ */
+export function convertGrpcError(error, requestId) {
+    const message = error instanceof Error ? error.message : "Unknown error occurred";
+    // Handle @grpc/grpc-js ServiceError
+    if (error && typeof error === "object" && "code" in error) {
+        const code = error.code;
+        const details = "details" in error ? error.details : undefined;
+        const fullMessage = details ? `${message}: ${details}` : message;
+        // @grpc/grpc-js status codes: https://grpc.github.io/grpc/core/md_status_codes.html
+        switch (code) {
+            case 16: // UNAUTHENTICATED
+            case 7: // PERMISSION_DENIED
+                return new ScrawnAuthenticationError(fullMessage, {
+                    statusCode: code === 16 ? 401 : 403,
+                    requestId,
+                    cause: error,
+                });
+            case 3: // INVALID_ARGUMENT
+                return new ScrawnValidationError(fullMessage, {
+                    requestId,
+                    cause: error,
+                });
+            case 8: // RESOURCE_EXHAUSTED (rate limit)
+                return new ScrawnRateLimitError(fullMessage, {
+                    requestId,
+                    cause: error,
+                });
+            case 14: // UNAVAILABLE
+            case 4: // DEADLINE_EXCEEDED
+                return new ScrawnNetworkError(fullMessage, {
+                    requestId,
+                    details: { grpcCode: code },
+                    cause: error,
+                });
+            case 13: // INTERNAL
+            case 2: // UNKNOWN
+            case 12: // UNIMPLEMENTED
+                return new ScrawnAPIError(fullMessage, {
+                    statusCode: 500,
+                    retryable: code !== 12,
+                    requestId,
+                    details: { grpcCode: code },
+                    cause: error,
+                });
+            default:
+                return new ScrawnAPIError(fullMessage, {
+                    statusCode: 500,
+                    retryable: false,
+                    requestId,
+                    details: { grpcCode: code },
+                    cause: error,
+                });
+        }
+    }
+    // Fallback for unknown error types
+    return new ScrawnNetworkError(message, {
+        requestId,
+        cause: error instanceof Error ? error : undefined,
+    });
+}
+/**
+ * Helper to check if an error is a Scrawn error.
+ */
+export function isScrawnError(error) {
+    return error instanceof ScrawnError;
+}
+/**
+ * Helper to check if an error is retryable.
+ */
+export function isRetryableError(error) {
+    return isScrawnError(error) && error.retryable;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/errors/index.js.map

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

package/dist/core/grpc/callContext.d.ts

@@ -0,0 +1,18 @@
+import * as grpc from "@grpc/grpc-js";
+import { ScrawnLogger } from "../../utils/logger.js";
+export declare class GrpcCallContext<C extends grpc.ServiceClientConstructor> {
+    readonly ClientConstructor: C;
+    readonly methodName: string;
+    readonly target: string;
+    readonly credentials: grpc.ChannelCredentials;
+    readonly log: ScrawnLogger;
+    private readonly metadata;
+    constructor(target: string, credentials: grpc.ChannelCredentials, ClientConstructor: C, methodName: string, loggerName: string);
+    addMetadata(key: string, value: string): void;
+    getMetadata(): grpc.Metadata;
+    getServiceName(): string;
+    logCallStart(): void;
+    logCallSuccess(): void;
+    logCallError(error: unknown): void;
+}
+//# sourceMappingURL=callContext.d.ts.map

package/dist/core/grpc/callContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callContext.d.ts","sourceRoot":"","sources":["../../../src/core/grpc/callContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,qBAAa,eAAe,CAAC,CAAC,SAAS,IAAI,CAAC,wBAAwB;IAClE,SAAgB,iBAAiB,EAAE,CAAC,CAAC;IACrC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC;IACrD,SAAgB,GAAG,EAAE,YAAY,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;gBAG9C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,IAAI,CAAC,kBAAkB,EACpC,iBAAiB,EAAE,CAAC,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM;IASpB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7C,WAAW,IAAI,IAAI,CAAC,QAAQ;IAQ5B,cAAc,IAAI,MAAM;IAIxB,YAAY,IAAI,IAAI;IAMpB,cAAc,IAAI,IAAI;IAMtB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAKnC"}

package/dist/core/grpc/callContext.js

@@ -0,0 +1,35 @@
+import * as grpc from "@grpc/grpc-js";
+import { ScrawnLogger } from "../../utils/logger.js";
+export class GrpcCallContext {
+    constructor(target, credentials, ClientConstructor, methodName, loggerName) {
+        this.metadata = new grpc.Metadata();
+        this.target = target;
+        this.credentials = credentials;
+        this.ClientConstructor = ClientConstructor;
+        this.methodName = methodName;
+        this.log = new ScrawnLogger(loggerName);
+    }
+    addMetadata(key, value) {
+        this.metadata.set(key, value);
+    }
+    getMetadata() {
+        const copy = new grpc.Metadata();
+        for (const [key, values] of Object.entries(this.metadata.getMap())) {
+            copy.set(key, values);
+        }
+        return copy;
+    }
+    getServiceName() {
+        return this.ClientConstructor.serviceName;
+    }
+    logCallStart() {
+        this.log.info(`Making gRPC call to ${this.getServiceName()}.${this.methodName}`);
+    }
+    logCallSuccess() {
+        this.log.info(`Successfully completed gRPC call to ${this.getServiceName()}.${this.methodName}`);
+    }
+    logCallError(error) {
+        this.log.error(`gRPC call to ${this.getServiceName()}.${this.methodName} failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+//# sourceMappingURL=callContext.js.map

package/dist/core/grpc/callContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callContext.js","sourceRoot":"","sources":["../../../src/core/grpc/callContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,OAAO,eAAe;IAQ1B,YACE,MAAc,EACd,WAAoC,EACpC,iBAAoB,EACpB,UAAkB,EAClB,UAAkB;QAPH,aAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAS9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,WAAW,CAAC,GAAW,EAAE,KAAa;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,WAAW;QACT,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED,YAAY;QACV,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,uBAAuB,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,uCAAuC,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,KAAc;QACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,gBAAgB,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,UAAU,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC/H,CAAC;IACJ,CAAC;CACF"}

package/dist/core/grpc/client.d.ts

@@ -1,126 +1,16 @@
-/**
- * Type-safe gRPC client abstraction layer.
- *
- * This module provides the main entry point for making gRPC calls with
- * full compile-time type safety and a beautiful fluent API.
- *
- * @example
- * ```typescript
- * const client = new GrpcClient('https://api.scrawn.dev');
- *
- * const response = await client
- *   .newCall(EventService, 'registerEvent')
- *   .addHeader('Authorization', `Bearer ${apiKey}`)
- *   .addHeader('x-request-id', '123')
- *   .addPayload({
- *     type: EventType.SDK_CALL,
- *     userId: 'user_123',
- *     data: { case: 'sdkCall', value: new SDKCall({ sdkCallType: SDKCallType.RAW, debitAmount: 10 }) }
- *   })
- *   .request();
- * ```
- */
-import type { Transport } from '@connectrpc/connect';
-import type { ServiceType } from '@bufbuild/protobuf';
-import { RequestBuilder } from './requestBuilder.js';
-import type { ServiceMethodNames } from './types.js';
-/**
- * Main gRPC client for making type-safe API calls.
- *
- * This class manages the underlying transport and provides a factory method
- * for creating type-safe request builders. Each request builder is bound to
- * a specific service and method, ensuring compile-time type safety.
- *
- * The client handles:
- * - Transport configuration (HTTP/1.1)
- * - Request building with fluent API
- * - Header management (auth should be added via .addHeader())
- * - Error handling and logging
- *
- * @example
- * ```typescript
- * // Initialize the client
- * const client = new GrpcClient('https://api.scrawn.dev');
- *
- * // Fetch credentials from your auth system
- * const creds = await getCredentials();
- *
- * // Make a call to EventService.registerEvent
- * const eventResponse = await client
- *   .newCall(EventService, 'registerEvent')
- *   .addHeader('Authorization', `Bearer ${creds.apiKey}`)
- *   .addPayload({ type: EventType.SDK_CALL, userId: 'u123', ... })
- *   .request();
- *
- * // Make a call to AuthService.createAPIKey
- * const authResponse = await client
- *   .newCall(AuthService, 'createAPIKey')
- *   .addHeader('Authorization', `Bearer ${creds.apiKey}`)
- *   .addPayload({ name: 'My Key', expiresIn: 3600n })
- *   .request();
- * ```
- */
+import * as grpc from "@grpc/grpc-js";
+import { RequestBuilder } from "./requestBuilder.js";
+import { StreamRequestBuilder } from "./streamRequestBuilder.js";
+export interface GrpcClientOptions {
+    secure?: boolean;
+    credentials?: grpc.ChannelCredentials;
+}
 export declare class GrpcClient {
-    /** The underlying gRPC transport */
-    private readonly transport;
-    /** Base URL for API calls */
-    private readonly baseURL;
-    /**
-     * Create a new GrpcClient.
-     *
-     * @param baseURL - The base URL of the gRPC API (e.g., 'https://api.scrawn.dev')
-     *
-     * @example
-     * ```typescript
-     * const client = new GrpcClient('https://api.scrawn.dev');
-     * ```
-     */
-    constructor(baseURL: string);
-    /**
-     * Create a new request builder for a specific service method.
-     *
-     * This is the entry point for making gRPC calls. The method is fully type-safe:
-     * - Service parameter must be a valid gRPC service
-     * - Method name must exist on the service (autocomplete provided)
-     * - Payload type is inferred from the method
-     * - Response type is inferred from the method
-     *
-     * @template S - The gRPC service type (auto-inferred)
-     * @template M - The method name (auto-inferred and validated)
-     *
-     * @param service - The gRPC service definition (e.g., EventService, AuthService)
-     * @param method - The method name as a string literal (e.g., 'registerEvent', 'createAPIKey')
-     * @returns A new RequestBuilder for chaining headers, payload, and execution
-     *
-     * @example
-     * ```typescript
-     * // EventService.registerEvent
-     * const eventBuilder = client.newCall(EventService, 'registerEvent');
-     * // Payload type is RegisterEventRequest
-     * // Response type is RegisterEventResponse
-     *
-     * // AuthService.createAPIKey
-     * const authBuilder = client.newCall(AuthService, 'createAPIKey');
-     * // Payload type is CreateAPIKeyRequest
-     * // Response type is CreateAPIKeyResponse
-     *
-     * // Type error - method doesn't exist!
-     * // const invalid = client.newCall(EventService, 'nonExistentMethod');
-     * ```
-     */
-    newCall<S extends ServiceType, M extends ServiceMethodNames<S>>(service: S, method: M): RequestBuilder<S, M>;
-    /**
-     * Get the base URL of this client.
-     *
-     * @returns The base URL string
-     */
-    getBaseURL(): string;
-    /**
-     * Get the underlying transport (for advanced use cases).
-     *
-     * @returns The Connect transport instance
-     * @internal
-     */
-    getTransport(): Transport;
+    private readonly target;
+    private readonly credentials;
+    constructor(target: string, options?: GrpcClientOptions);
+    newCall<C extends grpc.ServiceClientConstructor>(client: C, method: string): RequestBuilder<C>;
+    newStreamCall<C extends grpc.ServiceClientConstructor>(client: C, method: string): StreamRequestBuilder<C>;
+    getTarget(): string;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/core/grpc/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/grpc/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;;;;;;OASG;gBACS,OAAO,EAAE,MAAM;IAa3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC5D,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,GACR,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAKvB;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;OAKG;IACH,YAAY,IAAI,SAAS;CAG1B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/grpc/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAmBvD,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,wBAAwB,EAC7C,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,CAAC,CAAC;IAMpB,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,wBAAwB,EACnD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,CAAC,CAAC;IAM1B,SAAS,IAAI,MAAM;CAGpB"}

package/dist/core/grpc/client.js

@@ -1,138 +1,30 @@
-/**
- * Type-safe gRPC client abstraction layer.
- *
- * This module provides the main entry point for making gRPC calls with
- * full compile-time type safety and a beautiful fluent API.
- *
- * @example
- * ```typescript
- * const client = new GrpcClient('https://api.scrawn.dev');
- *
- * const response = await client
- *   .newCall(EventService, 'registerEvent')
- *   .addHeader('Authorization', `Bearer ${apiKey}`)
- *   .addHeader('x-request-id', '123')
- *   .addPayload({
- *     type: EventType.SDK_CALL,
- *     userId: 'user_123',
- *     data: { case: 'sdkCall', value: new SDKCall({ sdkCallType: SDKCallType.RAW, debitAmount: 10 }) }
- *   })
- *   .request();
- * ```
- */
-import { createConnectTransport } from '@connectrpc/connect-node';
-import { RequestBuilder } from './requestBuilder.js';
-import { ScrawnLogger } from '../../utils/logger.js';
-import { ScrawnConfig } from '../../config.js';
-const log = new ScrawnLogger('GrpcClient');
-/**
- * Main gRPC client for making type-safe API calls.
- *
- * This class manages the underlying transport and provides a factory method
- * for creating type-safe request builders. Each request builder is bound to
- * a specific service and method, ensuring compile-time type safety.
- *
- * The client handles:
- * - Transport configuration (HTTP/1.1)
- * - Request building with fluent API
- * - Header management (auth should be added via .addHeader())
- * - Error handling and logging
- *
- * @example
- * ```typescript
- * // Initialize the client
- * const client = new GrpcClient('https://api.scrawn.dev');
- *
- * // Fetch credentials from your auth system
- * const creds = await getCredentials();
- *
- * // Make a call to EventService.registerEvent
- * const eventResponse = await client
- *   .newCall(EventService, 'registerEvent')
- *   .addHeader('Authorization', `Bearer ${creds.apiKey}`)
- *   .addPayload({ type: EventType.SDK_CALL, userId: 'u123', ... })
- *   .request();
- *
- * // Make a call to AuthService.createAPIKey
- * const authResponse = await client
- *   .newCall(AuthService, 'createAPIKey')
- *   .addHeader('Authorization', `Bearer ${creds.apiKey}`)
- *   .addPayload({ name: 'My Key', expiresIn: 3600n })
- *   .request();
- * ```
- */
+import * as grpc from "@grpc/grpc-js";
+import { GrpcCallContext } from "./callContext.js";
+import { RequestBuilder } from "./requestBuilder.js";
+import { StreamRequestBuilder } from "./streamRequestBuilder.js";
+import { ScrawnLogger } from "../../utils/logger.js";
+const log = new ScrawnLogger("GrpcClient");
 export class GrpcClient {
-    /**
-     * Create a new GrpcClient.
-     *
-     * @param baseURL - The base URL of the gRPC API (e.g., 'https://api.scrawn.dev')
-     *
-     * @example
-     * ```typescript
-     * const client = new GrpcClient('https://api.scrawn.dev');
-     * ```
-     */
-    constructor(baseURL) {
-        this.baseURL = baseURL;
-        log.info(`Initializing gRPC client for ${baseURL}`);
-        this.transport = createConnectTransport({
-            baseUrl: this.baseURL,
-            httpVersion: ScrawnConfig.grpc.httpVersion,
-        });
-        log.info('gRPC client initialized successfully');
+    constructor(target, options) {
+        if (!target || !target.includes(":")) {
+            throw new Error(`Invalid target format: ${target}. Expected host:port format.`);
+        }
+        this.target = target;
+        this.credentials =
+            options?.credentials ??
+                (options?.secure
+                    ? grpc.credentials.createSsl()
+                    : grpc.credentials.createInsecure());
+        log.info(`Initialized gRPC client for ${target} (${options?.secure ? "secure" : "insecure"})`);
     }
-    /**
-     * Create a new request builder for a specific service method.
-     *
-     * This is the entry point for making gRPC calls. The method is fully type-safe:
-     * - Service parameter must be a valid gRPC service
-     * - Method name must exist on the service (autocomplete provided)
-     * - Payload type is inferred from the method
-     * - Response type is inferred from the method
-     *
-     * @template S - The gRPC service type (auto-inferred)
-     * @template M - The method name (auto-inferred and validated)
-     *
-     * @param service - The gRPC service definition (e.g., EventService, AuthService)
-     * @param method - The method name as a string literal (e.g., 'registerEvent', 'createAPIKey')
-     * @returns A new RequestBuilder for chaining headers, payload, and execution
-     *
-     * @example
-     * ```typescript
-     * // EventService.registerEvent
-     * const eventBuilder = client.newCall(EventService, 'registerEvent');
-     * // Payload type is RegisterEventRequest
-     * // Response type is RegisterEventResponse
-     *
-     * // AuthService.createAPIKey
-     * const authBuilder = client.newCall(AuthService, 'createAPIKey');
-     * // Payload type is CreateAPIKeyRequest
-     * // Response type is CreateAPIKeyResponse
-     *
-     * // Type error - method doesn't exist!
-     * // const invalid = client.newCall(EventService, 'nonExistentMethod');
-     * ```
-     */
-    newCall(service, method) {
-        log.debug(`Creating new request builder for ${service.typeName}.${method}`);
-        return new RequestBuilder(this.transport, service, method);
+    newCall(client, method) {
+        return new RequestBuilder(new GrpcCallContext(this.target, this.credentials, client, method, "RequestBuilder"));
     }
-    /**
-     * Get the base URL of this client.
-     *
-     * @returns The base URL string
-     */
-    getBaseURL() {
-        return this.baseURL;
+    newStreamCall(client, method) {
+        return new StreamRequestBuilder(new GrpcCallContext(this.target, this.credentials, client, method, "StreamRequestBuilder"));
     }
-    /**
-     * Get the underlying transport (for advanced use cases).
-     *
-     * @returns The Connect transport instance
-     * @internal
-     */
-    getTransport() {
-        return this.transport;
+    getTarget() {
+        return this.target;
     }
 }
 //# sourceMappingURL=client.js.map