@jayethian/axiom 0.1.0 → 0.1.2

package/src/engine/sync.ts

@@ -1,96 +0,0 @@
-import { AxiomStorageAdapter } from '../adapters';
-import { AxiomConfig, QueuedRequest } from '../types';
-
-export class SyncManager {
-  private isSyncing = false;
-
-  constructor(
-    private storage: AxiomStorageAdapter,
-    private config: AxiomConfig
-  ) {}
-
-  /**
-   * The master trigger. Call this when the OS reports network is back online.
-   */
-  public async flushQueue(): Promise<void> {
-    // Prevent overlapping syncs if the network toggles rapidly
-    if (this.isSyncing) return;
-    this.isSyncing = true;
-
-    try {
-      const pending = await this.storage.getAll();
-      
-      if (pending.length === 0) {
-        this.isSyncing = false;
-        return;
-      }
-
-      console.log(`[Axiom] Network restored. Syncing ${pending.length} queued requests...`);
-
-      // We process sequentially to maintain the order of user actions
-      for (const request of pending) {
-        await this.processRequest(request);
-      }
-      
-    } finally {
-      this.isSyncing = false;
-    }
-  }
-
-  /**
-   * Attempts to execute a single saved request.
-   */
-  private async processRequest(request: QueuedRequest): Promise<void> {
-    let reqToSync = request;
-
-    // MITIGATION 1: Just-in-Time Headers (Refresh Auth Tokens)
-    if (this.config.onBeforeSync) {
-      try {
-        reqToSync = await this.config.onBeforeSync(request);
-      } catch (error) {
-        console.error(`[Axiom] onBeforeSync failed for ${request.id}. Skipping.`);
-        return; 
-      }
-    }
-
-    try {
-      const response = await fetch(reqToSync.url, {
-        method: reqToSync.method,
-        headers: reqToSync.headers,
-        body: reqToSync.body
-      });
-
-      // If it's a success OR a permanent 400 error (like bad data), remove it.
-      if (response.ok || (response.status >= 400 && response.status < 500)) {
-        await this.storage.remove(reqToSync.id);
-        console.log(`[Axiom] Request ${reqToSync.id} synced successfully.`);
-      } else {
-        // It's a 500 Server Error. Treat as a failure and retry later.
-        await this.handleFailure(reqToSync);
-      }
-    } catch (error) {
-      // Network dropped again mid-sync.
-      await this.handleFailure(reqToSync);
-    }
-  }
-
-  /**
-   * MITIGATION 2: The Dead Letter Queue logic
-   */
-  private async handleFailure(request: QueuedRequest): Promise<void> {
-    request.retryCount += 1;
-    const maxRetries = this.config.maxRetries || 3;
-
-    if (request.retryCount >= maxRetries) {
-      console.warn(`[Axiom] Request ${request.id} failed ${maxRetries} times. Moving to Dead Letter.`);
-      await this.storage.remove(request.id);
-      
-      if (this.config.onDeadLetter) {
-        this.config.onDeadLetter(request, new Error('Max retries exceeded'));
-      }
-    } else {
-      // Save the updated retry count back to storage
-      await this.storage.save(request);
-    }
-  }
-}

package/src/index.ts

@@ -1,6 +0,0 @@
-export * from './types';
-export * from './adapters';
-export * from './adapters/memory';
-export { axiom, AxiomEngine } from './engine/fetcher';
-export { AxiomProvider } from './react/AxiomProvider';
-export { useAxiomQueue } from './react/useAxiomQueue';

package/src/react/AxiomProvider.tsx

@@ -1,57 +0,0 @@
-import React, { createContext, useContext, useEffect, useState } from 'react';
-import { axiom } from '../engine/fetcher';
-import { AxiomConfig } from '../types';
-import { AxiomStorageAdapter } from '../adapters';
-
-interface AxiomContextType {
-  isOnline: boolean;
-  forceSync: () => Promise<void>;
-}
-
-// Create a safe default context
-const AxiomContext = createContext<AxiomContextType>({
-  isOnline: true,
-  forceSync: async () => {},
-});
-
-export const AxiomProvider: React.FC<{
-  config: AxiomConfig;
-  storageAdapter?: AxiomStorageAdapter;
-  /** * A function that takes a callback, calls it whenever network state changes, 
-   * and returns an unsubscribe function.
-   */
-  networkListener: (callback: (isOnline: boolean) => void) => any;
-  children: React.ReactNode;
-}> = ({ config, storageAdapter, networkListener, children }) => {
-  const [isOnline, setIsOnline] = useState(true);
-
-  useEffect(() => {
-    // 1. Boot up the Axiom engine
-    axiom.create(config, storageAdapter);
-
-    // 2. Attach the OS-level network listener
-    const unsubscribe = networkListener((onlineStatus) => {
-      setIsOnline(onlineStatus);
-      
-      // 3. The Magic: If the internet comes back, automatically flush the queue
-      if (onlineStatus) {
-        axiom.forceSync();
-      }
-    });
-
-    // Cleanup listener on unmount
-    return () => {
-      if (typeof unsubscribe === 'function') {
-        unsubscribe();
-      }
-    };
-  }, [config, storageAdapter, networkListener]);
-
-  return (
-    <AxiomContext.Provider value={{ isOnline, forceSync: () => axiom.forceSync() }}>
-      {children}
-    </AxiomContext.Provider>
-  );
-};
-
-export const useAxiomContext = () => useContext(AxiomContext);

package/src/react/useAxiomQueue.ts

@@ -1,12 +0,0 @@
-import { useAxiomContext } from './AxiomProvider';
-
-export function useAxiomQueue() {
-  const { isOnline, forceSync } = useAxiomContext();
-
-  return {
-    /** Boolean indicating if the device currently has an active connection */
-    isOnline,
-    /** Manually trigger the background sync manager */
-    forceSync,
-  };
-}

package/src/types.ts

@@ -1,20 +0,0 @@
-export type RequestPriority = 'urgent' | 'background';
-
-export interface QueuedRequest {
-  id: string;
-  timestamp: number;
-  url: string;
-  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-  headers: Record<string, string>;
-  body?: string; 
-  priority: RequestPriority;
-  retryCount: number;
-}
-
-export interface AxiomConfig {
-  baseURL?: string;
-  defaultHeaders?: Record<string, string>;
-  maxRetries?: number;
-  onBeforeSync?: (request: QueuedRequest) => Promise<QueuedRequest>;
-  onDeadLetter?: (request: QueuedRequest, error: Error) => void;
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "jsx": "react-jsx",
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "ignoreDeprecations": "6.0"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "tests"]
-}