@fluxomni/api-client 0.11.0

package/src/index.ts

@@ -0,0 +1,72 @@
+/**
+ * Fluxomni TypeScript GraphQL API Client
+ *
+ * A thin Fluxomni GraphQL transport with:
+ * - Session-aware HTTP and WebSocket setup
+ * - Direct raw GraphQL execution for automation scripts
+ * - Generated GraphQL documents and types for typed callers
+ * - Browser and server convenience helpers without a hand-written domain SDK
+ *
+ * @example
+ * ```typescript
+ * import { GraphQLClient, StateDocument } from '@fluxomni/api-client';
+ *
+ * // Create client
+ * const client = new GraphQLClient({
+ *   httpEndpoint: 'http://localhost:8001/api',
+ *   wsEndpoint: 'ws://localhost:8001/api/subscriptions',
+ * });
+ *
+ * const data = await client.executeRaw<{
+ *   routes: { allRoutes: Array<{ id: string; label?: string | null }> };
+ * }>(`
+ *   query Routes {
+ *     routes { allRoutes { id label } }
+ *   }
+ * `);
+ *
+ * // Subscribe to state changes
+ * client.subscribe({ query: StateDocument }).subscribe({
+ *   next: (result) => {
+ *     console.log('Routes updated:', result.data);
+ *   },
+ *   error: (err) => console.error(err),
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+// Low-level client
+export {
+  type AuthRole,
+  type AuthStatus,
+  type AuthUser,
+  createSessionFetch,
+  type LoginOptions,
+  type LoginResult,
+  login,
+  SESSION_COOKIE_NAME,
+} from './auth.js';
+export {
+  type ConnectionCallbacks,
+  GraphQLClient,
+  type GraphQLClientConfig,
+  type GraphQLClientLoginOptions,
+  type GraphQLClientLoginResult,
+} from './client.js';
+// Errors
+export {
+  classifyGraphQLError,
+  ClientError,
+  extractField,
+  GraphQLError,
+  type GraphQLErrorCategory,
+  type GraphQLServerError,
+  MissingDataError,
+  MissingFieldError,
+  NetworkError,
+} from './errors.js';
+// Re-export all generated types for convenience
+export * from './generated/graphql.js';
+export type { DateTime } from './scalars.js';

package/src/scalars.ts

@@ -0,0 +1,4 @@
+/**
+ * RFC3339 timestamp returned by the GraphQL `DateTime` scalar.
+ */
+export type DateTime = string;