@forgecart/sdk 0.1.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@forgecart/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for ForgeCart GraphQL API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "graphql": "^16.8.1",
+    "graphql-request": "^6.1.0",
+    "graphql-tag": "^2.12.6",
+    "graphql-ws": "^6.0.6"
+  },
+  "optionalDependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "@types/jest": "^29.5.11",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/forgecart/sdk"
+  },
+  "keywords": [
+    "forgecart",
+    "graphql",
+    "sdk",
+    "typescript",
+    "ecommerce",
+    "api"
+  ],
+  "author": "ForgeCart",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx"
+  }
+}

package/src/generated/sdk.ts

@@ -0,0 +1,433 @@
+/**
+ * @forgecart/admin-sdk - Auto-generated TypeScript SDK
+ *
+ * This file was automatically generated and should not be manually edited.
+ * To regenerate, run: npm run codegen:ts
+ *
+ * Generated at: 2025-10-31T11:44:37.912Z
+ * Generator version: 1.0.0
+ *
+ * 🤖 Generated with ForgeCart SDK Generator
+ */
+
+
+import * as Types from './types.js';
+
+import { GraphQLClient, RequestDocument, Variables } from 'graphql-request';
+import { createClient, Client as WSClient, ClientOptions as WSClientOptions } from 'graphql-ws';
+
+/**
+ * SDK Configuration
+ */
+export interface SDKConfig {
+  /** GraphQL HTTP endpoint */
+  endpoint?: string;
+  /** WebSocket endpoint for subscriptions */
+  wsEndpoint?: string;
+  /** Custom HTTP headers */
+  headers?: Record<string, string>;
+  /** Custom WebSocket implementation (optional, auto-detected if not provided) */
+  webSocketImpl?: any;
+}
+
+export type AdminLoginMutationVariables = Types.AdminLoginMutationVariables;
+export type AdminLoginMutation = Types.AdminLoginMutation;
+export type AdminLoginMutationResult = Types.AdminLoginMutation;
+export type ProductsQueryVariables = Types.ProductsQueryVariables;
+export type ProductsQuery = Types.ProductsQuery;
+export type ProductsQueryResult = Types.ProductsQuery;
+export type ProductQueryVariables = Types.ProductQueryVariables;
+export type ProductQuery = Types.ProductQuery;
+export type ProductQueryResult = Types.ProductQuery;
+export type CreateProductMutationVariables = Types.CreateProductMutationVariables;
+export type CreateProductMutation = Types.CreateProductMutation;
+export type CreateProductMutationResult = Types.CreateProductMutation;
+export type UpdateProductMutationVariables = Types.UpdateProductMutationVariables;
+export type UpdateProductMutation = Types.UpdateProductMutation;
+export type UpdateProductMutationResult = Types.UpdateProductMutation;
+export type DeleteProductMutationVariables = Types.DeleteProductMutationVariables;
+export type DeleteProductMutation = Types.DeleteProductMutation;
+export type DeleteProductMutationResult = Types.DeleteProductMutation;
+
+const adminLoginDocument = `mutation AdminLogin($username: String!, $password: String!, $rememberMe: Boolean) {
+  login(username: $username, password: $password, rememberMe: $rememberMe) {
+    __typename
+    ... on CurrentUser {
+      id
+      identifier
+      channels {
+        id
+        code
+        token
+        permissions
+      }
+    }
+    ... on InvalidCredentialsError {
+      errorCode
+      message
+    }
+    ... on NativeAuthStrategyError {
+      errorCode
+      message
+    }
+  }
+}`;
+
+const productsDocument = `query products($options: ProductListOptions) {
+  products(options: $options) {
+    items {
+      id
+      name
+      slug
+      description
+      enabled
+      createdAt
+      updatedAt
+      featuredAsset {
+        id
+        preview
+      }
+      variants {
+        id
+        name
+        sku
+        price
+        stockLevel
+        enabled
+      }
+    }
+    totalItems
+  }
+}`;
+
+const productDocument = `query product($id: ID!) {
+  product(id: $id) {
+    id
+    name
+    slug
+    description
+    enabled
+    featuredAsset {
+      id
+      preview
+      source
+    }
+    assets {
+      id
+      preview
+      source
+    }
+    variants {
+      id
+      name
+      sku
+      price
+      stockLevel
+      trackInventory
+      enabled
+    }
+    optionGroups {
+      id
+      name
+      code
+    }
+    facetValues {
+      id
+      name
+      code
+    }
+  }
+}`;
+
+const createProductDocument = `mutation createProduct($input: CreateProductInput!) {
+  createProduct(input: $input) {
+    id
+    name
+    slug
+    enabled
+  }
+}`;
+
+const updateProductDocument = `mutation updateProduct($input: UpdateProductInput!) {
+  updateProduct(input: $input) {
+    id
+    name
+    slug
+    enabled
+  }
+}`;
+
+const deleteProductDocument = `mutation deleteProduct($id: ID!) {
+  deleteProduct(id: $id) {
+    result
+    message
+  }
+}`;
+
+/**
+ * Base GraphQL Client
+ * Handles HTTP and WebSocket connections for queries, mutations, and subscriptions
+ */
+class BaseGraphQLClient {
+  private httpClient: GraphQLClient;
+  private wsClient: WSClient | null = null;
+  private authToken: string | null = null;
+  private endpoint: string;
+  private wsEndpoint: string;
+  private config: SDKConfig;
+
+  constructor(config: SDKConfig) {
+    this.endpoint = config.endpoint || 'http://localhost:3000/admin-api';
+    this.wsEndpoint = config.wsEndpoint || 'ws://localhost:3000/admin-api';
+    this.config = config;
+
+    // Initialize HTTP client
+    this.httpClient = new GraphQLClient(this.endpoint, {
+      headers: config.headers || {},
+    });
+
+    // WebSocket client will be initialized on first subscription
+  }
+
+  /**
+   * Execute a GraphQL query or mutation
+   */
+  async request<T = any, V extends Variables = Variables>(
+    document: RequestDocument,
+    variables?: V
+  ): Promise<T> {
+    try {
+      return await this.httpClient.request<T>(document, variables as any);
+    } catch (error) {
+      this.handleError(error);
+      throw error;
+    }
+  }
+
+  
+  /**
+   * Handle GraphQL errors
+   */
+  private handleError(error: any): void {
+    console.error('GraphQL Error:', error);
+  }
+
+  
+  /**
+   * Get WebSocket implementation for current environment
+   */
+  private getWebSocketImpl(): any {
+    // Use custom implementation if provided
+    if (this.config.webSocketImpl) {
+      return this.config.webSocketImpl;
+    }
+
+    // Browser environment (native WebSocket)
+    if (typeof WebSocket !== 'undefined') {
+      return WebSocket;
+    }
+
+    // Node.js environment (try to import 'ws' package)
+    try {
+      // Dynamic import for Node.js
+      return require('ws');
+    } catch (e) {
+      console.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
+      return undefined;
+    }
+  }
+
+  /**
+   * Initialize WebSocket client for subscriptions
+   */
+  private initializeWebSocket(): WSClient {
+    if (this.wsClient) {
+      return this.wsClient;
+    }
+
+    const WebSocketImpl = this.getWebSocketImpl();
+    if (!WebSocketImpl) {
+      throw new Error('WebSocket implementation not available. Please install "ws" package or provide webSocketImpl in config.');
+    }
+
+    const wsOptions: WSClientOptions = {
+      url: this.wsEndpoint,
+      webSocketImpl: WebSocketImpl,
+      connectionParams: async () => {
+        return this.authToken ? { authorization: this.authToken } : {};
+      },
+      retryAttempts: 5,
+      shouldRetry: () => true,
+    };
+
+    this.wsClient = createClient(wsOptions);
+    return this.wsClient;
+  }
+
+  /**
+   * Subscribe to a GraphQL subscription
+   */
+  subscribe<T = any>(
+    document: RequestDocument,
+    variables?: Variables
+  ): AsyncIterableIterator<T> {
+    const client = this.initializeWebSocket();
+    const subscription = client.iterate({
+      query: document as string,
+      variables,
+    });
+
+    const iterator: AsyncIterableIterator<T> = {
+      async next() {
+        const result = await subscription.next();
+        if (result.done) {
+          return { done: true, value: undefined as any };
+        }
+        if (result.value.errors) {
+          throw new Error(result.value.errors.map(e => e.message).join(', '));
+        }
+        return { done: false, value: result.value.data as T };
+      },
+      async return() {
+        subscription.return?.();
+        return { done: true, value: undefined as any };
+      },
+      async throw(error: any) {
+        subscription.throw?.(error);
+        return { done: true, value: undefined as any };
+      },
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+    };
+
+    return iterator;
+  }
+
+  
+  /**
+   * Set authentication token
+   */
+  setAuthToken(token: string): void {
+    this.authToken = token;
+    this.httpClient.setHeader('authorization', `Bearer ${token}`);
+
+    // Reconnect WebSocket with new token
+    if (this.wsClient) {
+      this.wsClient.dispose();
+      this.wsClient = null;
+      // Will be reinitialized with new token on next subscription
+    }
+  }
+
+  /**
+   * Clear authentication token
+   */
+  clearAuthToken(): void {
+    this.authToken = null;
+    this.httpClient.setHeader('authorization', '');
+
+    // Reconnect WebSocket without token
+    if (this.wsClient) {
+      this.wsClient.dispose();
+      this.wsClient = null;
+    }
+  }
+
+  /**
+   * Dispose of the client and close connections
+   */
+  dispose(): void {
+    if (this.wsClient) {
+      this.wsClient.dispose();
+      this.wsClient = null;
+    }
+  }
+}
+
+/**
+ * Admin namespace operations
+ */
+class AdminOperations {
+  constructor(private client: BaseGraphQLClient) {}
+
+  /**
+   * AdminLogin mutation
+   */
+  async adminLogin(variables: Types.AdminLoginMutationVariables): Promise<Types.AdminLoginMutation> {
+    return await this.client.request<Types.AdminLoginMutation>(adminLoginDocument, variables);
+  }
+
+  /**
+   * products query
+   */
+  async products(variables: Types.ProductsQueryVariables): Promise<Types.ProductsQuery> {
+    return await this.client.request<Types.ProductsQuery>(productsDocument, variables);
+  }
+
+  /**
+   * product query
+   */
+  async product(variables: Types.ProductQueryVariables): Promise<Types.ProductQuery> {
+    return await this.client.request<Types.ProductQuery>(productDocument, variables);
+  }
+
+  /**
+   * createProduct mutation
+   */
+  async createProduct(variables: Types.CreateProductMutationVariables): Promise<Types.CreateProductMutation> {
+    return await this.client.request<Types.CreateProductMutation>(createProductDocument, variables);
+  }
+
+  /**
+   * updateProduct mutation
+   */
+  async updateProduct(variables: Types.UpdateProductMutationVariables): Promise<Types.UpdateProductMutation> {
+    return await this.client.request<Types.UpdateProductMutation>(updateProductDocument, variables);
+  }
+
+  /**
+   * deleteProduct mutation
+   */
+  async deleteProduct(variables: Types.DeleteProductMutationVariables): Promise<Types.DeleteProductMutation> {
+    return await this.client.request<Types.DeleteProductMutation>(deleteProductDocument, variables);
+  }
+}
+
+/**
+ * ForgeCartSDK
+ * Main SDK class with namespaced operations
+ */
+export class ForgeCartSDK {
+  private client: BaseGraphQLClient;
+
+  readonly admin: AdminOperations;
+
+  constructor(config: SDKConfig = {}) {
+    this.client = new BaseGraphQLClient(config);
+
+    this.admin = new AdminOperations(this.client);
+  }
+
+/**
+   * Set authentication token
+   * Updates both HTTP and WebSocket clients with the new token
+   */
+  setAuthToken(token: string): void {
+    this.client.setAuthToken(token);
+  }
+
+  /**
+   * Clear authentication token
+   */
+  clearAuthToken(): void {
+    this.client.clearAuthToken();
+  }
+
+  /**
+   * Dispose of the SDK and close all connections
+   */
+  dispose(): void {
+    this.client.dispose();
+  }
+}