@connect-plus-online/ogabai-integrations 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+type Money = {
+    amount: number;
+    currency: string;
+};
+type UserRole = "admin" | "agent" | "customer";
+type User = {
+    id: string;
+    name: string;
+    email?: string;
+    role: UserRole;
+    balance?: Money;
+};
+/** GraphQL-related */
+type GraphQLVariables = Record<string, any> | undefined;
+type GraphQLRequest = {
+    query: string;
+    variables?: GraphQLVariables;
+    operationName?: string;
+};
+type GraphQLError = {
+    message: string;
+    locations?: {
+        line: number;
+        column: number;
+    }[];
+    path?: string[];
+    extensions?: Record<string, any>;
+};
+type GraphQLResponse<T = any> = {
+    data?: T;
+    errors?: GraphQLError[];
+};
+
+type AuthTokenProvider = () => Promise<string | null> | string | null;
+type HeadersFactory = () => Promise<Record<string, string>> | Record<string, string>;
+declare const toAsyncTokenProvider: (p?: AuthTokenProvider) => (() => Promise<string | null>);
+declare const toAsyncHeadersFactory: (f?: HeadersFactory) => (() => Promise<Record<string, string>>);
+
+declare class SdkError extends Error {
+    code?: string;
+    info?: any;
+    constructor(message: string, code?: string, info?: any);
+}
+declare class NetworkError extends SdkError {
+    constructor(message?: string, info?: any);
+}
+declare class AuthenticationError extends SdkError {
+    constructor(message?: string, info?: any);
+}
+
+interface CacheRequestOptions {
+    skipCache?: boolean;
+}
+
+type RequestContext = {
+    request: GraphQLRequest;
+    url: string;
+    headers: Record<string, string>;
+    meta?: Record<string, any>;
+    cacheOptions?: CacheRequestOptions;
+};
+type ResponseContext<T = any> = {
+    response?: GraphQLResponse<T> | null;
+    error?: Error | null;
+    status?: number | null;
+};
+type Next = () => Promise<void>;
+type Middleware = <T = any>(ctx: RequestContext, resCtx: ResponseContext<T>, next: Next) => Promise<void>;
+
+type ClientOptions = {
+    url: string;
+    tokenProvider?: (() => Promise<string | null>) | (() => string | null);
+    headersFactory?: (() => Promise<Record<string, string>>) | (() => Record<string, string>);
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    middlewares?: Middleware[];
+};
+declare class GraphQLClient {
+    private url;
+    private tokenProvider;
+    private headersFactory;
+    private middlewares;
+    constructor(opts: ClientOptions);
+    private authMiddleware;
+    request<T = any>(query: string, variables?: Record<string, any>, options?: Partial<Omit<RequestContext, "request" | "url">>): Promise<GraphQLResponse<T>>;
+}
+
+declare const createUserService: (client: GraphQLClient) => {
+    getUser(id: string): Promise<User | null>;
+};
+
+/**
+ * Very small mock client that conforms to GraphQLClient.request interface.
+ * Use in tests to return canned responses.
+ */
+declare const createMockClient: (handler: (req: GraphQLRequest) => Promise<GraphQLResponse>) => GraphQLClient;
+
+export { AuthTokenProvider, AuthenticationError, GraphQLClient, GraphQLError, GraphQLRequest, GraphQLResponse, GraphQLVariables, HeadersFactory, Money, NetworkError, SdkError, User, UserRole, createMockClient, createUserService, toAsyncHeadersFactory, toAsyncTokenProvider };

package/dist/index.js

@@ -0,0 +1,226 @@
+"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/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AuthenticationError: () => AuthenticationError,
+  GraphQLClient: () => GraphQLClient,
+  NetworkError: () => NetworkError,
+  SdkError: () => SdkError,
+  createMockClient: () => createMockClient,
+  createUserService: () => createUserService,
+  toAsyncHeadersFactory: () => toAsyncHeadersFactory,
+  toAsyncTokenProvider: () => toAsyncTokenProvider
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/auth.ts
+var toAsyncTokenProvider = (p) => {
+  if (!p)
+    return async () => null;
+  return async () => {
+    try {
+      const res = p();
+      return res instanceof Promise ? await res : res;
+    } catch {
+      return null;
+    }
+  };
+};
+var toAsyncHeadersFactory = (f) => {
+  if (!f)
+    return async () => ({});
+  return async () => {
+    try {
+      const res = f();
+      return (res instanceof Promise ? await res : res) ?? {};
+    } catch {
+      return {};
+    }
+  };
+};
+
+// src/errors.ts
+var SdkError = class extends Error {
+  constructor(message, code, info) {
+    super(message);
+    this.name = "SdkError";
+    this.code = code;
+    this.info = info;
+  }
+};
+var NetworkError = class extends SdkError {
+  constructor(message = "Network error", info) {
+    super(message, "NETWORK_ERROR", info);
+  }
+};
+var AuthenticationError = class extends SdkError {
+  constructor(message = "Authentication failed", info) {
+    super(message, "AUTH_ERROR", info);
+  }
+};
+
+// src/middleware.ts
+var compose = (middlewares) => async (ctx, resCtx) => {
+  let idx = -1;
+  const dispatch = async (i) => {
+    if (i <= idx)
+      throw new Error("next() called multiple times");
+    idx = i;
+    const fn = middlewares[i];
+    if (!fn)
+      return;
+    await fn(ctx, resCtx, () => dispatch(i + 1));
+  };
+  await dispatch(0);
+};
+
+// src/transport.ts
+var createTransport = (opts) => {
+  const fetchImpl = opts?.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : void 0);
+  if (!fetchImpl) {
+    throw new Error(
+      "No fetch implementation available. Provide fetchImpl in TransportOptions or polyfill fetch."
+    );
+  }
+  return async (ctx, resCtx, next) => {
+    const body = JSON.stringify({ query: ctx.request.query, variables: ctx.request.variables });
+    try {
+      const controller = typeof AbortController !== "undefined" ? new AbortController() : null;
+      const signal = controller?.signal;
+      let timer;
+      if (controller && opts?.timeoutMs)
+        timer = setTimeout(() => controller.abort(), opts.timeoutMs);
+      const r = await fetchImpl(ctx.url, {
+        method: "POST",
+        headers: ctx.headers,
+        body,
+        signal
+      });
+      if (timer)
+        clearTimeout(timer);
+      const text = await r.text();
+      let parsed;
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        resCtx.error = new Error("Invalid JSON response");
+        resCtx.status = r.status;
+        return;
+      }
+      resCtx.response = parsed;
+      resCtx.status = r.status;
+    } catch (err) {
+      if (err.name === "AbortError")
+        resCtx.error = new Error("Request timed out");
+      else
+        resCtx.error = err;
+    }
+    await next();
+  };
+};
+
+// src/client.ts
+var GraphQLClient = class {
+  constructor(opts) {
+    this.url = opts.url;
+    this.tokenProvider = toAsyncTokenProvider(opts.tokenProvider);
+    this.headersFactory = toAsyncHeadersFactory(opts.headersFactory);
+    const base = [this.authMiddleware.bind(this)];
+    if (opts.middlewares)
+      base.push(...opts.middlewares);
+    base.push(createTransport({ fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs }));
+    this.middlewares = base;
+  }
+  async authMiddleware(ctx, resCtx, next) {
+    const token = await this.tokenProvider();
+    const dynamicHeaders = await this.headersFactory();
+    ctx.headers = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...dynamicHeaders,
+      ...token ? { Authorization: `Bearer ${token}` } : {},
+      ...ctx.headers ?? {}
+    };
+    await next();
+  }
+  // core request
+  async request(query, variables, options) {
+    const ctx = {
+      request: { query, variables },
+      url: this.url,
+      headers: options?.headers ?? {},
+      cacheOptions: options?.cacheOptions
+    };
+    const resCtx = {};
+    const runner = compose(this.middlewares);
+    await runner(ctx, resCtx);
+    if (resCtx.error)
+      throw resCtx.error;
+    if (!resCtx.response)
+      throw new Error("No response from GraphQL transport");
+    if (resCtx.response.errors && resCtx.response.errors.length) {
+      const e = resCtx.response.errors[0];
+      const err = new Error(e.message);
+      err.extensions = e.extensions;
+      throw err;
+    }
+    return resCtx.response;
+  }
+};
+
+// src/services/user.service.ts
+var GET_USER = `
+query GetUser($id: ID!) {
+  user(id: $id) {
+    id
+    name
+    email
+    role
+    balance { amount currency }
+  }
+}
+`;
+var createUserService = (client) => ({
+  async getUser(id) {
+    const res = await client.request(GET_USER, { id }, { cacheOptions: { skipCache: true } });
+    return res.data?.user ?? null;
+  }
+});
+
+// src/testing/mockClient.ts
+var createMockClient = (handler) => {
+  return {
+    request: async (query, variables) => {
+      return await handler({ query, variables });
+    }
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  GraphQLClient,
+  NetworkError,
+  SdkError,
+  createMockClient,
+  createUserService,
+  toAsyncHeadersFactory,
+  toAsyncTokenProvider
+});

package/dist/index.mjs

@@ -0,0 +1,192 @@
+// src/auth.ts
+var toAsyncTokenProvider = (p) => {
+  if (!p)
+    return async () => null;
+  return async () => {
+    try {
+      const res = p();
+      return res instanceof Promise ? await res : res;
+    } catch {
+      return null;
+    }
+  };
+};
+var toAsyncHeadersFactory = (f) => {
+  if (!f)
+    return async () => ({});
+  return async () => {
+    try {
+      const res = f();
+      return (res instanceof Promise ? await res : res) ?? {};
+    } catch {
+      return {};
+    }
+  };
+};
+
+// src/errors.ts
+var SdkError = class extends Error {
+  constructor(message, code, info) {
+    super(message);
+    this.name = "SdkError";
+    this.code = code;
+    this.info = info;
+  }
+};
+var NetworkError = class extends SdkError {
+  constructor(message = "Network error", info) {
+    super(message, "NETWORK_ERROR", info);
+  }
+};
+var AuthenticationError = class extends SdkError {
+  constructor(message = "Authentication failed", info) {
+    super(message, "AUTH_ERROR", info);
+  }
+};
+
+// src/middleware.ts
+var compose = (middlewares) => async (ctx, resCtx) => {
+  let idx = -1;
+  const dispatch = async (i) => {
+    if (i <= idx)
+      throw new Error("next() called multiple times");
+    idx = i;
+    const fn = middlewares[i];
+    if (!fn)
+      return;
+    await fn(ctx, resCtx, () => dispatch(i + 1));
+  };
+  await dispatch(0);
+};
+
+// src/transport.ts
+var createTransport = (opts) => {
+  const fetchImpl = opts?.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : void 0);
+  if (!fetchImpl) {
+    throw new Error(
+      "No fetch implementation available. Provide fetchImpl in TransportOptions or polyfill fetch."
+    );
+  }
+  return async (ctx, resCtx, next) => {
+    const body = JSON.stringify({ query: ctx.request.query, variables: ctx.request.variables });
+    try {
+      const controller = typeof AbortController !== "undefined" ? new AbortController() : null;
+      const signal = controller?.signal;
+      let timer;
+      if (controller && opts?.timeoutMs)
+        timer = setTimeout(() => controller.abort(), opts.timeoutMs);
+      const r = await fetchImpl(ctx.url, {
+        method: "POST",
+        headers: ctx.headers,
+        body,
+        signal
+      });
+      if (timer)
+        clearTimeout(timer);
+      const text = await r.text();
+      let parsed;
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        resCtx.error = new Error("Invalid JSON response");
+        resCtx.status = r.status;
+        return;
+      }
+      resCtx.response = parsed;
+      resCtx.status = r.status;
+    } catch (err) {
+      if (err.name === "AbortError")
+        resCtx.error = new Error("Request timed out");
+      else
+        resCtx.error = err;
+    }
+    await next();
+  };
+};
+
+// src/client.ts
+var GraphQLClient = class {
+  constructor(opts) {
+    this.url = opts.url;
+    this.tokenProvider = toAsyncTokenProvider(opts.tokenProvider);
+    this.headersFactory = toAsyncHeadersFactory(opts.headersFactory);
+    const base = [this.authMiddleware.bind(this)];
+    if (opts.middlewares)
+      base.push(...opts.middlewares);
+    base.push(createTransport({ fetchImpl: opts.fetchImpl, timeoutMs: opts.timeoutMs }));
+    this.middlewares = base;
+  }
+  async authMiddleware(ctx, resCtx, next) {
+    const token = await this.tokenProvider();
+    const dynamicHeaders = await this.headersFactory();
+    ctx.headers = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...dynamicHeaders,
+      ...token ? { Authorization: `Bearer ${token}` } : {},
+      ...ctx.headers ?? {}
+    };
+    await next();
+  }
+  // core request
+  async request(query, variables, options) {
+    const ctx = {
+      request: { query, variables },
+      url: this.url,
+      headers: options?.headers ?? {},
+      cacheOptions: options?.cacheOptions
+    };
+    const resCtx = {};
+    const runner = compose(this.middlewares);
+    await runner(ctx, resCtx);
+    if (resCtx.error)
+      throw resCtx.error;
+    if (!resCtx.response)
+      throw new Error("No response from GraphQL transport");
+    if (resCtx.response.errors && resCtx.response.errors.length) {
+      const e = resCtx.response.errors[0];
+      const err = new Error(e.message);
+      err.extensions = e.extensions;
+      throw err;
+    }
+    return resCtx.response;
+  }
+};
+
+// src/services/user.service.ts
+var GET_USER = `
+query GetUser($id: ID!) {
+  user(id: $id) {
+    id
+    name
+    email
+    role
+    balance { amount currency }
+  }
+}
+`;
+var createUserService = (client) => ({
+  async getUser(id) {
+    const res = await client.request(GET_USER, { id }, { cacheOptions: { skipCache: true } });
+    return res.data?.user ?? null;
+  }
+});
+
+// src/testing/mockClient.ts
+var createMockClient = (handler) => {
+  return {
+    request: async (query, variables) => {
+      return await handler({ query, variables });
+    }
+  };
+};
+export {
+  AuthenticationError,
+  GraphQLClient,
+  NetworkError,
+  SdkError,
+  createMockClient,
+  createUserService,
+  toAsyncHeadersFactory,
+  toAsyncTokenProvider
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@connect-plus-online/ogabai-integrations",
+    "version": "0.1.01",
+    "description": "Ogabai integrations for Connect Plus Online",
+    "keywords": [
+        "graphql",
+        "sdk",
+        "typescript",
+        "connecthive",
+        "ogabai",
+        "ogabai-integrations",
+        "connect-plus",
+        "connect-plus-online"
+    ],
+    "author": "Agu Chijioke <chokey2nv@gmail.com>",
+    "license": "MIT",
+    "main": "dist/index.cjs.js",
+    "module": "dist/index.esm.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsup src/index.ts --dts --format cjs,esm --out-dir dist",
+        "prepublishOnly": "yarn build",
+        "test": "vitest",
+        "lint": "eslint src --ext .ts"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "tsup": "^6.0.0",
+        "typescript": "^5.0.0",
+        "vitest": "^0.34.0"
+    }
+}