@fairu/sdk 1.0.1

package/dist/FairuError-D8sSmRAa.js

@@ -0,0 +1,214 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class FairuError extends Error {
+  constructor(message, code, originalError) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "originalError");
+    this.name = "FairuError";
+    this.code = code;
+    this.originalError = originalError;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, FairuError);
+    }
+  }
+  /**
+   * Create a FairuError from a urql CombinedError.
+   */
+  static fromCombinedError(error) {
+    var _a, _b;
+    if (error.graphQLErrors.length > 0) {
+      const graphqlError = error.graphQLErrors[0];
+      const category = (_a = graphqlError.extensions) == null ? void 0 : _a.category;
+      if (category === "validation") {
+        return new ValidationError(
+          graphqlError.message,
+          (_b = graphqlError.extensions) == null ? void 0 : _b.validation
+        );
+      }
+      if (category === "authentication") {
+        return new AuthenticationError(graphqlError.message);
+      }
+      return new GraphQLError(error.graphQLErrors);
+    }
+    if (error.networkError) {
+      return new FairuError(
+        `Network error: ${error.networkError.message}`,
+        "NETWORK_ERROR",
+        error.networkError
+      );
+    }
+    return new FairuError(error.message);
+  }
+  /**
+   * Check if this error is a network error.
+   */
+  isNetworkError() {
+    return this.code === "NETWORK_ERROR";
+  }
+  /**
+   * Convert error to a plain object for serialization.
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code
+    };
+  }
+}
+class ValidationError extends FairuError {
+  constructor(message, validationErrors = {}) {
+    super(message, "VALIDATION_ERROR");
+    __publicField(this, "validationErrors");
+    this.name = "ValidationError";
+    this.validationErrors = validationErrors;
+  }
+  /**
+   * Get errors for a specific field.
+   */
+  getFieldErrors(field) {
+    return this.validationErrors[field] ?? [];
+  }
+  /**
+   * Check if a specific field has errors.
+   */
+  hasFieldError(field) {
+    return field in this.validationErrors;
+  }
+  /**
+   * Get all field names with errors.
+   */
+  getFields() {
+    return Object.keys(this.validationErrors);
+  }
+  /**
+   * Get the first error message for a field.
+   */
+  getFirstFieldError(field) {
+    var _a;
+    return (_a = this.validationErrors[field]) == null ? void 0 : _a[0];
+  }
+  /**
+   * Get all error messages as a flat array.
+   */
+  getAllMessages() {
+    return Object.values(this.validationErrors).flat();
+  }
+  /**
+   * Check if there are any validation errors.
+   */
+  hasErrors() {
+    return Object.keys(this.validationErrors).length > 0;
+  }
+  /**
+   * Convert to JSON for serialization.
+   */
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      validationErrors: this.validationErrors
+    };
+  }
+}
+class AuthenticationError extends FairuError {
+  constructor(message = "Invalid or missing API token") {
+    super(message, "AUTHENTICATION_ERROR");
+    this.name = "AuthenticationError";
+  }
+  /**
+   * Check if this is an expired token error.
+   */
+  isTokenExpired() {
+    return this.message.toLowerCase().includes("expired");
+  }
+  /**
+   * Check if this is a missing token error.
+   */
+  isMissingToken() {
+    return this.message.toLowerCase().includes("missing");
+  }
+}
+class GraphQLError extends FairuError {
+  constructor(errors) {
+    const messages = errors.map((e) => e.message).join("; ");
+    super(messages, "GRAPHQL_ERROR");
+    __publicField(this, "graphqlErrors");
+    this.name = "GraphQLError";
+    this.graphqlErrors = errors;
+  }
+  /**
+   * Get the first GraphQL error.
+   */
+  getFirstError() {
+    return this.graphqlErrors[0];
+  }
+  /**
+   * Get all GraphQL errors.
+   */
+  getErrors() {
+    return this.graphqlErrors;
+  }
+  /**
+   * Check if any errors are validation errors.
+   */
+  hasValidationErrors() {
+    return this.graphqlErrors.some(
+      (e) => {
+        var _a;
+        return ((_a = e.extensions) == null ? void 0 : _a.category) === "validation";
+      }
+    );
+  }
+  /**
+   * Get validation errors as a record of field names to error messages.
+   */
+  getValidationErrors() {
+    var _a;
+    const validationErrors = {};
+    for (const error of this.graphqlErrors) {
+      if ((_a = error.extensions) == null ? void 0 : _a.validation) {
+        Object.assign(validationErrors, error.extensions.validation);
+      }
+    }
+    return validationErrors;
+  }
+  /**
+   * Check if any errors are authentication errors.
+   */
+  hasAuthenticationErrors() {
+    return this.graphqlErrors.some(
+      (e) => {
+        var _a;
+        return ((_a = e.extensions) == null ? void 0 : _a.category) === "authentication";
+      }
+    );
+  }
+  /**
+   * Get error paths.
+   */
+  getPaths() {
+    return this.graphqlErrors.map((e) => e.path);
+  }
+  /**
+   * Convert to JSON for serialization.
+   */
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      errors: this.graphqlErrors.map((e) => ({
+        message: e.message,
+        path: e.path,
+        extensions: e.extensions
+      }))
+    };
+  }
+}
+export {
+  AuthenticationError as A,
+  FairuError as F,
+  GraphQLError as G,
+  ValidationError as V
+};
+//# sourceMappingURL=FairuError-D8sSmRAa.js.map

package/dist/FairuError-D8sSmRAa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuError-D8sSmRAa.js","sources":["../src/errors/FairuError.ts"],"sourcesContent":["import type { CombinedError } from '@urql/core';\nimport type { GraphQLError as BaseGraphQLError } from 'graphql';\n\n/**\n * Base error class for all Fairu SDK errors.\n */\nexport class FairuError extends Error {\n  public readonly code?: string;\n  public readonly originalError?: Error;\n\n  constructor(message: string, code?: string, originalError?: Error) {\n    super(message);\n    this.name = 'FairuError';\n    this.code = code;\n    this.originalError = originalError;\n\n    // Maintains proper stack trace for where our error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, FairuError);\n    }\n  }\n\n  /**\n   * Create a FairuError from a urql CombinedError.\n   */\n  static fromCombinedError(error: CombinedError): FairuError {\n    // Check for GraphQL errors first\n    if (error.graphQLErrors.length > 0) {\n      const graphqlError = error.graphQLErrors[0];\n      const category = graphqlError.extensions?.category as string | undefined;\n\n      // Handle validation errors\n      if (category === 'validation') {\n        return new ValidationError(\n          graphqlError.message,\n          graphqlError.extensions?.validation as Record<string, string[]>\n        );\n      }\n\n      // Handle authentication errors\n      if (category === 'authentication') {\n        return new AuthenticationError(graphqlError.message);\n      }\n\n      // Return generic GraphQL error\n      return new GraphQLError(error.graphQLErrors);\n    }\n\n    // Handle network errors\n    if (error.networkError) {\n      return new FairuError(\n        `Network error: ${error.networkError.message}`,\n        'NETWORK_ERROR',\n        error.networkError\n      );\n    }\n\n    // Fallback to generic error\n    return new FairuError(error.message);\n  }\n\n  /**\n   * Check if this error is a network error.\n   */\n  isNetworkError(): boolean {\n    return this.code === 'NETWORK_ERROR';\n  }\n\n  /**\n   * Convert error to a plain object for serialization.\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n    };\n  }\n}\n\n/**\n * Error class for validation failures.\n */\nexport class ValidationError extends FairuError {\n  public readonly validationErrors: Record<string, string[]>;\n\n  constructor(\n    message: string,\n    validationErrors: Record<string, string[]> = {}\n  ) {\n    super(message, 'VALIDATION_ERROR');\n    this.name = 'ValidationError';\n    this.validationErrors = validationErrors;\n  }\n\n  /**\n   * Get errors for a specific field.\n   */\n  getFieldErrors(field: string): string[] {\n    return this.validationErrors[field] ?? [];\n  }\n\n  /**\n   * Check if a specific field has errors.\n   */\n  hasFieldError(field: string): boolean {\n    return field in this.validationErrors;\n  }\n\n  /**\n   * Get all field names with errors.\n   */\n  getFields(): string[] {\n    return Object.keys(this.validationErrors);\n  }\n\n  /**\n   * Get the first error message for a field.\n   */\n  getFirstFieldError(field: string): string | undefined {\n    return this.validationErrors[field]?.[0];\n  }\n\n  /**\n   * Get all error messages as a flat array.\n   */\n  getAllMessages(): string[] {\n    return Object.values(this.validationErrors).flat();\n  }\n\n  /**\n   * Check if there are any validation errors.\n   */\n  hasErrors(): boolean {\n    return Object.keys(this.validationErrors).length > 0;\n  }\n\n  /**\n   * Convert to JSON for serialization.\n   */\n  override toJSON(): Record<string, unknown> {\n    return {\n      ...super.toJSON(),\n      validationErrors: this.validationErrors,\n    };\n  }\n}\n\n/**\n * Error class for authentication failures.\n */\nexport class AuthenticationError extends FairuError {\n  constructor(message: string = 'Invalid or missing API token') {\n    super(message, 'AUTHENTICATION_ERROR');\n    this.name = 'AuthenticationError';\n  }\n\n  /**\n   * Check if this is an expired token error.\n   */\n  isTokenExpired(): boolean {\n    return this.message.toLowerCase().includes('expired');\n  }\n\n  /**\n   * Check if this is a missing token error.\n   */\n  isMissingToken(): boolean {\n    return this.message.toLowerCase().includes('missing');\n  }\n}\n\n/**\n * Error class for GraphQL-specific errors.\n */\nexport class GraphQLError extends FairuError {\n  public readonly graphqlErrors: readonly BaseGraphQLError[];\n\n  constructor(errors: readonly BaseGraphQLError[]) {\n    const messages = errors.map((e) => e.message).join('; ');\n    super(messages, 'GRAPHQL_ERROR');\n    this.name = 'GraphQLError';\n    this.graphqlErrors = errors;\n  }\n\n  /**\n   * Get the first GraphQL error.\n   */\n  getFirstError(): BaseGraphQLError | undefined {\n    return this.graphqlErrors[0];\n  }\n\n  /**\n   * Get all GraphQL errors.\n   */\n  getErrors(): readonly BaseGraphQLError[] {\n    return this.graphqlErrors;\n  }\n\n  /**\n   * Check if any errors are validation errors.\n   */\n  hasValidationErrors(): boolean {\n    return this.graphqlErrors.some(\n      (e) => e.extensions?.category === 'validation'\n    );\n  }\n\n  /**\n   * Get validation errors as a record of field names to error messages.\n   */\n  getValidationErrors(): Record<string, string[]> {\n    const validationErrors: Record<string, string[]> = {};\n\n    for (const error of this.graphqlErrors) {\n      if (error.extensions?.validation) {\n        Object.assign(validationErrors, error.extensions.validation);\n      }\n    }\n\n    return validationErrors;\n  }\n\n  /**\n   * Check if any errors are authentication errors.\n   */\n  hasAuthenticationErrors(): boolean {\n    return this.graphqlErrors.some(\n      (e) => e.extensions?.category === 'authentication'\n    );\n  }\n\n  /**\n   * Get error paths.\n   */\n  getPaths(): (readonly (string | number)[] | undefined)[] {\n    return this.graphqlErrors.map((e) => e.path);\n  }\n\n  /**\n   * Convert to JSON for serialization.\n   */\n  override toJSON(): Record<string, unknown> {\n    return {\n      ...super.toJSON(),\n      errors: this.graphqlErrors.map((e) => ({\n        message: e.message,\n        path: e.path,\n        extensions: e.extensions,\n      })),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/FairuError-DWH_Nwk0.cjs

@@ -0,0 +1,213 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class FairuError extends Error {
+  constructor(message, code, originalError) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "originalError");
+    this.name = "FairuError";
+    this.code = code;
+    this.originalError = originalError;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, FairuError);
+    }
+  }
+  /**
+   * Create a FairuError from a urql CombinedError.
+   */
+  static fromCombinedError(error) {
+    var _a, _b;
+    if (error.graphQLErrors.length > 0) {
+      const graphqlError = error.graphQLErrors[0];
+      const category = (_a = graphqlError.extensions) == null ? void 0 : _a.category;
+      if (category === "validation") {
+        return new ValidationError(
+          graphqlError.message,
+          (_b = graphqlError.extensions) == null ? void 0 : _b.validation
+        );
+      }
+      if (category === "authentication") {
+        return new AuthenticationError(graphqlError.message);
+      }
+      return new GraphQLError(error.graphQLErrors);
+    }
+    if (error.networkError) {
+      return new FairuError(
+        `Network error: ${error.networkError.message}`,
+        "NETWORK_ERROR",
+        error.networkError
+      );
+    }
+    return new FairuError(error.message);
+  }
+  /**
+   * Check if this error is a network error.
+   */
+  isNetworkError() {
+    return this.code === "NETWORK_ERROR";
+  }
+  /**
+   * Convert error to a plain object for serialization.
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code
+    };
+  }
+}
+class ValidationError extends FairuError {
+  constructor(message, validationErrors = {}) {
+    super(message, "VALIDATION_ERROR");
+    __publicField(this, "validationErrors");
+    this.name = "ValidationError";
+    this.validationErrors = validationErrors;
+  }
+  /**
+   * Get errors for a specific field.
+   */
+  getFieldErrors(field) {
+    return this.validationErrors[field] ?? [];
+  }
+  /**
+   * Check if a specific field has errors.
+   */
+  hasFieldError(field) {
+    return field in this.validationErrors;
+  }
+  /**
+   * Get all field names with errors.
+   */
+  getFields() {
+    return Object.keys(this.validationErrors);
+  }
+  /**
+   * Get the first error message for a field.
+   */
+  getFirstFieldError(field) {
+    var _a;
+    return (_a = this.validationErrors[field]) == null ? void 0 : _a[0];
+  }
+  /**
+   * Get all error messages as a flat array.
+   */
+  getAllMessages() {
+    return Object.values(this.validationErrors).flat();
+  }
+  /**
+   * Check if there are any validation errors.
+   */
+  hasErrors() {
+    return Object.keys(this.validationErrors).length > 0;
+  }
+  /**
+   * Convert to JSON for serialization.
+   */
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      validationErrors: this.validationErrors
+    };
+  }
+}
+class AuthenticationError extends FairuError {
+  constructor(message = "Invalid or missing API token") {
+    super(message, "AUTHENTICATION_ERROR");
+    this.name = "AuthenticationError";
+  }
+  /**
+   * Check if this is an expired token error.
+   */
+  isTokenExpired() {
+    return this.message.toLowerCase().includes("expired");
+  }
+  /**
+   * Check if this is a missing token error.
+   */
+  isMissingToken() {
+    return this.message.toLowerCase().includes("missing");
+  }
+}
+class GraphQLError extends FairuError {
+  constructor(errors) {
+    const messages = errors.map((e) => e.message).join("; ");
+    super(messages, "GRAPHQL_ERROR");
+    __publicField(this, "graphqlErrors");
+    this.name = "GraphQLError";
+    this.graphqlErrors = errors;
+  }
+  /**
+   * Get the first GraphQL error.
+   */
+  getFirstError() {
+    return this.graphqlErrors[0];
+  }
+  /**
+   * Get all GraphQL errors.
+   */
+  getErrors() {
+    return this.graphqlErrors;
+  }
+  /**
+   * Check if any errors are validation errors.
+   */
+  hasValidationErrors() {
+    return this.graphqlErrors.some(
+      (e) => {
+        var _a;
+        return ((_a = e.extensions) == null ? void 0 : _a.category) === "validation";
+      }
+    );
+  }
+  /**
+   * Get validation errors as a record of field names to error messages.
+   */
+  getValidationErrors() {
+    var _a;
+    const validationErrors = {};
+    for (const error of this.graphqlErrors) {
+      if ((_a = error.extensions) == null ? void 0 : _a.validation) {
+        Object.assign(validationErrors, error.extensions.validation);
+      }
+    }
+    return validationErrors;
+  }
+  /**
+   * Check if any errors are authentication errors.
+   */
+  hasAuthenticationErrors() {
+    return this.graphqlErrors.some(
+      (e) => {
+        var _a;
+        return ((_a = e.extensions) == null ? void 0 : _a.category) === "authentication";
+      }
+    );
+  }
+  /**
+   * Get error paths.
+   */
+  getPaths() {
+    return this.graphqlErrors.map((e) => e.path);
+  }
+  /**
+   * Convert to JSON for serialization.
+   */
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      errors: this.graphqlErrors.map((e) => ({
+        message: e.message,
+        path: e.path,
+        extensions: e.extensions
+      }))
+    };
+  }
+}
+exports.AuthenticationError = AuthenticationError;
+exports.FairuError = FairuError;
+exports.GraphQLError = GraphQLError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=FairuError-DWH_Nwk0.cjs.map

package/dist/FairuError-DWH_Nwk0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuError-DWH_Nwk0.cjs","sources":["../src/errors/FairuError.ts"],"sourcesContent":["import type { CombinedError } from '@urql/core';\nimport type { GraphQLError as BaseGraphQLError } from 'graphql';\n\n/**\n * Base error class for all Fairu SDK errors.\n */\nexport class FairuError extends Error {\n  public readonly code?: string;\n  public readonly originalError?: Error;\n\n  constructor(message: string, code?: string, originalError?: Error) {\n    super(message);\n    this.name = 'FairuError';\n    this.code = code;\n    this.originalError = originalError;\n\n    // Maintains proper stack trace for where our error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, FairuError);\n    }\n  }\n\n  /**\n   * Create a FairuError from a urql CombinedError.\n   */\n  static fromCombinedError(error: CombinedError): FairuError {\n    // Check for GraphQL errors first\n    if (error.graphQLErrors.length > 0) {\n      const graphqlError = error.graphQLErrors[0];\n      const category = graphqlError.extensions?.category as string | undefined;\n\n      // Handle validation errors\n      if (category === 'validation') {\n        return new ValidationError(\n          graphqlError.message,\n          graphqlError.extensions?.validation as Record<string, string[]>\n        );\n      }\n\n      // Handle authentication errors\n      if (category === 'authentication') {\n        return new AuthenticationError(graphqlError.message);\n      }\n\n      // Return generic GraphQL error\n      return new GraphQLError(error.graphQLErrors);\n    }\n\n    // Handle network errors\n    if (error.networkError) {\n      return new FairuError(\n        `Network error: ${error.networkError.message}`,\n        'NETWORK_ERROR',\n        error.networkError\n      );\n    }\n\n    // Fallback to generic error\n    return new FairuError(error.message);\n  }\n\n  /**\n   * Check if this error is a network error.\n   */\n  isNetworkError(): boolean {\n    return this.code === 'NETWORK_ERROR';\n  }\n\n  /**\n   * Convert error to a plain object for serialization.\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n    };\n  }\n}\n\n/**\n * Error class for validation failures.\n */\nexport class ValidationError extends FairuError {\n  public readonly validationErrors: Record<string, string[]>;\n\n  constructor(\n    message: string,\n    validationErrors: Record<string, string[]> = {}\n  ) {\n    super(message, 'VALIDATION_ERROR');\n    this.name = 'ValidationError';\n    this.validationErrors = validationErrors;\n  }\n\n  /**\n   * Get errors for a specific field.\n   */\n  getFieldErrors(field: string): string[] {\n    return this.validationErrors[field] ?? [];\n  }\n\n  /**\n   * Check if a specific field has errors.\n   */\n  hasFieldError(field: string): boolean {\n    return field in this.validationErrors;\n  }\n\n  /**\n   * Get all field names with errors.\n   */\n  getFields(): string[] {\n    return Object.keys(this.validationErrors);\n  }\n\n  /**\n   * Get the first error message for a field.\n   */\n  getFirstFieldError(field: string): string | undefined {\n    return this.validationErrors[field]?.[0];\n  }\n\n  /**\n   * Get all error messages as a flat array.\n   */\n  getAllMessages(): string[] {\n    return Object.values(this.validationErrors).flat();\n  }\n\n  /**\n   * Check if there are any validation errors.\n   */\n  hasErrors(): boolean {\n    return Object.keys(this.validationErrors).length > 0;\n  }\n\n  /**\n   * Convert to JSON for serialization.\n   */\n  override toJSON(): Record<string, unknown> {\n    return {\n      ...super.toJSON(),\n      validationErrors: this.validationErrors,\n    };\n  }\n}\n\n/**\n * Error class for authentication failures.\n */\nexport class AuthenticationError extends FairuError {\n  constructor(message: string = 'Invalid or missing API token') {\n    super(message, 'AUTHENTICATION_ERROR');\n    this.name = 'AuthenticationError';\n  }\n\n  /**\n   * Check if this is an expired token error.\n   */\n  isTokenExpired(): boolean {\n    return this.message.toLowerCase().includes('expired');\n  }\n\n  /**\n   * Check if this is a missing token error.\n   */\n  isMissingToken(): boolean {\n    return this.message.toLowerCase().includes('missing');\n  }\n}\n\n/**\n * Error class for GraphQL-specific errors.\n */\nexport class GraphQLError extends FairuError {\n  public readonly graphqlErrors: readonly BaseGraphQLError[];\n\n  constructor(errors: readonly BaseGraphQLError[]) {\n    const messages = errors.map((e) => e.message).join('; ');\n    super(messages, 'GRAPHQL_ERROR');\n    this.name = 'GraphQLError';\n    this.graphqlErrors = errors;\n  }\n\n  /**\n   * Get the first GraphQL error.\n   */\n  getFirstError(): BaseGraphQLError | undefined {\n    return this.graphqlErrors[0];\n  }\n\n  /**\n   * Get all GraphQL errors.\n   */\n  getErrors(): readonly BaseGraphQLError[] {\n    return this.graphqlErrors;\n  }\n\n  /**\n   * Check if any errors are validation errors.\n   */\n  hasValidationErrors(): boolean {\n    return this.graphqlErrors.some(\n      (e) => e.extensions?.category === 'validation'\n    );\n  }\n\n  /**\n   * Get validation errors as a record of field names to error messages.\n   */\n  getValidationErrors(): Record<string, string[]> {\n    const validationErrors: Record<string, string[]> = {};\n\n    for (const error of this.graphqlErrors) {\n      if (error.extensions?.validation) {\n        Object.assign(validationErrors, error.extensions.validation);\n      }\n    }\n\n    return validationErrors;\n  }\n\n  /**\n   * Check if any errors are authentication errors.\n   */\n  hasAuthenticationErrors(): boolean {\n    return this.graphqlErrors.some(\n      (e) => e.extensions?.category === 'authentication'\n    );\n  }\n\n  /**\n   * Get error paths.\n   */\n  getPaths(): (readonly (string | number)[] | undefined)[] {\n    return this.graphqlErrors.map((e) => e.path);\n  }\n\n  /**\n   * Convert to JSON for serialization.\n   */\n  override toJSON(): Record<string, unknown> {\n    return {\n      ...super.toJSON(),\n      errors: this.graphqlErrors.map((e) => ({\n        message: e.message,\n        path: e.path,\n        extensions: e.extensions,\n      })),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/FairuProvider-BRpRddCI.cjs

@@ -0,0 +1,51 @@
+"use strict";
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const urql = require("urql");
+const FairuClient = require("./FairuClient-BUObk5LJ.cjs");
+const FairuContext = react.createContext(null);
+function FairuProvider({
+  children,
+  fragmentRegistry,
+  client: existingClient,
+  ...clientConfig
+}) {
+  const client = react.useMemo(() => {
+    if (existingClient) {
+      return existingClient;
+    }
+    return FairuClient.createFairuClient(clientConfig);
+  }, [existingClient, clientConfig.url, clientConfig.token]);
+  const fileProxyUrl = clientConfig.fileProxyUrl ?? FairuClient.DEFAULT_CONFIG.fileProxyUrl;
+  const contextValue = react.useMemo(
+    () => ({
+      client,
+      fragments: fragmentRegistry ?? null,
+      fileProxyUrl
+    }),
+    [client, fragmentRegistry, fileProxyUrl]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(FairuContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsxRuntime.jsx(urql.Provider, { value: client, children }) });
+}
+function useFairuContext() {
+  const context = react.useContext(FairuContext);
+  if (!context) {
+    throw new Error("useFairuContext must be used within a FairuProvider");
+  }
+  return context;
+}
+function useFragments() {
+  return useFairuContext().fragments;
+}
+function useFileProxyUrl() {
+  return useFairuContext().fileProxyUrl;
+}
+function useFairuClient() {
+  return useFairuContext().client;
+}
+exports.FairuProvider = FairuProvider;
+exports.useFairuClient = useFairuClient;
+exports.useFairuContext = useFairuContext;
+exports.useFileProxyUrl = useFileProxyUrl;
+exports.useFragments = useFragments;
+//# sourceMappingURL=FairuProvider-BRpRddCI.cjs.map

package/dist/FairuProvider-BRpRddCI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuProvider-BRpRddCI.cjs","sources":["../src/client/FairuProvider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useMemo,\n  type ReactNode,\n} from 'react';\nimport { Provider, type Client } from 'urql';\nimport { createFairuClient } from './FairuClient';\nimport { DEFAULT_CONFIG, type FairuClientConfig } from './config';\nimport type { FragmentRegistry } from '../fragments/FragmentRegistry';\n\n/**\n * Context value for Fairu SDK.\n */\ninterface FairuContextValue {\n  /**\n   * The urql client instance.\n   */\n  client: Client;\n\n  /**\n   * Fragment registry for custom and predefined fragments.\n   */\n  fragments: FragmentRegistry | null;\n\n  /**\n   * FileProxy base URL.\n   */\n  fileProxyUrl: string;\n}\n\nconst FairuContext = createContext<FairuContextValue | null>(null);\n\n/**\n * Props for the FairuProvider component.\n */\nexport interface FairuProviderProps extends FairuClientConfig {\n  /**\n   * Child components.\n   */\n  children: ReactNode;\n\n  /**\n   * Custom fragment registry instance.\n   */\n  fragmentRegistry?: FragmentRegistry;\n\n  /**\n   * Existing urql client to use instead of creating a new one.\n   */\n  client?: Client;\n}\n\n/**\n * React provider for Fairu SDK functionality.\n *\n * @example\n * ```tsx\n * import { FairuProvider } from '@fairu/sdk/react';\n *\n * function App() {\n *   return (\n *     <FairuProvider\n *       url=\"https://fairu.app/graphql\"\n *       token={process.env.FAIRU_TOKEN}\n *     >\n *       <YourApp />\n *     </FairuProvider>\n *   );\n * }\n * ```\n */\nexport function FairuProvider({\n  children,\n  fragmentRegistry,\n  client: existingClient,\n  ...clientConfig\n}: FairuProviderProps) {\n  // Create or use existing client\n  const client = useMemo(() => {\n    if (existingClient) {\n      return existingClient;\n    }\n    return createFairuClient(clientConfig);\n  }, [existingClient, clientConfig.url, clientConfig.token]);\n\n  // Get fileProxy URL\n  const fileProxyUrl =\n    clientConfig.fileProxyUrl ?? DEFAULT_CONFIG.fileProxyUrl;\n\n  // Context value\n  const contextValue: FairuContextValue = useMemo(\n    () => ({\n      client,\n      fragments: fragmentRegistry ?? null,\n      fileProxyUrl,\n    }),\n    [client, fragmentRegistry, fileProxyUrl]\n  );\n\n  return (\n    <FairuContext.Provider value={contextValue}>\n      <Provider value={client}>{children}</Provider>\n    </FairuContext.Provider>\n  );\n}\n\n/**\n * Hook to access the Fairu context.\n *\n * @throws Error if used outside of FairuProvider\n */\nexport function useFairuContext(): FairuContextValue {\n  const context = useContext(FairuContext);\n\n  if (!context) {\n    throw new Error('useFairuContext must be used within a FairuProvider');\n  }\n\n  return context;\n}\n\n/**\n * Hook to access the fragment registry.\n */\nexport function useFragments(): FragmentRegistry | null {\n  return useFairuContext().fragments;\n}\n\n/**\n * Hook to get the FileProxy base URL.\n */\nexport function useFileProxyUrl(): string {\n  return useFairuContext().fileProxyUrl;\n}\n\n/**\n * Hook to access the urql client directly.\n */\nexport function useFairuClient(): Client {\n  return useFairuContext().client;\n}\n"],"names":["createContext","useMemo","createFairuClient","DEFAULT_CONFIG","jsx","Provider","useContext"],"mappings":";;;;;AA+BA,MAAM,eAAeA,MAAAA,cAAwC,IAAI;AAyC1D,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,GAAG;AACL,GAAuB;AAErB,QAAM,SAASC,MAAAA,QAAQ,MAAM;AAC3B,QAAI,gBAAgB;AAClB,aAAO;AAAA,IACT;AACA,WAAOC,YAAAA,kBAAkB,YAAY;AAAA,EACvC,GAAG,CAAC,gBAAgB,aAAa,KAAK,aAAa,KAAK,CAAC;AAGzD,QAAM,eACJ,aAAa,gBAAgBC,YAAAA,eAAe;AAG9C,QAAM,eAAkCF,MAAAA;AAAAA,IACtC,OAAO;AAAA,MACL;AAAA,MACA,WAAW,oBAAoB;AAAA,MAC/B;AAAA,IAAA;AAAA,IAEF,CAAC,QAAQ,kBAAkB,YAAY;AAAA,EAAA;AAGzC,SACEG,2BAAAA,IAAC,aAAa,UAAb,EAAsB,OAAO,cAC5B,UAAAA,2BAAAA,IAACC,KAAAA,UAAA,EAAS,OAAO,QAAS,SAAA,CAAS,EAAA,CACrC;AAEJ;AAOO,SAAS,kBAAqC;AACnD,QAAM,UAAUC,MAAAA,WAAW,YAAY;AAEvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AAEA,SAAO;AACT;AAKO,SAAS,eAAwC;AACtD,SAAO,kBAAkB;AAC3B;AAKO,SAAS,kBAA0B;AACxC,SAAO,kBAAkB;AAC3B;AAKO,SAAS,iBAAyB;AACvC,SAAO,kBAAkB;AAC3B;;;;;;"}

package/dist/FairuProvider-Tc0vFo5L.js

@@ -0,0 +1,52 @@
+import { jsx } from "react/jsx-runtime";
+import { useMemo, createContext, useContext } from "react";
+import { Provider } from "urql";
+import { c as createFairuClient, D as DEFAULT_CONFIG } from "./FairuClient-CT-IPh8i.js";
+const FairuContext = createContext(null);
+function FairuProvider({
+  children,
+  fragmentRegistry,
+  client: existingClient,
+  ...clientConfig
+}) {
+  const client = useMemo(() => {
+    if (existingClient) {
+      return existingClient;
+    }
+    return createFairuClient(clientConfig);
+  }, [existingClient, clientConfig.url, clientConfig.token]);
+  const fileProxyUrl = clientConfig.fileProxyUrl ?? DEFAULT_CONFIG.fileProxyUrl;
+  const contextValue = useMemo(
+    () => ({
+      client,
+      fragments: fragmentRegistry ?? null,
+      fileProxyUrl
+    }),
+    [client, fragmentRegistry, fileProxyUrl]
+  );
+  return /* @__PURE__ */ jsx(FairuContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx(Provider, { value: client, children }) });
+}
+function useFairuContext() {
+  const context = useContext(FairuContext);
+  if (!context) {
+    throw new Error("useFairuContext must be used within a FairuProvider");
+  }
+  return context;
+}
+function useFragments() {
+  return useFairuContext().fragments;
+}
+function useFileProxyUrl() {
+  return useFairuContext().fileProxyUrl;
+}
+function useFairuClient() {
+  return useFairuContext().client;
+}
+export {
+  FairuProvider as F,
+  useFairuClient as a,
+  useFragments as b,
+  useFileProxyUrl as c,
+  useFairuContext as u
+};
+//# sourceMappingURL=FairuProvider-Tc0vFo5L.js.map

package/dist/FairuProvider-Tc0vFo5L.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuProvider-Tc0vFo5L.js","sources":["../src/client/FairuProvider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useMemo,\n  type ReactNode,\n} from 'react';\nimport { Provider, type Client } from 'urql';\nimport { createFairuClient } from './FairuClient';\nimport { DEFAULT_CONFIG, type FairuClientConfig } from './config';\nimport type { FragmentRegistry } from '../fragments/FragmentRegistry';\n\n/**\n * Context value for Fairu SDK.\n */\ninterface FairuContextValue {\n  /**\n   * The urql client instance.\n   */\n  client: Client;\n\n  /**\n   * Fragment registry for custom and predefined fragments.\n   */\n  fragments: FragmentRegistry | null;\n\n  /**\n   * FileProxy base URL.\n   */\n  fileProxyUrl: string;\n}\n\nconst FairuContext = createContext<FairuContextValue | null>(null);\n\n/**\n * Props for the FairuProvider component.\n */\nexport interface FairuProviderProps extends FairuClientConfig {\n  /**\n   * Child components.\n   */\n  children: ReactNode;\n\n  /**\n   * Custom fragment registry instance.\n   */\n  fragmentRegistry?: FragmentRegistry;\n\n  /**\n   * Existing urql client to use instead of creating a new one.\n   */\n  client?: Client;\n}\n\n/**\n * React provider for Fairu SDK functionality.\n *\n * @example\n * ```tsx\n * import { FairuProvider } from '@fairu/sdk/react';\n *\n * function App() {\n *   return (\n *     <FairuProvider\n *       url=\"https://fairu.app/graphql\"\n *       token={process.env.FAIRU_TOKEN}\n *     >\n *       <YourApp />\n *     </FairuProvider>\n *   );\n * }\n * ```\n */\nexport function FairuProvider({\n  children,\n  fragmentRegistry,\n  client: existingClient,\n  ...clientConfig\n}: FairuProviderProps) {\n  // Create or use existing client\n  const client = useMemo(() => {\n    if (existingClient) {\n      return existingClient;\n    }\n    return createFairuClient(clientConfig);\n  }, [existingClient, clientConfig.url, clientConfig.token]);\n\n  // Get fileProxy URL\n  const fileProxyUrl =\n    clientConfig.fileProxyUrl ?? DEFAULT_CONFIG.fileProxyUrl;\n\n  // Context value\n  const contextValue: FairuContextValue = useMemo(\n    () => ({\n      client,\n      fragments: fragmentRegistry ?? null,\n      fileProxyUrl,\n    }),\n    [client, fragmentRegistry, fileProxyUrl]\n  );\n\n  return (\n    <FairuContext.Provider value={contextValue}>\n      <Provider value={client}>{children}</Provider>\n    </FairuContext.Provider>\n  );\n}\n\n/**\n * Hook to access the Fairu context.\n *\n * @throws Error if used outside of FairuProvider\n */\nexport function useFairuContext(): FairuContextValue {\n  const context = useContext(FairuContext);\n\n  if (!context) {\n    throw new Error('useFairuContext must be used within a FairuProvider');\n  }\n\n  return context;\n}\n\n/**\n * Hook to access the fragment registry.\n */\nexport function useFragments(): FragmentRegistry | null {\n  return useFairuContext().fragments;\n}\n\n/**\n * Hook to get the FileProxy base URL.\n */\nexport function useFileProxyUrl(): string {\n  return useFairuContext().fileProxyUrl;\n}\n\n/**\n * Hook to access the urql client directly.\n */\nexport function useFairuClient(): Client {\n  return useFairuContext().client;\n}\n"],"names":[],"mappings":";;;;AA+BA,MAAM,eAAe,cAAwC,IAAI;AAyC1D,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,GAAG;AACL,GAAuB;AAErB,QAAM,SAAS,QAAQ,MAAM;AAC3B,QAAI,gBAAgB;AAClB,aAAO;AAAA,IACT;AACA,WAAO,kBAAkB,YAAY;AAAA,EACvC,GAAG,CAAC,gBAAgB,aAAa,KAAK,aAAa,KAAK,CAAC;AAGzD,QAAM,eACJ,aAAa,gBAAgB,eAAe;AAG9C,QAAM,eAAkC;AAAA,IACtC,OAAO;AAAA,MACL;AAAA,MACA,WAAW,oBAAoB;AAAA,MAC/B;AAAA,IAAA;AAAA,IAEF,CAAC,QAAQ,kBAAkB,YAAY;AAAA,EAAA;AAGzC,SACE,oBAAC,aAAa,UAAb,EAAsB,OAAO,cAC5B,UAAA,oBAAC,UAAA,EAAS,OAAO,QAAS,SAAA,CAAS,EAAA,CACrC;AAEJ;AAOO,SAAS,kBAAqC;AACnD,QAAM,UAAU,WAAW,YAAY;AAEvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AAEA,SAAO;AACT;AAKO,SAAS,eAAwC;AACtD,SAAO,kBAAkB;AAC3B;AAKO,SAAS,kBAA0B;AACxC,SAAO,kBAAkB;AAC3B;AAKO,SAAS,iBAAyB;AACvC,SAAO,kBAAkB;AAC3B;"}