@bluecopa/react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './hooks/useMetric';
+export * from './hooks/useDatasetSample';
+export * from './hooks/useDataset';
+export * from './hooks/useUser';
+export * from './hooks/useInputTable';
+export * as reactQuery from '@tanstack/react-query';
+export { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.es.js

@@ -0,0 +1,11 @@
+import { X as s, W as t, _ as u, Z as r, a2 as l, Y as o, a0 as D, a1 as c } from "./index-bzN7KmNV.js";
+export {
+  s as ReactQueryDevtools,
+  t as reactQuery,
+  u as useDataset,
+  r as useDatasetSample,
+  l as useInputTable,
+  o as useMetric,
+  D as useUser,
+  c as useUserDetails
+};

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+export type { QueryHookConfig } from '../utils/hookFactory';
+/**
+ * Common query options interface that can be extended by specific hooks
+ */
+export interface BaseQueryOptions {
+    enabled?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+    retry?: number;
+    retryDelay?: (attemptIndex: number) => number;
+    onSuccess?: (data: any) => void;
+    onError?: (error: Error) => void;
+}
+export interface UseDatasetOptions extends BaseQueryOptions {
+    limit?: number;
+}
+export interface UseInputTableOptions extends BaseQueryOptions {
+    limitParams?: {
+        limit: number;
+        limitFrom: 'top' | 'bottom';
+    };
+}
+export interface UseMetricOptions {
+    enabled?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+    retry?: number;
+    retryDelay?: (attemptIndex: number) => number;
+    onSuccess?: (data: any) => void;
+    onError?: (error: Error) => void;
+}
+export interface UseUserOptions {
+    enabled?: boolean;
+    staleTime?: number;
+    gcTime?: number;
+    retry?: number;
+    retryDelay?: (attemptIndex: number) => number;
+    onSuccess?: (data: any) => void;
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAGD,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC"}

package/dist/utils/hookFactory.d.ts

@@ -0,0 +1,26 @@
+import { UseQueryResult } from '@tanstack/react-query';
+import { BaseQueryOptions } from '../utils/queryUtils';
+/**
+ * Configuration for creating a standardized query hook
+ */
+export interface QueryHookConfig<TParams, TData> {
+    /** The name of the query for the queryKey */
+    queryName: string;
+    /** Function that extracts API call from copaApi */
+    apiCall: (params: TParams) => Promise<TData>;
+    /** Function that validates and transforms parameters */
+    validateParams?: (params: TParams) => void | never;
+    /** Function that creates the query key */
+    createQueryKey: (params: TParams) => any[];
+    /** Function that determines if the query should be enabled */
+    isEnabled?: (params: TParams) => boolean;
+    /** Custom delay in milliseconds (defaults to 5000) */
+    delay?: number;
+}
+/**
+ * Factory function that creates standardized query hooks
+ * @param config - Configuration for the hook
+ * @returns A custom hook that follows the standard pattern
+ */
+export declare function createQueryHook<TParams, TData>(config: QueryHookConfig<TParams, TData>): (params: TParams, options?: BaseQueryOptions) => UseQueryResult<TData, Error>;
+//# sourceMappingURL=hookFactory.d.ts.map

package/dist/utils/hookFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookFactory.d.ts","sourceRoot":"","sources":["../../src/utils/hookFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,EAAE,KAAK;IAC7C,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,KAAK,CAAC;IACnD,0CAA0C;IAC1C,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,EAAE,CAAC;IAC3C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACzC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAC5C,MAAM,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,IAGrC,QAAQ,OAAO,EACf,UAAS,gBAAqB,KAC7B,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAmChC"}

package/dist/utils/queryUtils.d.ts

@@ -0,0 +1,44 @@
+import { UseQueryOptions } from '@tanstack/react-query';
+import { BaseQueryOptions } from '../types';
+/**
+ * Default query options used across all hooks
+ */
+export declare const DEFAULT_QUERY_OPTIONS: Required<Omit<BaseQueryOptions, 'onSuccess' | 'onError'>>;
+/**
+ * Merges provided options with default options
+ * @param options - Custom options to merge with defaults
+ * @returns Merged options object
+ */
+export declare function mergeQueryOptions<T extends BaseQueryOptions>(options?: T): Required<Omit<T, 'onSuccess' | 'onError'>> & Pick<T, 'onSuccess' | 'onError'>;
+/**
+ * Creates a standardized delay promise
+ * @param ms - Milliseconds to delay (defaults to 5000)
+ * @returns Promise that resolves after the specified delay
+ */
+export declare function createDelay(ms?: number): Promise<void>;
+/**
+ * Validates required parameters and throws an error if any are missing
+ * @param params - Object containing parameter names and values
+ * @param errorMessage - Custom error message (optional)
+ */
+export declare function validateRequiredParams(params: Record<string, any>, errorMessage?: string): void;
+/**
+ * Creates a standardized query function with common error handling and delay
+ * @param fn - The actual API function to call
+ * @param params - Parameters to validate (optional)
+ * @param delay - Delay in milliseconds (defaults to 5000)
+ * @returns Async function that can be used as queryFn
+ */
+export declare function createQueryFunction<T>(fn: () => Promise<T>, params?: Record<string, any>, delay?: number): () => Promise<T>;
+/**
+ * Builds UseQueryOptions with standardized configuration
+ * @param config - Configuration object
+ * @returns UseQueryOptions object ready for useQuery
+ */
+export declare function buildQueryOptions<T>(config: {
+    queryKey: any[];
+    queryFn: () => Promise<T>;
+    enabled?: boolean;
+    options?: BaseQueryOptions;
+}): UseQueryOptions<T, Error>;
+//# sourceMappingURL=queryUtils.d.ts.map

package/dist/utils/queryUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryUtils.d.ts","sourceRoot":"","sources":["../../src/utils/queryUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,SAAS,CAAC,CAM3F,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAC1D,OAAO,GAAE,CAAW,GACnB,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,CAK/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,KAAK,GAAE,MAAa,GACnB,MAAM,OAAO,CAAC,CAAC,CAAC,CAWlB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE;IAC3C,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,GAAG,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,CAc5B"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@bluecopa/react",
+  "version": "0.1.0",
+  "description": "Bluecopa react library with TanStack Query integration",
+  "type": "module",
+  "main": "dist/index.es.js",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:watch": "vitest --watch"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "dependencies": {
+    "@bluecopa/core": "workspace:*",
+    "@tanstack/react-query": "5.59.0",
+    "@tanstack/react-query-devtools": "5.59.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "5.9.2",
+    "vite": "5.4.0",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^2.1.2"
+  },
+  "author": "Bluecopa",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "react",
+    "react-query",
+    "tanstack",
+    "bluecopa",
+    "api",
+    "data-fetching"
+  ]
+}