@simpleapps-com/augur-server 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,65 @@
+import { NextAuthConfig } from 'next-auth';
+
+/** Base user fields shared across all Augur sites. */
+interface AugurUser {
+    id: string;
+    username: string;
+    isVerified: boolean;
+    name?: string;
+    email?: string;
+    customerId?: string | number;
+    contactId?: string | number;
+    cartHdrUid?: number;
+    token?: string;
+}
+/** Session shape returned by all Augur sites. */
+interface AugurSession {
+    user: AugurUser;
+    token?: string;
+    expires: string;
+}
+/** Site-specific callbacks the consumer must provide. */
+interface AugurAuthCallbacks {
+    /** Fetch user profile from the Augur API given the user's Joomla ID. */
+    getUserProfile: (userId: string) => Promise<AugurUser | null>;
+    /** Look up or create a cart header for the authenticated user. */
+    cartHdrLookup?: (userId: string | number, token: string, contactId: string | number, customerId: string | number) => Promise<{
+        cartHdrUid?: number;
+    } | null>;
+}
+interface CreateAuthConfigOptions {
+    /** Site-specific callbacks. */
+    callbacks: AugurAuthCallbacks;
+    /** NextAuth secret (defaults to NEXT_PUBLIC_AUTH_SECRET env var). */
+    secret?: string;
+    /** Session max age in seconds (defaults to 4 hours). */
+    maxAge?: number;
+    /** Default customer ID when profile doesn't provide one. */
+    defaultCustomerId?: string | number;
+    /** Enable NextAuth debug logging (defaults to NODE_ENV === "development"). */
+    debug?: boolean;
+}
+/**
+ * Create a NextAuth 5 configuration for an Augur ecommerce site.
+ *
+ * Each site calls this factory with its own getUserProfile and
+ * cartHdrLookup implementations. The result is passed to NextAuth().
+ *
+ * @example
+ * ```ts
+ * // auth.ts
+ * import NextAuth from "next-auth";
+ * import { createAuthConfig } from "@simpleapps-com/augur-server/auth";
+ * import { getUserProfile, cartHdrLookup } from "./lib/actions/users";
+ *
+ * export const { handlers, signIn, signOut, auth } = NextAuth(
+ *   createAuthConfig({
+ *     callbacks: { getUserProfile, cartHdrLookup },
+ *     defaultCustomerId: process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_ID,
+ *   }),
+ * );
+ * ```
+ */
+declare function createAuthConfig(options: CreateAuthConfigOptions): NextAuthConfig;
+
+export { type AugurAuthCallbacks, type AugurSession, type AugurUser, type CreateAuthConfigOptions, createAuthConfig };

package/dist/auth.js

@@ -0,0 +1,122 @@
+import "./chunk-DGUM43GV.js";
+
+// src/auth.ts
+import Credentials from "next-auth/providers/credentials";
+function createAuthConfig(options) {
+  const {
+    callbacks: siteCallbacks,
+    secret = process.env.NEXT_PUBLIC_AUTH_SECRET,
+    maxAge = 4 * 60 * 60,
+    defaultCustomerId,
+    debug = process.env.NODE_ENV === "development"
+  } = options;
+  return {
+    providers: [
+      Credentials({
+        name: "Credentials",
+        credentials: {
+          username: { label: "Username", type: "text" },
+          password: { label: "Password", type: "password" },
+          id: { label: "ID", type: "text" },
+          isVerified: { label: "Is Verified", type: "text" },
+          token: { label: "Token", type: "text" }
+        },
+        async authorize(credentials) {
+          if (!credentials) return null;
+          const { id, isVerified, username, token } = credentials;
+          return {
+            id,
+            isVerified: isVerified === "true",
+            username,
+            token
+          };
+        }
+      })
+    ],
+    callbacks: {
+      async signIn() {
+        return true;
+      },
+      async redirect({ baseUrl }) {
+        return baseUrl;
+      },
+      async session({ session, token }) {
+        try {
+          const userId = token.id;
+          const userProfile = await siteCallbacks.getUserProfile(userId);
+          const baseUser = {
+            id: userId || "",
+            username: token.username || "",
+            isVerified: token.isVerified || false
+          };
+          if (userProfile) {
+            const { email, name, customerId, contactId, id } = userProfile;
+            let cartHdrUid;
+            if (siteCallbacks.cartHdrLookup && id) {
+              const cartHdr = await siteCallbacks.cartHdrLookup(
+                id,
+                "",
+                contactId ?? "",
+                customerId ?? defaultCustomerId ?? ""
+              );
+              cartHdrUid = cartHdr?.cartHdrUid;
+            }
+            return {
+              ...session,
+              user: {
+                ...session.user,
+                ...baseUser,
+                name: name ?? session.user?.name,
+                email: email ?? session.user?.email,
+                customerId: customerId ?? defaultCustomerId,
+                contactId,
+                cartHdrUid
+              },
+              token: token.token
+            };
+          }
+          return {
+            ...session,
+            user: { ...session.user, ...baseUser },
+            token: token.token
+          };
+        } catch {
+          return {
+            ...session,
+            user: {
+              ...session.user,
+              id: token.id || "",
+              username: token.username || "",
+              isVerified: token.isVerified || false
+            },
+            token: token.token
+          };
+        }
+      },
+      async jwt({ token, user }) {
+        if (user) {
+          const typedUser = user;
+          return {
+            ...token,
+            id: typedUser.id,
+            isVerified: typedUser.isVerified,
+            username: typedUser.username,
+            token: typedUser.token
+          };
+        }
+        return token;
+      }
+    },
+    secret,
+    debug,
+    session: {
+      strategy: "jwt",
+      maxAge
+    },
+    trustHost: true
+  };
+}
+export {
+  createAuthConfig
+};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/auth.ts"],"sourcesContent":["// @simpleapps-com/augur-server/auth\n// NextAuth 5 configuration factory for Augur ecommerce sites.\n\nimport type { NextAuthConfig } from \"next-auth\";\nimport Credentials from \"next-auth/providers/credentials\";\n\n/** Base user fields shared across all Augur sites. */\nexport interface AugurUser {\n  id: string;\n  username: string;\n  isVerified: boolean;\n  name?: string;\n  email?: string;\n  customerId?: string | number;\n  contactId?: string | number;\n  cartHdrUid?: number;\n  token?: string;\n}\n\n/** Session shape returned by all Augur sites. */\nexport interface AugurSession {\n  user: AugurUser;\n  token?: string;\n  expires: string;\n}\n\n/** Site-specific callbacks the consumer must provide. */\nexport interface AugurAuthCallbacks {\n  /** Fetch user profile from the Augur API given the user's Joomla ID. */\n  getUserProfile: (userId: string) => Promise<AugurUser | null>;\n  /** Look up or create a cart header for the authenticated user. */\n  cartHdrLookup?: (\n    userId: string | number,\n    token: string,\n    contactId: string | number,\n    customerId: string | number,\n  ) => Promise<{ cartHdrUid?: number } | null>;\n}\n\nexport interface CreateAuthConfigOptions {\n  /** Site-specific callbacks. */\n  callbacks: AugurAuthCallbacks;\n  /** NextAuth secret (defaults to NEXT_PUBLIC_AUTH_SECRET env var). */\n  secret?: string;\n  /** Session max age in seconds (defaults to 4 hours). */\n  maxAge?: number;\n  /** Default customer ID when profile doesn't provide one. */\n  defaultCustomerId?: string | number;\n  /** Enable NextAuth debug logging (defaults to NODE_ENV === \"development\"). */\n  debug?: boolean;\n}\n\n/**\n * Create a NextAuth 5 configuration for an Augur ecommerce site.\n *\n * Each site calls this factory with its own getUserProfile and\n * cartHdrLookup implementations. The result is passed to NextAuth().\n *\n * @example\n * ```ts\n * // auth.ts\n * import NextAuth from \"next-auth\";\n * import { createAuthConfig } from \"@simpleapps-com/augur-server/auth\";\n * import { getUserProfile, cartHdrLookup } from \"./lib/actions/users\";\n *\n * export const { handlers, signIn, signOut, auth } = NextAuth(\n *   createAuthConfig({\n *     callbacks: { getUserProfile, cartHdrLookup },\n *     defaultCustomerId: process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_ID,\n *   }),\n * );\n * ```\n */\nexport function createAuthConfig(\n  options: CreateAuthConfigOptions,\n): NextAuthConfig {\n  const {\n    callbacks: siteCallbacks,\n    secret = process.env.NEXT_PUBLIC_AUTH_SECRET,\n    maxAge = 4 * 60 * 60,\n    defaultCustomerId,\n    debug = process.env.NODE_ENV === \"development\",\n  } = options;\n\n  return {\n    providers: [\n      Credentials({\n        name: \"Credentials\",\n        credentials: {\n          username: { label: \"Username\", type: \"text\" },\n          password: { label: \"Password\", type: \"password\" },\n          id: { label: \"ID\", type: \"text\" },\n          isVerified: { label: \"Is Verified\", type: \"text\" },\n          token: { label: \"Token\", type: \"text\" },\n        },\n        async authorize(credentials) {\n          if (!credentials) return null;\n\n          const { id, isVerified, username, token } = credentials as {\n            id: string;\n            isVerified: string;\n            username: string;\n            token: string;\n          };\n\n          return {\n            id,\n            isVerified: isVerified === \"true\",\n            username,\n            token,\n          };\n        },\n      }),\n    ],\n    callbacks: {\n      async signIn() {\n        return true;\n      },\n      async redirect({ baseUrl }) {\n        return baseUrl;\n      },\n      async session({ session, token }) {\n        try {\n          const userId = token.id as string;\n          const userProfile = await siteCallbacks.getUserProfile(userId);\n\n          const baseUser = {\n            id: userId || \"\",\n            username: (token.username as string) || \"\",\n            isVerified: (token.isVerified as boolean) || false,\n          };\n\n          if (userProfile) {\n            const { email, name, customerId, contactId, id } = userProfile;\n\n            let cartHdrUid: number | undefined;\n            if (siteCallbacks.cartHdrLookup && id) {\n              const cartHdr = await siteCallbacks.cartHdrLookup(\n                id,\n                \"\",\n                contactId ?? \"\",\n                customerId ?? defaultCustomerId ?? \"\",\n              );\n              cartHdrUid = cartHdr?.cartHdrUid;\n            }\n\n            return {\n              ...session,\n              user: {\n                ...session.user,\n                ...baseUser,\n                name: name ?? session.user?.name,\n                email: email ?? session.user?.email,\n                customerId: customerId ?? defaultCustomerId,\n                contactId,\n                cartHdrUid,\n              },\n              token: token.token as string | undefined,\n            };\n          }\n\n          return {\n            ...session,\n            user: { ...session.user, ...baseUser },\n            token: token.token as string | undefined,\n          };\n        } catch {\n          return {\n            ...session,\n            user: {\n              ...session.user,\n              id: (token.id as string) || \"\",\n              username: (token.username as string) || \"\",\n              isVerified: (token.isVerified as boolean) || false,\n            },\n            token: token.token as string | undefined,\n          };\n        }\n      },\n      async jwt({ token, user }) {\n        if (user) {\n          const typedUser = user as {\n            id: string;\n            isVerified: boolean;\n            username: string;\n            token: string;\n          };\n\n          return {\n            ...token,\n            id: typedUser.id,\n            isVerified: typedUser.isVerified,\n            username: typedUser.username,\n            token: typedUser.token,\n          };\n        }\n        return token;\n      },\n    },\n    secret,\n    debug,\n    session: {\n      strategy: \"jwt\",\n      maxAge,\n    },\n    trustHost: true,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DGUM43GV.js

@@ -0,0 +1,11 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};
+//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/chunk-DGUM43GV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+import { QueryClient, UseQueryOptions, UseSuspenseQueryOptions } from '@tanstack/react-query';
+
+declare const env: "development" | "staging" | "production";
+declare const isDev: boolean;
+declare const isStaging: boolean;
+declare const isProduction: boolean;
+
+declare function cacheGet(key: string): Promise<string | null>;
+declare function cacheSet(key: string, value: string, ttlSeconds: number): Promise<void>;
+declare function getCircuitState(): "closed" | "open";
+declare function isRedisConnected(): boolean;
+
+/**
+ * Wraps an SDK call with Redis caching.
+ *
+ * @param prefix - Redis key prefix (e.g. "mysite:")
+ * @param methodPath - Dot-separated SDK method path (used as cache key)
+ * @param method - The SDK method to call
+ * @param args - Arguments to pass to the SDK method. If the last argument
+ *   contains an `edgeCache` property (number of hours), the result is cached
+ *   in Redis for that duration. Without `edgeCache`, the call bypasses cache.
+ *
+ * @example
+ * ```ts
+ * const result = await cachedSdkCall(
+ *   "mysite:",
+ *   "items.categories.get",
+ *   augurServices.items.categories.get,
+ *   itemCategoryUid,
+ *   { edgeCache: 1 },
+ * );
+ * ```
+ */
+declare function cachedSdkCall<TResult>(prefix: string, methodPath: string, method: (...args: any[]) => Promise<TResult>, ...args: unknown[]): Promise<TResult>;
+/** Returns aggregated cache stats for monitoring endpoints. */
+declare function getCacheStats(): {
+    stats: {
+        hits: number;
+        misses: number;
+        errors: number;
+        hitRate: string;
+    };
+    topKeys: {
+        key: string;
+        hits: number;
+        misses: number;
+        avgMs: number;
+    }[];
+    recentOps: {
+        op: "HIT" | "MISS" | "SKIP" | "ERROR";
+        key: string;
+        ms: number;
+        ago: string;
+    }[];
+};
+
+/**
+ * Calls an Augur SDK method whose TypeScript signature only declares a
+ * single positional parameter (e.g. `(id: number)`) but whose runtime
+ * implementation also accepts an options/params object as a second argument
+ * (e.g. `{ edgeCache: 4 }`).
+ *
+ * This wrapper centralises the single unavoidable `as any` cast so that
+ * every call-site in the codebase stays fully type-safe.
+ *
+ * @example
+ * ```ts
+ * const result = await sdkCall(
+ *   augurServices.items.invMast.get,
+ *   invMastUid,
+ *   { edgeCache: 4 },
+ * );
+ * ```
+ */
+declare function sdkCall<TResult>(method: (...args: any[]) => Promise<TResult>, ...args: unknown[]): Promise<TResult>;
+
+/**
+ * Creates a server-side query client optimised for prefetching.
+ *
+ * - No persistence (server-only)
+ * - Longer cache times for prefetched data
+ * - No retries (fail fast on server)
+ * - No refetching (server renders are one-shot)
+ */
+declare function createServerQueryClient(): QueryClient;
+/** Singleton server query client, reused across requests. */
+declare function getServerQueryClient(): QueryClient;
+
+interface QueryOptionsConfig<TParams, TData> {
+    /** Base query key (e.g., "customer-orders") */
+    baseKey: string;
+    /** Parameters object */
+    params: TParams;
+    /** Function that returns the data */
+    queryFn: (params: TParams) => Promise<TData>;
+    /** Function to determine if query should be enabled */
+    enabledFn?: (params: TParams) => boolean;
+    /** Custom stale time in milliseconds (default: SEMI_STATIC) */
+    staleTime?: number;
+    /** Custom garbage collection time in milliseconds (default: SEMI_STATIC) */
+    gcTime?: number;
+    /** Key to exclude from query key generation */
+    excludeFromKey?: keyof TParams;
+}
+/**
+ * Creates useQuery options with consistent key generation.
+ * Filters out undefined/null/empty params from the query key.
+ */
+declare const createQueryOptions: <TParams extends Record<string, unknown>, TData>({ baseKey, params, queryFn, enabledFn, staleTime, gcTime, excludeFromKey, }: QueryOptionsConfig<TParams, TData>) => UseQueryOptions<TData>;
+/**
+ * Creates useSuspenseQuery options with consistent key generation.
+ * Same as createQueryOptions but without enabledFn (suspense queries
+ * cannot be disabled).
+ */
+declare const createSuspenseQueryOptions: <TParams extends Record<string, unknown>, TData>({ baseKey, params, queryFn, staleTime, gcTime, excludeFromKey, }: Omit<QueryOptionsConfig<TParams, TData>, "enabledFn">) => UseSuspenseQueryOptions<TData>;
+
+export { type QueryOptionsConfig, cacheGet, cacheSet, cachedSdkCall, createQueryOptions, createServerQueryClient, createSuspenseQueryOptions, env, getCacheStats, getCircuitState, getServerQueryClient, isDev, isProduction, isRedisConnected, isStaging, sdkCall };

package/dist/index.js

@@ -0,0 +1,367 @@
+import {
+  __require
+} from "./chunk-DGUM43GV.js";
+
+// src/environment.ts
+function getEnvironment() {
+  const deploymentEnv = process.env.DEPLOYMENT_ENV;
+  if (deploymentEnv === "dev") return "staging";
+  if (deploymentEnv === "live") return "production";
+  if (typeof window === "undefined") {
+    if (process.env.NODE_ENV === "development") return "development";
+    return "production";
+  }
+  const host = window.location.hostname;
+  if (host.includes("localhost") || host.includes("127.0.0.1"))
+    return "development";
+  if (host.includes("agr-hosting.dev")) return "staging";
+  return "production";
+}
+var env = getEnvironment();
+var isDev = env === "development";
+var isStaging = env === "staging";
+var isProduction = env === "production";
+
+// src/cache/redis-client.ts
+var CIRCUIT_BREAKER_THRESHOLD = 5;
+var CIRCUIT_BREAKER_RESET_MS = 6e4;
+var g = globalThis;
+if (!g.__redisState) {
+  g.__redisState = {
+    client: null,
+    consecutiveFailures: 0,
+    circuitOpenUntil: 0
+  };
+}
+var state = g.__redisState;
+var debugEnabled = isDev || isStaging;
+function log(...args) {
+  if (debugEnabled) {
+    console.log("[Redis]", ...args);
+  }
+}
+function isCircuitOpen() {
+  if (state.circuitOpenUntil === 0) return false;
+  if (Date.now() >= state.circuitOpenUntil) {
+    state.circuitOpenUntil = 0;
+    state.consecutiveFailures = 0;
+    log("Circuit breaker reset -- retrying Redis");
+    return false;
+  }
+  return true;
+}
+function recordFailure() {
+  state.consecutiveFailures++;
+  if (state.consecutiveFailures >= CIRCUIT_BREAKER_THRESHOLD) {
+    state.circuitOpenUntil = Date.now() + CIRCUIT_BREAKER_RESET_MS;
+    log(
+      `Circuit breaker OPEN -- skipping Redis for ${CIRCUIT_BREAKER_RESET_MS / 1e3}s`
+    );
+  }
+}
+function recordSuccess() {
+  state.consecutiveFailures = 0;
+}
+function getRedisUrl() {
+  const containerRedis = process.env.REDIS_SERVERS;
+  if (containerRedis) return `redis://${containerRedis}`;
+  if (isDev) return process.env.REDIS_URL_DEV;
+  if (isStaging) return process.env.REDIS_URL_STAGING;
+  return process.env.REDIS_URL_PROD;
+}
+function getClient() {
+  if (state.client) return state.client;
+  const url = getRedisUrl();
+  if (!url) {
+    log("No REDIS_URL -- cache disabled");
+    return null;
+  }
+  try {
+    const IORedis = __require("ioredis");
+    state.client = new IORedis(url, {
+      maxRetriesPerRequest: 1,
+      connectTimeout: 3e3,
+      lazyConnect: true,
+      enableOfflineQueue: false
+    });
+    state.client.on("error", (err) => {
+      log("Connection error:", err.message);
+      recordFailure();
+    });
+    state.client.on("connect", () => log("Connected"));
+    state.client.connect().catch(() => {
+    });
+    return state.client;
+  } catch {
+    log("Failed to create client (ioredis not installed?)");
+    return null;
+  }
+}
+async function cacheGet(key) {
+  if (isCircuitOpen()) return null;
+  const client = getClient();
+  if (!client) return null;
+  try {
+    const value = await client.get(key);
+    recordSuccess();
+    return value;
+  } catch {
+    recordFailure();
+    return null;
+  }
+}
+async function cacheSet(key, value, ttlSeconds) {
+  if (isCircuitOpen()) return;
+  const client = getClient();
+  if (!client) return;
+  try {
+    await client.setex(key, ttlSeconds, value);
+    recordSuccess();
+  } catch {
+    recordFailure();
+  }
+}
+function getCircuitState() {
+  return isCircuitOpen() ? "open" : "closed";
+}
+function isRedisConnected() {
+  return state.client?.status === "ready";
+}
+
+// src/cache/sdk-cache.ts
+import crypto from "crypto";
+var CACHE_ENABLED = process.env.REDIS_CACHE_ENABLED !== "false";
+var debugEnabled2 = isDev || isStaging;
+var g2 = globalThis;
+if (!g2.__sdkCacheState) {
+  g2.__sdkCacheState = { statsMap: /* @__PURE__ */ new Map(), recentOps: [] };
+}
+var { statsMap, recentOps } = g2.__sdkCacheState;
+var MAX_RECENT = 50;
+function pushRecent(op) {
+  recentOps.push(op);
+  if (recentOps.length > MAX_RECENT) recentOps.shift();
+}
+function getOrCreateStats(method) {
+  let s = statsMap.get(method);
+  if (!s) {
+    s = { hits: 0, misses: 0, errors: 0, totalMs: 0 };
+    statsMap.set(method, s);
+  }
+  return s;
+}
+function hashArgs(args) {
+  const normalized = JSON.stringify(args, (_, v) => {
+    if (v && typeof v === "object" && !Array.isArray(v)) {
+      return Object.keys(v).sort().reduce(
+        (acc, k) => {
+          acc[k] = v[k];
+          return acc;
+        },
+        {}
+      );
+    }
+    return v;
+  });
+  return crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 8);
+}
+function extractEdgeCache(args) {
+  for (let i = args.length - 1; i >= 0; i--) {
+    const arg = args[i];
+    if (arg && typeof arg === "object" && "edgeCache" in arg) {
+      return arg.edgeCache;
+    }
+  }
+  return void 0;
+}
+async function cachedSdkCall(prefix, methodPath, method, ...args) {
+  const edgeCache = extractEdgeCache(args);
+  if (!CACHE_ENABLED || edgeCache === void 0) {
+    if (debugEnabled2) {
+      console.log(`[SDK Cache] SKIP ${methodPath} (no edgeCache, REALTIME)`);
+    }
+    pushRecent({ op: "SKIP", key: methodPath, ms: 0, ts: Date.now() });
+    return method(...args);
+  }
+  const argsHash = hashArgs(args);
+  const cacheKey = `${prefix}sdk:${methodPath}:${argsHash}`;
+  const ttlSeconds = edgeCache * 3600;
+  const start = Date.now();
+  const stats = getOrCreateStats(methodPath);
+  try {
+    const cached = await cacheGet(cacheKey);
+    if (cached !== null) {
+      const parsed = JSON.parse(cached);
+      const ms2 = Date.now() - start;
+      stats.hits++;
+      stats.totalMs += ms2;
+      if (debugEnabled2) {
+        console.log(`[SDK Cache] HIT  ${methodPath}:${argsHash} (${ms2}ms)`);
+      }
+      pushRecent({
+        op: "HIT",
+        key: `${methodPath}:${argsHash}`,
+        ms: ms2,
+        ts: Date.now()
+      });
+      return parsed;
+    }
+  } catch {
+    stats.errors++;
+  }
+  const result = await method(...args);
+  const ms = Date.now() - start;
+  stats.misses++;
+  stats.totalMs += ms;
+  if (debugEnabled2) {
+    console.log(
+      `[SDK Cache] MISS ${methodPath}:${argsHash} (${ms}ms -> cached, TTL ${edgeCache}h)`
+    );
+  }
+  pushRecent({
+    op: "MISS",
+    key: `${methodPath}:${argsHash}`,
+    ms,
+    ts: Date.now()
+  });
+  try {
+    const serialized = JSON.stringify(result);
+    cacheSet(cacheKey, serialized, ttlSeconds).catch(() => {
+    });
+  } catch {
+  }
+  return result;
+}
+function formatAgo(ms) {
+  if (ms < 1e3) return "<1s";
+  const s = Math.floor(ms / 1e3);
+  if (s < 60) return `${s}s ago`;
+  const m = Math.floor(s / 60);
+  return `${m}m ago`;
+}
+function getCacheStats() {
+  let totalHits = 0;
+  let totalMisses = 0;
+  let totalErrors = 0;
+  const topKeys = [];
+  statsMap.forEach((s, key) => {
+    totalHits += s.hits;
+    totalMisses += s.misses;
+    totalErrors += s.errors;
+    const total2 = s.hits + s.misses;
+    topKeys.push({
+      key,
+      hits: s.hits,
+      misses: s.misses,
+      avgMs: total2 > 0 ? Math.round(s.totalMs / total2) : 0
+    });
+  });
+  topKeys.sort((a, b) => b.hits - a.hits);
+  const total = totalHits + totalMisses;
+  const hitRate = total > 0 ? (totalHits / total * 100).toFixed(1) + "%" : "0%";
+  const now = Date.now();
+  const recent = recentOps.slice(-20).reverse().map((op) => ({
+    op: op.op,
+    key: op.key,
+    ms: op.ms,
+    ago: formatAgo(now - op.ts)
+  }));
+  return {
+    stats: { hits: totalHits, misses: totalMisses, errors: totalErrors, hitRate },
+    topKeys: topKeys.slice(0, 15),
+    recentOps: recent
+  };
+}
+
+// src/sdk-call.ts
+async function sdkCall(method, ...args) {
+  return method(...args);
+}
+
+// src/server-query-client.ts
+import { QueryClient } from "@tanstack/react-query";
+import { CACHE_CONFIG } from "@simpleapps-com/augur-utils";
+function createServerQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: CACHE_CONFIG.STATIC.staleTime,
+        gcTime: CACHE_CONFIG.STATIC.staleTime,
+        retry: 0,
+        refetchOnMount: false,
+        refetchOnWindowFocus: false,
+        refetchOnReconnect: false
+      }
+    }
+  });
+}
+var serverQueryClient = void 0;
+function getServerQueryClient() {
+  if (!serverQueryClient) {
+    serverQueryClient = createServerQueryClient();
+  }
+  return serverQueryClient;
+}
+
+// src/query-options-helper.ts
+import { CACHE_CONFIG as CACHE_CONFIG2 } from "@simpleapps-com/augur-utils";
+var createQueryOptions = ({
+  baseKey,
+  params,
+  queryFn,
+  enabledFn,
+  staleTime = CACHE_CONFIG2.SEMI_STATIC.staleTime,
+  gcTime = CACHE_CONFIG2.SEMI_STATIC.gcTime,
+  excludeFromKey
+}) => {
+  const paramEntries = Object.entries(params).filter(([key, value]) => {
+    if (excludeFromKey && key === excludeFromKey) return false;
+    return value !== void 0 && value !== null && value !== "";
+  }).map(([key, value]) => `${key}: ${value}`);
+  const queryKey = [baseKey, ...paramEntries];
+  return {
+    queryKey,
+    queryFn: () => queryFn(params),
+    enabled: enabledFn ? enabledFn(params) : true,
+    staleTime,
+    gcTime
+  };
+};
+var createSuspenseQueryOptions = ({
+  baseKey,
+  params,
+  queryFn,
+  staleTime = CACHE_CONFIG2.SEMI_STATIC.staleTime,
+  gcTime = CACHE_CONFIG2.SEMI_STATIC.gcTime,
+  excludeFromKey
+}) => {
+  const paramEntries = Object.entries(params).filter(([key, value]) => {
+    if (excludeFromKey && key === excludeFromKey) return false;
+    return value !== void 0 && value !== null && value !== "";
+  }).map(([key, value]) => `${key}: ${value}`);
+  const queryKey = [baseKey, ...paramEntries];
+  return {
+    queryKey,
+    queryFn: () => queryFn(params),
+    staleTime,
+    gcTime
+  };
+};
+export {
+  cacheGet,
+  cacheSet,
+  cachedSdkCall,
+  createQueryOptions,
+  createServerQueryClient,
+  createSuspenseQueryOptions,
+  env,
+  getCacheStats,
+  getCircuitState,
+  getServerQueryClient,
+  isDev,
+  isProduction,
+  isRedisConnected,
+  isStaging,
+  sdkCall
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/environment.ts","../src/cache/redis-client.ts","../src/cache/sdk-cache.ts","../src/sdk-call.ts","../src/server-query-client.ts","../src/query-options-helper.ts"],"sourcesContent":["/**\n * Environment detection that works across server, client, and containers.\n *\n * Priority:\n * 1. DEPLOYMENT_ENV (\"dev\" → staging, \"live\" → production)\n * 2. Server-side NODE_ENV fallback\n * 3. Client-side hostname detection\n */\nfunction getEnvironment(): \"development\" | \"staging\" | \"production\" {\n  const deploymentEnv = process.env.DEPLOYMENT_ENV;\n  if (deploymentEnv === \"dev\") return \"staging\";\n  if (deploymentEnv === \"live\") return \"production\";\n\n  if (typeof window === \"undefined\") {\n    if (process.env.NODE_ENV === \"development\") return \"development\";\n    return \"production\";\n  }\n\n  const host = window.location.hostname;\n  if (host.includes(\"localhost\") || host.includes(\"127.0.0.1\"))\n    return \"development\";\n  if (host.includes(\"agr-hosting.dev\")) return \"staging\";\n  return \"production\";\n}\n\nexport const env = getEnvironment();\nexport const isDev = env === \"development\";\nexport const isStaging = env === \"staging\";\nexport const isProduction = env === \"production\";\n","import type Redis from \"ioredis\";\nimport { isDev, isStaging } from \"../environment\";\n\nconst CIRCUIT_BREAKER_THRESHOLD = 5;\nconst CIRCUIT_BREAKER_RESET_MS = 60_000;\n\ninterface RedisGlobalState {\n  client: Redis | null;\n  consecutiveFailures: number;\n  circuitOpenUntil: number;\n}\n\nconst g = globalThis as unknown as { __redisState?: RedisGlobalState };\nif (!g.__redisState) {\n  g.__redisState = {\n    client: null,\n    consecutiveFailures: 0,\n    circuitOpenUntil: 0,\n  };\n}\nconst state = g.__redisState;\n\nconst debugEnabled = isDev || isStaging;\n\nfunction log(...args: unknown[]) {\n  if (debugEnabled) {\n    console.log(\"[Redis]\", ...args);\n  }\n}\n\nfunction isCircuitOpen(): boolean {\n  if (state.circuitOpenUntil === 0) return false;\n  if (Date.now() >= state.circuitOpenUntil) {\n    state.circuitOpenUntil = 0;\n    state.consecutiveFailures = 0;\n    log(\"Circuit breaker reset -- retrying Redis\");\n    return false;\n  }\n  return true;\n}\n\nfunction recordFailure() {\n  state.consecutiveFailures++;\n  if (state.consecutiveFailures >= CIRCUIT_BREAKER_THRESHOLD) {\n    state.circuitOpenUntil = Date.now() + CIRCUIT_BREAKER_RESET_MS;\n    log(\n      `Circuit breaker OPEN -- skipping Redis for ${CIRCUIT_BREAKER_RESET_MS / 1000}s`,\n    );\n  }\n}\n\nfunction recordSuccess() {\n  state.consecutiveFailures = 0;\n}\n\nfunction getRedisUrl(): string | undefined {\n  const containerRedis = process.env.REDIS_SERVERS;\n  if (containerRedis) return `redis://${containerRedis}`;\n\n  if (isDev) return process.env.REDIS_URL_DEV;\n  if (isStaging) return process.env.REDIS_URL_STAGING;\n  return process.env.REDIS_URL_PROD;\n}\n\nfunction getClient(): Redis | null {\n  if (state.client) return state.client;\n\n  const url = getRedisUrl();\n  if (!url) {\n    log(\"No REDIS_URL -- cache disabled\");\n    return null;\n  }\n\n  try {\n    // Dynamic import at module level isn't possible, so we require ioredis\n    // at runtime. It's an optional peer dep -- if not installed, cache is\n    // silently disabled.\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const IORedis = require(\"ioredis\") as typeof import(\"ioredis\").default;\n\n    state.client = new IORedis(url, {\n      maxRetriesPerRequest: 1,\n      connectTimeout: 3000,\n      lazyConnect: true,\n      enableOfflineQueue: false,\n    });\n\n    state.client.on(\"error\", (err: Error) => {\n      log(\"Connection error:\", err.message);\n      recordFailure();\n    });\n\n    state.client.on(\"connect\", () => log(\"Connected\"));\n\n    state.client.connect().catch(() => {\n      /* handled by error event */\n    });\n\n    return state.client;\n  } catch {\n    log(\"Failed to create client (ioredis not installed?)\");\n    return null;\n  }\n}\n\nexport async function cacheGet(key: string): Promise<string | null> {\n  if (isCircuitOpen()) return null;\n\n  const client = getClient();\n  if (!client) return null;\n\n  try {\n    const value = await client.get(key);\n    recordSuccess();\n    return value;\n  } catch {\n    recordFailure();\n    return null;\n  }\n}\n\nexport async function cacheSet(\n  key: string,\n  value: string,\n  ttlSeconds: number,\n): Promise<void> {\n  if (isCircuitOpen()) return;\n\n  const client = getClient();\n  if (!client) return;\n\n  try {\n    await client.setex(key, ttlSeconds, value);\n    recordSuccess();\n  } catch {\n    recordFailure();\n  }\n}\n\nexport function getCircuitState(): \"closed\" | \"open\" {\n  return isCircuitOpen() ? \"open\" : \"closed\";\n}\n\nexport function isRedisConnected(): boolean {\n  return state.client?.status === \"ready\";\n}\n","import crypto from \"crypto\";\nimport { cacheGet, cacheSet } from \"./redis-client\";\nimport { isDev, isStaging } from \"../environment\";\n\nconst CACHE_ENABLED = process.env.REDIS_CACHE_ENABLED !== \"false\";\nconst debugEnabled = isDev || isStaging;\n\ninterface MethodStats {\n  hits: number;\n  misses: number;\n  errors: number;\n  totalMs: number;\n}\n\ninterface RecentOp {\n  op: \"HIT\" | \"MISS\" | \"SKIP\" | \"ERROR\";\n  key: string;\n  ms: number;\n  ts: number;\n}\n\ninterface CacheGlobalState {\n  statsMap: Map<string, MethodStats>;\n  recentOps: RecentOp[];\n}\n\nconst g = globalThis as unknown as { __sdkCacheState?: CacheGlobalState };\nif (!g.__sdkCacheState) {\n  g.__sdkCacheState = { statsMap: new Map(), recentOps: [] };\n}\nconst { statsMap, recentOps } = g.__sdkCacheState;\n\nconst MAX_RECENT = 50;\n\nfunction pushRecent(op: RecentOp) {\n  recentOps.push(op);\n  if (recentOps.length > MAX_RECENT) recentOps.shift();\n}\n\nfunction getOrCreateStats(method: string): MethodStats {\n  let s = statsMap.get(method);\n  if (!s) {\n    s = { hits: 0, misses: 0, errors: 0, totalMs: 0 };\n    statsMap.set(method, s);\n  }\n  return s;\n}\n\nfunction hashArgs(args: unknown[]): string {\n  const normalized = JSON.stringify(args, (_, v) => {\n    if (v && typeof v === \"object\" && !Array.isArray(v)) {\n      return Object.keys(v)\n        .sort()\n        .reduce(\n          (acc, k) => {\n            acc[k] = v[k];\n            return acc;\n          },\n          {} as Record<string, unknown>,\n        );\n    }\n    return v;\n  });\n  return crypto\n    .createHash(\"sha256\")\n    .update(normalized)\n    .digest(\"hex\")\n    .slice(0, 8);\n}\n\nfunction extractEdgeCache(args: unknown[]): number | undefined {\n  for (let i = args.length - 1; i >= 0; i--) {\n    const arg = args[i];\n    if (arg && typeof arg === \"object\" && \"edgeCache\" in arg) {\n      return (arg as { edgeCache: number }).edgeCache;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Wraps an SDK call with Redis caching.\n *\n * @param prefix - Redis key prefix (e.g. \"mysite:\")\n * @param methodPath - Dot-separated SDK method path (used as cache key)\n * @param method - The SDK method to call\n * @param args - Arguments to pass to the SDK method. If the last argument\n *   contains an `edgeCache` property (number of hours), the result is cached\n *   in Redis for that duration. Without `edgeCache`, the call bypasses cache.\n *\n * @example\n * ```ts\n * const result = await cachedSdkCall(\n *   \"mysite:\",\n *   \"items.categories.get\",\n *   augurServices.items.categories.get,\n *   itemCategoryUid,\n *   { edgeCache: 1 },\n * );\n * ```\n */\nexport async function cachedSdkCall<TResult>(\n  prefix: string,\n  methodPath: string,\n  method: (...args: any[]) => Promise<TResult>,\n  ...args: unknown[]\n): Promise<TResult> {\n  const edgeCache = extractEdgeCache(args);\n\n  if (!CACHE_ENABLED || edgeCache === undefined) {\n    if (debugEnabled) {\n      console.log(`[SDK Cache] SKIP ${methodPath} (no edgeCache, REALTIME)`);\n    }\n    pushRecent({ op: \"SKIP\", key: methodPath, ms: 0, ts: Date.now() });\n    return method(...args);\n  }\n\n  const argsHash = hashArgs(args);\n  const cacheKey = `${prefix}sdk:${methodPath}:${argsHash}`;\n  const ttlSeconds = edgeCache * 3600;\n  const start = Date.now();\n  const stats = getOrCreateStats(methodPath);\n\n  try {\n    const cached = await cacheGet(cacheKey);\n    if (cached !== null) {\n      const parsed = JSON.parse(cached);\n      const ms = Date.now() - start;\n      stats.hits++;\n      stats.totalMs += ms;\n      if (debugEnabled) {\n        console.log(`[SDK Cache] HIT  ${methodPath}:${argsHash} (${ms}ms)`);\n      }\n      pushRecent({\n        op: \"HIT\",\n        key: `${methodPath}:${argsHash}`,\n        ms,\n        ts: Date.now(),\n      });\n      return parsed as TResult;\n    }\n  } catch {\n    stats.errors++;\n  }\n\n  const result = await method(...args);\n  const ms = Date.now() - start;\n  stats.misses++;\n  stats.totalMs += ms;\n\n  if (debugEnabled) {\n    console.log(\n      `[SDK Cache] MISS ${methodPath}:${argsHash} (${ms}ms -> cached, TTL ${edgeCache}h)`,\n    );\n  }\n  pushRecent({\n    op: \"MISS\",\n    key: `${methodPath}:${argsHash}`,\n    ms,\n    ts: Date.now(),\n  });\n\n  try {\n    const serialized = JSON.stringify(result);\n    cacheSet(cacheKey, serialized, ttlSeconds).catch(() => {\n      /* swallow */\n    });\n  } catch {\n    // Non-serializable result -- skip caching\n  }\n\n  return result;\n}\n\nfunction formatAgo(ms: number): string {\n  if (ms < 1000) return \"<1s\";\n  const s = Math.floor(ms / 1000);\n  if (s < 60) return `${s}s ago`;\n  const m = Math.floor(s / 60);\n  return `${m}m ago`;\n}\n\n/** Returns aggregated cache stats for monitoring endpoints. */\nexport function getCacheStats() {\n  let totalHits = 0;\n  let totalMisses = 0;\n  let totalErrors = 0;\n\n  const topKeys: {\n    key: string;\n    hits: number;\n    misses: number;\n    avgMs: number;\n  }[] = [];\n\n  statsMap.forEach((s, key) => {\n    totalHits += s.hits;\n    totalMisses += s.misses;\n    totalErrors += s.errors;\n    const total = s.hits + s.misses;\n    topKeys.push({\n      key,\n      hits: s.hits,\n      misses: s.misses,\n      avgMs: total > 0 ? Math.round(s.totalMs / total) : 0,\n    });\n  });\n\n  topKeys.sort((a, b) => b.hits - a.hits);\n\n  const total = totalHits + totalMisses;\n  const hitRate =\n    total > 0 ? ((totalHits / total) * 100).toFixed(1) + \"%\" : \"0%\";\n\n  const now = Date.now();\n  const recent = recentOps\n    .slice(-20)\n    .reverse()\n    .map((op) => ({\n      op: op.op,\n      key: op.key,\n      ms: op.ms,\n      ago: formatAgo(now - op.ts),\n    }));\n\n  return {\n    stats: { hits: totalHits, misses: totalMisses, errors: totalErrors, hitRate },\n    topKeys: topKeys.slice(0, 15),\n    recentOps: recent,\n  };\n}\n","/**\n * Calls an Augur SDK method whose TypeScript signature only declares a\n * single positional parameter (e.g. `(id: number)`) but whose runtime\n * implementation also accepts an options/params object as a second argument\n * (e.g. `{ edgeCache: 4 }`).\n *\n * This wrapper centralises the single unavoidable `as any` cast so that\n * every call-site in the codebase stays fully type-safe.\n *\n * @example\n * ```ts\n * const result = await sdkCall(\n *   augurServices.items.invMast.get,\n *   invMastUid,\n *   { edgeCache: 4 },\n * );\n * ```\n */\nexport async function sdkCall<TResult>(\n  method: (...args: any[]) => Promise<TResult>,\n  ...args: unknown[]\n): Promise<TResult> {\n  return method(...args);\n}\n","import { QueryClient } from \"@tanstack/react-query\";\nimport { CACHE_CONFIG } from \"@simpleapps-com/augur-utils\";\n\n/**\n * Creates a server-side query client optimised for prefetching.\n *\n * - No persistence (server-only)\n * - Longer cache times for prefetched data\n * - No retries (fail fast on server)\n * - No refetching (server renders are one-shot)\n */\nexport function createServerQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        staleTime: CACHE_CONFIG.STATIC.staleTime,\n        gcTime: CACHE_CONFIG.STATIC.staleTime,\n        retry: 0,\n        refetchOnMount: false,\n        refetchOnWindowFocus: false,\n        refetchOnReconnect: false,\n      },\n    },\n  });\n}\n\nlet serverQueryClient: QueryClient | undefined = undefined;\n\n/** Singleton server query client, reused across requests. */\nexport function getServerQueryClient(): QueryClient {\n  if (!serverQueryClient) {\n    serverQueryClient = createServerQueryClient();\n  }\n  return serverQueryClient;\n}\n","import type {\n  UseQueryOptions,\n  UseSuspenseQueryOptions,\n} from \"@tanstack/react-query\";\nimport { CACHE_CONFIG } from \"@simpleapps-com/augur-utils\";\n\nexport interface QueryOptionsConfig<TParams, TData> {\n  /** Base query key (e.g., \"customer-orders\") */\n  baseKey: string;\n  /** Parameters object */\n  params: TParams;\n  /** Function that returns the data */\n  queryFn: (params: TParams) => Promise<TData>;\n  /** Function to determine if query should be enabled */\n  enabledFn?: (params: TParams) => boolean;\n  /** Custom stale time in milliseconds (default: SEMI_STATIC) */\n  staleTime?: number;\n  /** Custom garbage collection time in milliseconds (default: SEMI_STATIC) */\n  gcTime?: number;\n  /** Key to exclude from query key generation */\n  excludeFromKey?: keyof TParams;\n}\n\n/**\n * Creates useQuery options with consistent key generation.\n * Filters out undefined/null/empty params from the query key.\n */\nexport const createQueryOptions = <\n  TParams extends Record<string, unknown>,\n  TData,\n>({\n  baseKey,\n  params,\n  queryFn,\n  enabledFn,\n  staleTime = CACHE_CONFIG.SEMI_STATIC.staleTime,\n  gcTime = CACHE_CONFIG.SEMI_STATIC.gcTime,\n  excludeFromKey,\n}: QueryOptionsConfig<TParams, TData>): UseQueryOptions<TData> => {\n  const paramEntries = Object.entries(params)\n    .filter(([key, value]) => {\n      if (excludeFromKey && key === excludeFromKey) return false;\n      return value !== undefined && value !== null && value !== \"\";\n    })\n    .map(([key, value]) => `${key}: ${value}`);\n\n  const queryKey = [baseKey, ...paramEntries];\n\n  return {\n    queryKey,\n    queryFn: () => queryFn(params),\n    enabled: enabledFn ? enabledFn(params) : true,\n    staleTime,\n    gcTime,\n  };\n};\n\n/**\n * Creates useSuspenseQuery options with consistent key generation.\n * Same as createQueryOptions but without enabledFn (suspense queries\n * cannot be disabled).\n */\nexport const createSuspenseQueryOptions = <\n  TParams extends Record<string, unknown>,\n  TData,\n>({\n  baseKey,\n  params,\n  queryFn,\n  staleTime = CACHE_CONFIG.SEMI_STATIC.staleTime,\n  gcTime = CACHE_CONFIG.SEMI_STATIC.gcTime,\n  excludeFromKey,\n}: Omit<\n  QueryOptionsConfig<TParams, TData>,\n  \"enabledFn\"\n>): UseSuspenseQueryOptions<TData> => {\n  const paramEntries = Object.entries(params)\n    .filter(([key, value]) => {\n      if (excludeFromKey && key === excludeFromKey) return false;\n      return value !== undefined && value !== null && value !== \"\";\n    })\n    .map(([key, value]) => `${key}: ${value}`);\n\n  const queryKey = [baseKey, ...paramEntries];\n\n  return {\n    queryKey,\n    queryFn: () => queryFn(params),\n    staleTime,\n    gcTime,\n  };\n};\n"],"mappings":"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","names":["debugEnabled","g","ms","total","CACHE_CONFIG"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@simpleapps-com/augur-server",
+  "version": "0.1.0",
+  "description": "Server-side utilities for Augur ecommerce sites (Redis caching, SDK helpers, auth)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/simpleapps-com/augur-packages.git",
+    "directory": "packages/augur-server"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "valibot": "^1.0.0",
+    "@simpleapps-com/augur-utils": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=16.0.0",
+    "next-auth": "5.0.0-beta.30",
+    "react": "^19.0.0",
+    "@tanstack/react-query": "^5.80.0",
+    "@simpleapps-com/augur-api": "^0.9.0",
+    "ioredis": "^5.9.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "next-auth": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.80.0",
+    "@types/node": "^22.0.0",
+    "ioredis": "^5.9.0",
+    "react": "^19.0.0",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.0",
+    "@augur-packages/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}