@uniforge/core 0.1.0-alpha.2

package/dist/database/index.mjs

@@ -0,0 +1,95 @@
+// src/database/client.ts
+import { PrismaClient } from "@prisma/client";
+var client = null;
+function createPrismaClient(url) {
+  if (client) return client;
+  const options = {
+    log: process.env.NODE_ENV === "development" ? ["query", "warn", "error"] : ["error"]
+  };
+  if (url) {
+    options.datasourceUrl = url;
+  }
+  client = new PrismaClient(options);
+  return client;
+}
+function disconnectPrisma() {
+  if (!client) return Promise.resolve();
+  const c = client;
+  client = null;
+  return c.$disconnect();
+}
+
+// src/database/utils.ts
+function shopToRecord(shop) {
+  return {
+    shopDomain: shop.shopDomain,
+    isInstalled: shop.isInstalled,
+    installedAt: shop.installedAt,
+    uninstalledAt: shop.uninstalledAt,
+    scopes: shop.scopes,
+    shopifyPlan: shop.shopifyPlan,
+    createdAt: shop.createdAt,
+    updatedAt: shop.updatedAt
+  };
+}
+function recordToShop(record) {
+  return {
+    shopDomain: record.shopDomain,
+    isInstalled: record.isInstalled,
+    installedAt: record.installedAt ?? null,
+    uninstalledAt: record.uninstalledAt ?? null,
+    scopes: record.scopes,
+    shopifyPlan: record.shopifyPlan ?? null,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt
+  };
+}
+function sessionToRecord(session) {
+  const record = {
+    id: session.id,
+    shopDomain: session.shop,
+    state: session.state,
+    isOnline: session.isOnline,
+    scope: session.scope,
+    expires: session.expires,
+    accessToken: session.accessToken ?? null,
+    refreshToken: session.refreshToken ?? null,
+    refreshTokenExpiresAt: session.refreshTokenExpiresAt ?? null,
+    onlineAccessInfo: session.onlineAccessInfo ? session.onlineAccessInfo : null
+  };
+  return record;
+}
+function recordToSession(record) {
+  const session = {
+    id: record.id,
+    shop: record.shopDomain,
+    state: record.state,
+    isOnline: record.isOnline,
+    scope: record.scope,
+    expires: record.expires ?? null,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt
+  };
+  if (record.accessToken) {
+    session.accessToken = record.accessToken;
+  }
+  if (record.refreshToken) {
+    session.refreshToken = record.refreshToken;
+  }
+  if (record.refreshTokenExpiresAt) {
+    session.refreshTokenExpiresAt = record.refreshTokenExpiresAt;
+  }
+  if (record.onlineAccessInfo) {
+    session.onlineAccessInfo = record.onlineAccessInfo;
+  }
+  return session;
+}
+export {
+  createPrismaClient,
+  disconnectPrisma,
+  recordToSession,
+  recordToShop,
+  sessionToRecord,
+  shopToRecord
+};
+//# sourceMappingURL=index.mjs.map

package/dist/database/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/database/client.ts","../../src/database/utils.ts"],"sourcesContent":["/**\n * PrismaClient singleton factory.\n *\n * Provides a single shared PrismaClient instance across the application.\n * Logging verbosity is controlled by NODE_ENV.\n */\n\nimport { PrismaClient } from '@prisma/client';\n\nlet client: PrismaClient | null = null;\n\n/** Create or return the singleton PrismaClient. */\nexport function createPrismaClient(url?: string): PrismaClient {\n  if (client) return client;\n\n  const options: ConstructorParameters<typeof PrismaClient>[0] = {\n    log:\n      process.env.NODE_ENV === 'development'\n        ? ['query', 'warn', 'error']\n        : ['error'],\n  };\n  if (url) {\n    options.datasourceUrl = url;\n  }\n\n  client = new PrismaClient(options);\n  return client;\n}\n\n/** Disconnect and discard the singleton PrismaClient. */\nexport function disconnectPrisma(): Promise<void> {\n  if (!client) return Promise.resolve();\n  const c = client;\n  client = null;\n  return c.$disconnect();\n}\n","/**\n * Converters between platform-core domain types and Prisma record types.\n *\n * The Prisma models use camelCase field names (shopDomain, isOnline, etc.)\n * while platform-core types use slightly different shapes (e.g. session.shop\n * vs record.shopDomain, onlineAccessInfo as object vs JSON).\n */\n\nimport type { Session, Shop } from '@uniforge/platform-core/auth';\nimport type {\n  Shop as PrismaShop,\n  Session as PrismaSession,\n  Prisma,\n} from '@prisma/client';\n\n// ---------------------------------------------------------------------------\n// Shop converters\n// ---------------------------------------------------------------------------\n\n/** Convert a platform-core Shop to a Prisma-compatible record. */\nexport function shopToRecord(\n  shop: Shop,\n): Omit<PrismaShop, 'id'> {\n  return {\n    shopDomain: shop.shopDomain,\n    isInstalled: shop.isInstalled,\n    installedAt: shop.installedAt,\n    uninstalledAt: shop.uninstalledAt,\n    scopes: shop.scopes,\n    shopifyPlan: shop.shopifyPlan,\n    createdAt: shop.createdAt,\n    updatedAt: shop.updatedAt,\n  };\n}\n\n/** Convert a Prisma Shop record to a platform-core Shop. */\nexport function recordToShop(record: PrismaShop): Shop {\n  return {\n    shopDomain: record.shopDomain,\n    isInstalled: record.isInstalled,\n    installedAt: record.installedAt ?? null,\n    uninstalledAt: record.uninstalledAt ?? null,\n    scopes: record.scopes,\n    shopifyPlan: record.shopifyPlan ?? null,\n    createdAt: record.createdAt,\n    updatedAt: record.updatedAt,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Session converters\n// ---------------------------------------------------------------------------\n\n/** Convert a platform-core Session to a Prisma-compatible create/update input. */\nexport function sessionToRecord(\n  session: Session,\n): Omit<PrismaSession, 'createdAt' | 'updatedAt'> {\n  const record: Omit<PrismaSession, 'createdAt' | 'updatedAt'> = {\n    id: session.id,\n    shopDomain: session.shop,\n    state: session.state,\n    isOnline: session.isOnline,\n    scope: session.scope,\n    expires: session.expires,\n    accessToken: session.accessToken ?? null,\n    refreshToken: session.refreshToken ?? null,\n    refreshTokenExpiresAt: session.refreshTokenExpiresAt ?? null,\n    onlineAccessInfo: session.onlineAccessInfo\n      ? (session.onlineAccessInfo as unknown as Prisma.JsonValue)\n      : null,\n  };\n\n  return record;\n}\n\n/** Convert a Prisma Session record to a platform-core Session. */\nexport function recordToSession(record: PrismaSession): Session {\n  const session: Session = {\n    id: record.id,\n    shop: record.shopDomain,\n    state: record.state,\n    isOnline: record.isOnline,\n    scope: record.scope,\n    expires: record.expires ?? null,\n    createdAt: record.createdAt,\n    updatedAt: record.updatedAt,\n  };\n\n  if (record.accessToken) {\n    session.accessToken = record.accessToken;\n  }\n  if (record.refreshToken) {\n    session.refreshToken = record.refreshToken;\n  }\n  if (record.refreshTokenExpiresAt) {\n    session.refreshTokenExpiresAt = record.refreshTokenExpiresAt;\n  }\n  if (record.onlineAccessInfo) {\n    session.onlineAccessInfo = record.onlineAccessInfo as unknown as NonNullable<Session['onlineAccessInfo']>;\n  }\n\n  return session;\n}\n"],"mappings":";AAOA,SAAS,oBAAoB;AAE7B,IAAI,SAA8B;AAG3B,SAAS,mBAAmB,KAA4B;AAC7D,MAAI,OAAQ,QAAO;AAEnB,QAAM,UAAyD;AAAA,IAC7D,KACE,QAAQ,IAAI,aAAa,gBACrB,CAAC,SAAS,QAAQ,OAAO,IACzB,CAAC,OAAO;AAAA,EAChB;AACA,MAAI,KAAK;AACP,YAAQ,gBAAgB;AAAA,EAC1B;AAEA,WAAS,IAAI,aAAa,OAAO;AACjC,SAAO;AACT;AAGO,SAAS,mBAAkC;AAChD,MAAI,CAAC,OAAQ,QAAO,QAAQ,QAAQ;AACpC,QAAM,IAAI;AACV,WAAS;AACT,SAAO,EAAE,YAAY;AACvB;;;ACfO,SAAS,aACd,MACwB;AACxB,SAAO;AAAA,IACL,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,aAAa,KAAK;AAAA,IAClB,eAAe,KAAK;AAAA,IACpB,QAAQ,KAAK;AAAA,IACb,aAAa,KAAK;AAAA,IAClB,WAAW,KAAK;AAAA,IAChB,WAAW,KAAK;AAAA,EAClB;AACF;AAGO,SAAS,aAAa,QAA0B;AACrD,SAAO;AAAA,IACL,YAAY,OAAO;AAAA,IACnB,aAAa,OAAO;AAAA,IACpB,aAAa,OAAO,eAAe;AAAA,IACnC,eAAe,OAAO,iBAAiB;AAAA,IACvC,QAAQ,OAAO;AAAA,IACf,aAAa,OAAO,eAAe;AAAA,IACnC,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO;AAAA,EACpB;AACF;AAOO,SAAS,gBACd,SACgD;AAChD,QAAM,SAAyD;AAAA,IAC7D,IAAI,QAAQ;AAAA,IACZ,YAAY,QAAQ;AAAA,IACpB,OAAO,QAAQ;AAAA,IACf,UAAU,QAAQ;AAAA,IAClB,OAAO,QAAQ;AAAA,IACf,SAAS,QAAQ;AAAA,IACjB,aAAa,QAAQ,eAAe;AAAA,IACpC,cAAc,QAAQ,gBAAgB;AAAA,IACtC,uBAAuB,QAAQ,yBAAyB;AAAA,IACxD,kBAAkB,QAAQ,mBACrB,QAAQ,mBACT;AAAA,EACN;AAEA,SAAO;AACT;AAGO,SAAS,gBAAgB,QAAgC;AAC9D,QAAM,UAAmB;AAAA,IACvB,IAAI,OAAO;AAAA,IACX,MAAM,OAAO;AAAA,IACb,OAAO,OAAO;AAAA,IACd,UAAU,OAAO;AAAA,IACjB,OAAO,OAAO;AAAA,IACd,SAAS,OAAO,WAAW;AAAA,IAC3B,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO;AAAA,EACpB;AAEA,MAAI,OAAO,aAAa;AACtB,YAAQ,cAAc,OAAO;AAAA,EAC/B;AACA,MAAI,OAAO,cAAc;AACvB,YAAQ,eAAe,OAAO;AAAA,EAChC;AACA,MAAI,OAAO,uBAAuB;AAChC,YAAQ,wBAAwB,OAAO;AAAA,EACzC;AACA,MAAI,OAAO,kBAAkB;AAC3B,YAAQ,mBAAmB,OAAO;AAAA,EACpC;AAEA,SAAO;AACT;","names":[]}

package/dist/graphql/index.d.cts

@@ -0,0 +1,36 @@
+import { GraphQLClientConfig, GraphQLClient, RateLimitConfig, RateLimiter, CacheConfig, GraphQLCache } from '@uniforge/platform-core/graphql';
+import { Redis } from 'ioredis';
+
+/**
+ * Base GraphQL client implementation using Node 20+ built-in fetch.
+ *
+ * Provides retry logic with exponential backoff for 429 responses
+ * and timeout support via AbortController.
+ */
+
+/** Create a base GraphQL client that communicates via HTTP POST. */
+declare function createGraphQLClient(config: GraphQLClientConfig): GraphQLClient;
+
+/**
+ * Leaky bucket rate limiter for Shopify GraphQL API.
+ *
+ * Tracks available query cost points and throttles requests when
+ * points are low, restoring them over time based on Shopify's restore rate.
+ */
+
+/** Create an in-memory rate limiter that tracks Shopify query cost points. */
+declare function createRateLimiter(config?: RateLimitConfig): RateLimiter;
+
+/**
+ * Redis-based GraphQL response cache.
+ *
+ * Caches query results keyed by SHA256 hash of query + variables.
+ * Supports TTL-based expiration and pattern-based invalidation.
+ */
+
+/** Generate a cache key from a GraphQL query and variables. */
+declare function generateCacheKey(prefix: string, query: string, variables?: Record<string, unknown>): string;
+/** Create a Redis-backed GraphQL cache. */
+declare function createRedisGraphQLCache(redis: Redis, config?: CacheConfig): GraphQLCache;
+
+export { createGraphQLClient, createRateLimiter, createRedisGraphQLCache, generateCacheKey };

package/dist/graphql/index.d.ts

@@ -0,0 +1,36 @@
+import { GraphQLClientConfig, GraphQLClient, RateLimitConfig, RateLimiter, CacheConfig, GraphQLCache } from '@uniforge/platform-core/graphql';
+import { Redis } from 'ioredis';
+
+/**
+ * Base GraphQL client implementation using Node 20+ built-in fetch.
+ *
+ * Provides retry logic with exponential backoff for 429 responses
+ * and timeout support via AbortController.
+ */
+
+/** Create a base GraphQL client that communicates via HTTP POST. */
+declare function createGraphQLClient(config: GraphQLClientConfig): GraphQLClient;
+
+/**
+ * Leaky bucket rate limiter for Shopify GraphQL API.
+ *
+ * Tracks available query cost points and throttles requests when
+ * points are low, restoring them over time based on Shopify's restore rate.
+ */
+
+/** Create an in-memory rate limiter that tracks Shopify query cost points. */
+declare function createRateLimiter(config?: RateLimitConfig): RateLimiter;
+
+/**
+ * Redis-based GraphQL response cache.
+ *
+ * Caches query results keyed by SHA256 hash of query + variables.
+ * Supports TTL-based expiration and pattern-based invalidation.
+ */
+
+/** Generate a cache key from a GraphQL query and variables. */
+declare function generateCacheKey(prefix: string, query: string, variables?: Record<string, unknown>): string;
+/** Create a Redis-backed GraphQL cache. */
+declare function createRedisGraphQLCache(redis: Redis, config?: CacheConfig): GraphQLCache;
+
+export { createGraphQLClient, createRateLimiter, createRedisGraphQLCache, generateCacheKey };

package/dist/graphql/index.js

@@ -0,0 +1,209 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/graphql/index.ts
+var graphql_exports = {};
+__export(graphql_exports, {
+  createGraphQLClient: () => createGraphQLClient,
+  createRateLimiter: () => createRateLimiter,
+  createRedisGraphQLCache: () => createRedisGraphQLCache,
+  generateCacheKey: () => generateCacheKey
+});
+module.exports = __toCommonJS(graphql_exports);
+
+// src/graphql/client.ts
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_TIMEOUT_MS = 3e4;
+var BASE_RETRY_DELAY_MS = 1e3;
+function createGraphQLClient(config) {
+  const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const endpoint = `https://${config.shop}/admin/api/${config.apiVersion}/graphql.json`;
+  async function execute(query, variables) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Shopify-Access-Token": config.accessToken
+          },
+          body: JSON.stringify({ query, variables }),
+          signal: controller.signal
+        });
+        if (response.status === 429) {
+          if (attempt < maxRetries) {
+            const delay = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);
+            await sleep(delay);
+            continue;
+          }
+          throw new Error(
+            `GraphQL request throttled after ${maxRetries + 1} attempts`
+          );
+        }
+        if (!response.ok) {
+          throw new Error(
+            `GraphQL request failed with status ${response.status}: ${response.statusText}`
+          );
+        }
+        const json = await response.json();
+        return json;
+      } catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+          throw new Error(
+            `GraphQL request timed out after ${timeoutMs}ms`
+          );
+        }
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (attempt >= maxRetries) {
+          throw lastError;
+        }
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+    throw lastError ?? new Error("GraphQL request failed");
+  }
+  return {
+    query: (query, variables) => execute(query, variables),
+    mutate: (mutation, variables) => execute(mutation, variables)
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/graphql/rate-limiter.ts
+var DEFAULT_MAX_AVAILABLE = 1e3;
+var DEFAULT_RESTORE_RATE = 50;
+var DEFAULT_MINIMUM_AVAILABLE = 100;
+function createRateLimiter(config) {
+  const maximum = config?.maxAvailable ?? DEFAULT_MAX_AVAILABLE;
+  const restoreRate = config?.restoreRatePerSecond ?? DEFAULT_RESTORE_RATE;
+  const minimumAvailable = config?.minimumAvailable ?? DEFAULT_MINIMUM_AVAILABLE;
+  let available = maximum;
+  let lastUpdateTime = Date.now();
+  function restorePoints() {
+    const now = Date.now();
+    const elapsed = (now - lastUpdateTime) / 1e3;
+    available = Math.min(maximum, available + elapsed * restoreRate);
+    lastUpdateTime = now;
+  }
+  return {
+    async acquire() {
+      restorePoints();
+      if (available < minimumAvailable) {
+        const waitMs = (minimumAvailable - available) / restoreRate * 1e3;
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        restorePoints();
+      }
+    },
+    getStatus() {
+      restorePoints();
+      return {
+        available: Math.floor(available),
+        maximum,
+        restoreRate
+      };
+    },
+    updateFromResponse(cost) {
+      if (cost?.throttleStatus) {
+        available = cost.throttleStatus.currentlyAvailable;
+        lastUpdateTime = Date.now();
+      }
+    }
+  };
+}
+
+// src/graphql/cache.ts
+var import_node_crypto = require("crypto");
+var DEFAULT_TTL_SECONDS = 300;
+var DEFAULT_KEY_PREFIX = "uniforge:gql:";
+var SCAN_COUNT = 100;
+function generateCacheKey(prefix, query, variables) {
+  const content = variables ? query + JSON.stringify(variables) : query;
+  const hash = (0, import_node_crypto.createHash)("sha256").update(content).digest("hex");
+  return `${prefix}${hash}`;
+}
+function createRedisGraphQLCache(redis, config) {
+  const defaultTtl = config?.defaultTtlSeconds ?? DEFAULT_TTL_SECONDS;
+  const keyPrefix = config?.keyPrefix ?? DEFAULT_KEY_PREFIX;
+  return {
+    async get(key) {
+      const raw = await redis.get(key);
+      if (raw === null) {
+        return void 0;
+      }
+      return JSON.parse(raw);
+    },
+    async set(key, value, ttlSeconds) {
+      const ttl = ttlSeconds ?? defaultTtl;
+      if (ttl > 0) {
+        await redis.set(key, JSON.stringify(value), "EX", ttl);
+      } else {
+        await redis.set(key, JSON.stringify(value));
+      }
+    },
+    async invalidate(pattern) {
+      const scanPattern = `${keyPrefix}${pattern}`;
+      let cursor = "0";
+      do {
+        const [nextCursor, keys] = await redis.scan(
+          cursor,
+          "MATCH",
+          scanPattern,
+          "COUNT",
+          SCAN_COUNT
+        );
+        cursor = nextCursor;
+        if (keys.length > 0) {
+          await redis.del(...keys);
+        }
+      } while (cursor !== "0");
+    },
+    async clear() {
+      const scanPattern = `${keyPrefix}*`;
+      let cursor = "0";
+      do {
+        const [nextCursor, keys] = await redis.scan(
+          cursor,
+          "MATCH",
+          scanPattern,
+          "COUNT",
+          SCAN_COUNT
+        );
+        cursor = nextCursor;
+        if (keys.length > 0) {
+          await redis.del(...keys);
+        }
+      } while (cursor !== "0");
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGraphQLClient,
+  createRateLimiter,
+  createRedisGraphQLCache,
+  generateCacheKey
+});
+//# sourceMappingURL=index.js.map

package/dist/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/graphql/index.ts","../../src/graphql/client.ts","../../src/graphql/rate-limiter.ts","../../src/graphql/cache.ts"],"sourcesContent":["/**\n * @uniforge/core - GraphQL\n *\n * Core GraphQL client, rate limiter, and caching implementations.\n */\n\n// Base client\nexport { createGraphQLClient } from './client';\n\n// Rate limiter\nexport { createRateLimiter } from './rate-limiter';\n\n// Cache\nexport { createRedisGraphQLCache, generateCacheKey } from './cache';\n","/**\n * Base GraphQL client implementation using Node 20+ built-in fetch.\n *\n * Provides retry logic with exponential backoff for 429 responses\n * and timeout support via AbortController.\n */\n\nimport type {\n  GraphQLClient,\n  GraphQLClientConfig,\n  GraphQLResponse,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst BASE_RETRY_DELAY_MS = 1_000;\n\n/** Create a base GraphQL client that communicates via HTTP POST. */\nexport function createGraphQLClient(config: GraphQLClientConfig): GraphQLClient {\n  const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const endpoint = `https://${config.shop}/admin/api/${config.apiVersion}/graphql.json`;\n\n  async function execute<T>(\n    query: string,\n    variables?: Record<string, unknown>,\n  ): Promise<GraphQLResponse<T>> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n      try {\n        const response = await fetch(endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-Shopify-Access-Token': config.accessToken,\n          },\n          body: JSON.stringify({ query, variables }),\n          signal: controller.signal,\n        });\n\n        if (response.status === 429) {\n          if (attempt < maxRetries) {\n            const delay = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);\n            await sleep(delay);\n            continue;\n          }\n          throw new Error(\n            `GraphQL request throttled after ${maxRetries + 1} attempts`,\n          );\n        }\n\n        if (!response.ok) {\n          throw new Error(\n            `GraphQL request failed with status ${response.status}: ${response.statusText}`,\n          );\n        }\n\n        const json = (await response.json()) as GraphQLResponse<T>;\n        return json;\n      } catch (error) {\n        if (error instanceof DOMException && error.name === 'AbortError') {\n          throw new Error(\n            `GraphQL request timed out after ${timeoutMs}ms`,\n          );\n        }\n        lastError = error instanceof Error ? error : new Error(String(error));\n        if (attempt >= maxRetries) {\n          throw lastError;\n        }\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw lastError ?? new Error('GraphQL request failed');\n  }\n\n  return {\n    query: <T>(query: string, variables?: Record<string, unknown>) =>\n      execute<T>(query, variables),\n    mutate: <T>(mutation: string, variables?: Record<string, unknown>) =>\n      execute<T>(mutation, variables),\n  };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","/**\n * Leaky bucket rate limiter for Shopify GraphQL API.\n *\n * Tracks available query cost points and throttles requests when\n * points are low, restoring them over time based on Shopify's restore rate.\n */\n\nimport type {\n  QueryCost,\n  RateLimiter,\n  RateLimitConfig,\n  RateLimitStatus,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_MAX_AVAILABLE = 1_000;\nconst DEFAULT_RESTORE_RATE = 50;\nconst DEFAULT_MINIMUM_AVAILABLE = 100;\n\n/** Create an in-memory rate limiter that tracks Shopify query cost points. */\nexport function createRateLimiter(config?: RateLimitConfig): RateLimiter {\n  const maximum = config?.maxAvailable ?? DEFAULT_MAX_AVAILABLE;\n  const restoreRate = config?.restoreRatePerSecond ?? DEFAULT_RESTORE_RATE;\n  const minimumAvailable = config?.minimumAvailable ?? DEFAULT_MINIMUM_AVAILABLE;\n\n  let available = maximum;\n  let lastUpdateTime = Date.now();\n\n  function restorePoints(): void {\n    const now = Date.now();\n    const elapsed = (now - lastUpdateTime) / 1_000;\n    available = Math.min(maximum, available + elapsed * restoreRate);\n    lastUpdateTime = now;\n  }\n\n  return {\n    async acquire(): Promise<void> {\n      restorePoints();\n\n      if (available < minimumAvailable) {\n        const waitMs = ((minimumAvailable - available) / restoreRate) * 1_000;\n        await new Promise<void>((resolve) => setTimeout(resolve, waitMs));\n        restorePoints();\n      }\n    },\n\n    getStatus(): RateLimitStatus {\n      restorePoints();\n      return {\n        available: Math.floor(available),\n        maximum,\n        restoreRate,\n      };\n    },\n\n    updateFromResponse(cost?: QueryCost): void {\n      if (cost?.throttleStatus) {\n        available = cost.throttleStatus.currentlyAvailable;\n        lastUpdateTime = Date.now();\n      }\n    },\n  };\n}\n","/**\n * Redis-based GraphQL response cache.\n *\n * Caches query results keyed by SHA256 hash of query + variables.\n * Supports TTL-based expiration and pattern-based invalidation.\n */\n\nimport { createHash } from 'node:crypto';\nimport type { Redis } from 'ioredis';\nimport type {\n  GraphQLCache,\n  CacheConfig,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_TTL_SECONDS = 300;\nconst DEFAULT_KEY_PREFIX = 'uniforge:gql:';\nconst SCAN_COUNT = 100;\n\n/** Generate a cache key from a GraphQL query and variables. */\nexport function generateCacheKey(\n  prefix: string,\n  query: string,\n  variables?: Record<string, unknown>,\n): string {\n  const content = variables\n    ? query + JSON.stringify(variables)\n    : query;\n  const hash = createHash('sha256').update(content).digest('hex');\n  return `${prefix}${hash}`;\n}\n\n/** Create a Redis-backed GraphQL cache. */\nexport function createRedisGraphQLCache(\n  redis: Redis,\n  config?: CacheConfig,\n): GraphQLCache {\n  const defaultTtl = config?.defaultTtlSeconds ?? DEFAULT_TTL_SECONDS;\n  const keyPrefix = config?.keyPrefix ?? DEFAULT_KEY_PREFIX;\n\n  return {\n    async get<T = unknown>(key: string): Promise<T | undefined> {\n      const raw = await redis.get(key);\n      if (raw === null) {\n        return undefined;\n      }\n      return JSON.parse(raw) as T;\n    },\n\n    async set<T = unknown>(\n      key: string,\n      value: T,\n      ttlSeconds?: number,\n    ): Promise<void> {\n      const ttl = ttlSeconds ?? defaultTtl;\n      if (ttl > 0) {\n        await redis.set(key, JSON.stringify(value), 'EX', ttl);\n      } else {\n        await redis.set(key, JSON.stringify(value));\n      }\n    },\n\n    async invalidate(pattern: string): Promise<void> {\n      const scanPattern = `${keyPrefix}${pattern}`;\n      let cursor = '0';\n      do {\n        const [nextCursor, keys] = await redis.scan(\n          cursor,\n          'MATCH',\n          scanPattern,\n          'COUNT',\n          SCAN_COUNT,\n        );\n        cursor = nextCursor;\n        if (keys.length > 0) {\n          await redis.del(...keys);\n        }\n      } while (cursor !== '0');\n    },\n\n    async clear(): Promise<void> {\n      const scanPattern = `${keyPrefix}*`;\n      let cursor = '0';\n      do {\n        const [nextCursor, keys] = await redis.scan(\n          cursor,\n          'MATCH',\n          scanPattern,\n          'COUNT',\n          SCAN_COUNT,\n        );\n        cursor = nextCursor;\n        if (keys.length > 0) {\n          await redis.del(...keys);\n        }\n      } while (cursor !== '0');\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/graphql/index.mjs

@@ -0,0 +1,179 @@
+// src/graphql/client.ts
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_TIMEOUT_MS = 3e4;
+var BASE_RETRY_DELAY_MS = 1e3;
+function createGraphQLClient(config) {
+  const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const endpoint = `https://${config.shop}/admin/api/${config.apiVersion}/graphql.json`;
+  async function execute(query, variables) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-Shopify-Access-Token": config.accessToken
+          },
+          body: JSON.stringify({ query, variables }),
+          signal: controller.signal
+        });
+        if (response.status === 429) {
+          if (attempt < maxRetries) {
+            const delay = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);
+            await sleep(delay);
+            continue;
+          }
+          throw new Error(
+            `GraphQL request throttled after ${maxRetries + 1} attempts`
+          );
+        }
+        if (!response.ok) {
+          throw new Error(
+            `GraphQL request failed with status ${response.status}: ${response.statusText}`
+          );
+        }
+        const json = await response.json();
+        return json;
+      } catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+          throw new Error(
+            `GraphQL request timed out after ${timeoutMs}ms`
+          );
+        }
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (attempt >= maxRetries) {
+          throw lastError;
+        }
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+    throw lastError ?? new Error("GraphQL request failed");
+  }
+  return {
+    query: (query, variables) => execute(query, variables),
+    mutate: (mutation, variables) => execute(mutation, variables)
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/graphql/rate-limiter.ts
+var DEFAULT_MAX_AVAILABLE = 1e3;
+var DEFAULT_RESTORE_RATE = 50;
+var DEFAULT_MINIMUM_AVAILABLE = 100;
+function createRateLimiter(config) {
+  const maximum = config?.maxAvailable ?? DEFAULT_MAX_AVAILABLE;
+  const restoreRate = config?.restoreRatePerSecond ?? DEFAULT_RESTORE_RATE;
+  const minimumAvailable = config?.minimumAvailable ?? DEFAULT_MINIMUM_AVAILABLE;
+  let available = maximum;
+  let lastUpdateTime = Date.now();
+  function restorePoints() {
+    const now = Date.now();
+    const elapsed = (now - lastUpdateTime) / 1e3;
+    available = Math.min(maximum, available + elapsed * restoreRate);
+    lastUpdateTime = now;
+  }
+  return {
+    async acquire() {
+      restorePoints();
+      if (available < minimumAvailable) {
+        const waitMs = (minimumAvailable - available) / restoreRate * 1e3;
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        restorePoints();
+      }
+    },
+    getStatus() {
+      restorePoints();
+      return {
+        available: Math.floor(available),
+        maximum,
+        restoreRate
+      };
+    },
+    updateFromResponse(cost) {
+      if (cost?.throttleStatus) {
+        available = cost.throttleStatus.currentlyAvailable;
+        lastUpdateTime = Date.now();
+      }
+    }
+  };
+}
+
+// src/graphql/cache.ts
+import { createHash } from "crypto";
+var DEFAULT_TTL_SECONDS = 300;
+var DEFAULT_KEY_PREFIX = "uniforge:gql:";
+var SCAN_COUNT = 100;
+function generateCacheKey(prefix, query, variables) {
+  const content = variables ? query + JSON.stringify(variables) : query;
+  const hash = createHash("sha256").update(content).digest("hex");
+  return `${prefix}${hash}`;
+}
+function createRedisGraphQLCache(redis, config) {
+  const defaultTtl = config?.defaultTtlSeconds ?? DEFAULT_TTL_SECONDS;
+  const keyPrefix = config?.keyPrefix ?? DEFAULT_KEY_PREFIX;
+  return {
+    async get(key) {
+      const raw = await redis.get(key);
+      if (raw === null) {
+        return void 0;
+      }
+      return JSON.parse(raw);
+    },
+    async set(key, value, ttlSeconds) {
+      const ttl = ttlSeconds ?? defaultTtl;
+      if (ttl > 0) {
+        await redis.set(key, JSON.stringify(value), "EX", ttl);
+      } else {
+        await redis.set(key, JSON.stringify(value));
+      }
+    },
+    async invalidate(pattern) {
+      const scanPattern = `${keyPrefix}${pattern}`;
+      let cursor = "0";
+      do {
+        const [nextCursor, keys] = await redis.scan(
+          cursor,
+          "MATCH",
+          scanPattern,
+          "COUNT",
+          SCAN_COUNT
+        );
+        cursor = nextCursor;
+        if (keys.length > 0) {
+          await redis.del(...keys);
+        }
+      } while (cursor !== "0");
+    },
+    async clear() {
+      const scanPattern = `${keyPrefix}*`;
+      let cursor = "0";
+      do {
+        const [nextCursor, keys] = await redis.scan(
+          cursor,
+          "MATCH",
+          scanPattern,
+          "COUNT",
+          SCAN_COUNT
+        );
+        cursor = nextCursor;
+        if (keys.length > 0) {
+          await redis.del(...keys);
+        }
+      } while (cursor !== "0");
+    }
+  };
+}
+export {
+  createGraphQLClient,
+  createRateLimiter,
+  createRedisGraphQLCache,
+  generateCacheKey
+};
+//# sourceMappingURL=index.mjs.map

package/dist/graphql/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/graphql/client.ts","../../src/graphql/rate-limiter.ts","../../src/graphql/cache.ts"],"sourcesContent":["/**\n * Base GraphQL client implementation using Node 20+ built-in fetch.\n *\n * Provides retry logic with exponential backoff for 429 responses\n * and timeout support via AbortController.\n */\n\nimport type {\n  GraphQLClient,\n  GraphQLClientConfig,\n  GraphQLResponse,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst BASE_RETRY_DELAY_MS = 1_000;\n\n/** Create a base GraphQL client that communicates via HTTP POST. */\nexport function createGraphQLClient(config: GraphQLClientConfig): GraphQLClient {\n  const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const endpoint = `https://${config.shop}/admin/api/${config.apiVersion}/graphql.json`;\n\n  async function execute<T>(\n    query: string,\n    variables?: Record<string, unknown>,\n  ): Promise<GraphQLResponse<T>> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n      try {\n        const response = await fetch(endpoint, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'X-Shopify-Access-Token': config.accessToken,\n          },\n          body: JSON.stringify({ query, variables }),\n          signal: controller.signal,\n        });\n\n        if (response.status === 429) {\n          if (attempt < maxRetries) {\n            const delay = BASE_RETRY_DELAY_MS * Math.pow(2, attempt);\n            await sleep(delay);\n            continue;\n          }\n          throw new Error(\n            `GraphQL request throttled after ${maxRetries + 1} attempts`,\n          );\n        }\n\n        if (!response.ok) {\n          throw new Error(\n            `GraphQL request failed with status ${response.status}: ${response.statusText}`,\n          );\n        }\n\n        const json = (await response.json()) as GraphQLResponse<T>;\n        return json;\n      } catch (error) {\n        if (error instanceof DOMException && error.name === 'AbortError') {\n          throw new Error(\n            `GraphQL request timed out after ${timeoutMs}ms`,\n          );\n        }\n        lastError = error instanceof Error ? error : new Error(String(error));\n        if (attempt >= maxRetries) {\n          throw lastError;\n        }\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw lastError ?? new Error('GraphQL request failed');\n  }\n\n  return {\n    query: <T>(query: string, variables?: Record<string, unknown>) =>\n      execute<T>(query, variables),\n    mutate: <T>(mutation: string, variables?: Record<string, unknown>) =>\n      execute<T>(mutation, variables),\n  };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","/**\n * Leaky bucket rate limiter for Shopify GraphQL API.\n *\n * Tracks available query cost points and throttles requests when\n * points are low, restoring them over time based on Shopify's restore rate.\n */\n\nimport type {\n  QueryCost,\n  RateLimiter,\n  RateLimitConfig,\n  RateLimitStatus,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_MAX_AVAILABLE = 1_000;\nconst DEFAULT_RESTORE_RATE = 50;\nconst DEFAULT_MINIMUM_AVAILABLE = 100;\n\n/** Create an in-memory rate limiter that tracks Shopify query cost points. */\nexport function createRateLimiter(config?: RateLimitConfig): RateLimiter {\n  const maximum = config?.maxAvailable ?? DEFAULT_MAX_AVAILABLE;\n  const restoreRate = config?.restoreRatePerSecond ?? DEFAULT_RESTORE_RATE;\n  const minimumAvailable = config?.minimumAvailable ?? DEFAULT_MINIMUM_AVAILABLE;\n\n  let available = maximum;\n  let lastUpdateTime = Date.now();\n\n  function restorePoints(): void {\n    const now = Date.now();\n    const elapsed = (now - lastUpdateTime) / 1_000;\n    available = Math.min(maximum, available + elapsed * restoreRate);\n    lastUpdateTime = now;\n  }\n\n  return {\n    async acquire(): Promise<void> {\n      restorePoints();\n\n      if (available < minimumAvailable) {\n        const waitMs = ((minimumAvailable - available) / restoreRate) * 1_000;\n        await new Promise<void>((resolve) => setTimeout(resolve, waitMs));\n        restorePoints();\n      }\n    },\n\n    getStatus(): RateLimitStatus {\n      restorePoints();\n      return {\n        available: Math.floor(available),\n        maximum,\n        restoreRate,\n      };\n    },\n\n    updateFromResponse(cost?: QueryCost): void {\n      if (cost?.throttleStatus) {\n        available = cost.throttleStatus.currentlyAvailable;\n        lastUpdateTime = Date.now();\n      }\n    },\n  };\n}\n","/**\n * Redis-based GraphQL response cache.\n *\n * Caches query results keyed by SHA256 hash of query + variables.\n * Supports TTL-based expiration and pattern-based invalidation.\n */\n\nimport { createHash } from 'node:crypto';\nimport type { Redis } from 'ioredis';\nimport type {\n  GraphQLCache,\n  CacheConfig,\n} from '@uniforge/platform-core/graphql';\n\nconst DEFAULT_TTL_SECONDS = 300;\nconst DEFAULT_KEY_PREFIX = 'uniforge:gql:';\nconst SCAN_COUNT = 100;\n\n/** Generate a cache key from a GraphQL query and variables. */\nexport function generateCacheKey(\n  prefix: string,\n  query: string,\n  variables?: Record<string, unknown>,\n): string {\n  const content = variables\n    ? query + JSON.stringify(variables)\n    : query;\n  const hash = createHash('sha256').update(content).digest('hex');\n  return `${prefix}${hash}`;\n}\n\n/** Create a Redis-backed GraphQL cache. */\nexport function createRedisGraphQLCache(\n  redis: Redis,\n  config?: CacheConfig,\n): GraphQLCache {\n  const defaultTtl = config?.defaultTtlSeconds ?? DEFAULT_TTL_SECONDS;\n  const keyPrefix = config?.keyPrefix ?? DEFAULT_KEY_PREFIX;\n\n  return {\n    async get<T = unknown>(key: string): Promise<T | undefined> {\n      const raw = await redis.get(key);\n      if (raw === null) {\n        return undefined;\n      }\n      return JSON.parse(raw) as T;\n    },\n\n    async set<T = unknown>(\n      key: string,\n      value: T,\n      ttlSeconds?: number,\n    ): Promise<void> {\n      const ttl = ttlSeconds ?? defaultTtl;\n      if (ttl > 0) {\n        await redis.set(key, JSON.stringify(value), 'EX', ttl);\n      } else {\n        await redis.set(key, JSON.stringify(value));\n      }\n    },\n\n    async invalidate(pattern: string): Promise<void> {\n      const scanPattern = `${keyPrefix}${pattern}`;\n      let cursor = '0';\n      do {\n        const [nextCursor, keys] = await redis.scan(\n          cursor,\n          'MATCH',\n          scanPattern,\n          'COUNT',\n          SCAN_COUNT,\n        );\n        cursor = nextCursor;\n        if (keys.length > 0) {\n          await redis.del(...keys);\n        }\n      } while (cursor !== '0');\n    },\n\n    async clear(): Promise<void> {\n      const scanPattern = `${keyPrefix}*`;\n      let cursor = '0';\n      do {\n        const [nextCursor, keys] = await redis.scan(\n          cursor,\n          'MATCH',\n          scanPattern,\n          'COUNT',\n          SCAN_COUNT,\n        );\n        cursor = nextCursor;\n        if (keys.length > 0) {\n          await redis.del(...keys);\n        }\n      } while (cursor !== '0');\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @uniforge/core
+ *
+ * Core framework functionality including authentication, GraphQL client,
+ * webhooks, and billing integration.
+ */
+declare const VERSION = "0.0.0";
+/**
+ * UniForge core module placeholder.
+ * Full implementation will include auth, GraphQL, webhooks, and billing.
+ */
+declare const uniforge: {
+    version: string;
+};
+
+export { VERSION, uniforge };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @uniforge/core
+ *
+ * Core framework functionality including authentication, GraphQL client,
+ * webhooks, and billing integration.
+ */
+declare const VERSION = "0.0.0";
+/**
+ * UniForge core module placeholder.
+ * Full implementation will include auth, GraphQL, webhooks, and billing.
+ */
+declare const uniforge: {
+    version: string;
+};
+
+export { VERSION, uniforge };