@qm-hub/sync-client-types 0.2.1

package/dist/index.js

@@ -0,0 +1,317 @@
+"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 index_exports = {};
+__export(index_exports, {
+  QmSyncClient: () => QmSyncClient,
+  createAuthHeaders: () => createAuthHeaders,
+  createSyncClientConfig: () => createSyncClientConfig,
+  fetchHttpClient: () => fetchHttpClient,
+  initialCheckpoint: () => initialCheckpoint,
+  withBearer: () => withBearer
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+async function fetchHttpClient(request) {
+  const headers = {
+    "Content-Type": request.headers.contentType,
+    "X-API-Key": request.headers.apiKey,
+    "X-App-Id": request.headers.appId
+  };
+  if (request.headers.authorization) {
+    headers["Authorization"] = request.headers.authorization;
+  }
+  try {
+    const response = await fetch(request.url, {
+      method: request.method,
+      headers,
+      body: request.body
+    });
+    return {
+      status: response.status,
+      body: await response.text()
+    };
+  } catch (error) {
+    throw new Error(
+      `HTTP request failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+var QmSyncClient = class {
+  constructor(config, http = fetchHttpClient) {
+    this.config = config;
+    this.http = http;
+    this._accessToken = null;
+    this._refreshToken = null;
+    this._userId = null;
+  }
+  // =========================================================================
+  // Authentication
+  // =========================================================================
+  /**
+   * Register a new user.
+   */
+  async register(username, email, password) {
+    const url = `${this.config.serverUrl}/api/v1/auth/register`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ username, email, password });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(
+        `Registration failed: ${response.status} - ${response.body}`
+      );
+    }
+    const auth = JSON.parse(response.body);
+    this.storeTokens(auth);
+    console.log("Registered user:", auth.userId);
+    return auth;
+  }
+  /**
+   * Login with email and password.
+   */
+  async login(email, password) {
+    const url = `${this.config.serverUrl}/api/v1/auth/login`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ email, password });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(`Login failed: ${response.status} - ${response.body}`);
+    }
+    const auth = JSON.parse(response.body);
+    this.storeTokens(auth);
+    console.log("Logged in user:", auth.userId);
+    return auth;
+  }
+  /**
+   * Refresh the access token.
+   * Note: Named `refreshToken` to match Rust API (singular).
+   */
+  async refreshToken() {
+    if (!this._refreshToken) {
+      throw new Error("Not authenticated - please login first");
+    }
+    const url = `${this.config.serverUrl}/api/v1/auth/refresh`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ refreshToken: this._refreshToken });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(
+        `Token refresh failed: ${response.status} - ${response.body}`
+      );
+    }
+    const refresh = JSON.parse(response.body);
+    this._accessToken = refresh.accessToken;
+    this._refreshToken = refresh.refreshToken;
+    console.log("Token refreshed successfully");
+  }
+  /**
+   * Logout and clear tokens.
+   */
+  logout() {
+    this._accessToken = null;
+    this._refreshToken = null;
+    this._userId = null;
+    console.log("Logged out");
+  }
+  /**
+   * Check if the client is authenticated.
+   */
+  isAuthenticated() {
+    return this._accessToken !== null;
+  }
+  /**
+   * Set tokens directly (for restoring from storage).
+   */
+  setTokens(accessToken, refreshToken, userId) {
+    this._accessToken = accessToken;
+    this._refreshToken = refreshToken;
+    this._userId = userId ?? null;
+  }
+  /**
+   * Get current tokens (for persisting to storage).
+   */
+  getTokens() {
+    return { accessToken: this._accessToken, refreshToken: this._refreshToken };
+  }
+  /**
+   * Get current user ID.
+   */
+  getUserId() {
+    return this._userId;
+  }
+  // =========================================================================
+  // Sync Operations
+  // =========================================================================
+  /**
+   * Push local changes to the server.
+   */
+  async push(records) {
+    const request = {
+      records: records.map(this.syncToPushRecord),
+      clientTimestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/push`;
+    return this.authenticatedPost(url, request);
+  }
+  /**
+   * Pull changes from the server.
+   */
+  async pull(checkpoint, batchSize) {
+    const request = {
+      checkpoint,
+      batchSize: batchSize ?? this.config.defaultBatchSize
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/pull`;
+    return this.authenticatedPost(url, request);
+  }
+  /**
+   * Perform a delta sync (push + pull in one request).
+   */
+  async delta(records, checkpoint) {
+    const request = {
+      push: records.length > 0 ? {
+        records: records.map(this.syncToPushRecord),
+        clientTimestamp: (/* @__PURE__ */ new Date()).toISOString()
+      } : void 0,
+      pull: {
+        checkpoint,
+        batchSize: this.config.defaultBatchSize
+      }
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/delta`;
+    return this.authenticatedPost(url, request);
+  }
+  // =========================================================================
+  // Internal Helpers
+  // =========================================================================
+  buildHeaders(accessToken) {
+    const headers = {
+      apiKey: this.config.apiKey,
+      appId: this.config.appId,
+      contentType: "application/json"
+    };
+    if (accessToken) {
+      headers.authorization = `Bearer ${accessToken}`;
+    }
+    return headers;
+  }
+  storeTokens(auth) {
+    this._accessToken = auth.accessToken;
+    this._refreshToken = auth.refreshToken;
+    this._userId = auth.userId;
+  }
+  isSuccess(response) {
+    return response.status >= 200 && response.status < 300;
+  }
+  isUnauthorized(response) {
+    return response.status === 401;
+  }
+  async authenticatedPost(url, body) {
+    if (!this._accessToken) {
+      throw new Error("Not authenticated - please login first");
+    }
+    const headers = this.buildHeaders(this._accessToken);
+    const bodyJson = JSON.stringify(body);
+    let response = await this.http({
+      method: "POST",
+      url,
+      headers,
+      body: bodyJson
+    });
+    if (this.isUnauthorized(response)) {
+      console.warn("Access token expired, attempting refresh");
+      await this.refreshToken();
+      const newHeaders = this.buildHeaders(this._accessToken);
+      response = await this.http({
+        method: "POST",
+        url,
+        headers: newHeaders,
+        body: bodyJson
+      });
+      if (!this.isSuccess(response)) {
+        console.error(
+          "Request failed after token refresh:",
+          response.status,
+          response.body
+        );
+        throw new Error(
+          `Request failed: ${response.status} - ${response.body}`
+        );
+      }
+      return JSON.parse(response.body);
+    }
+    if (!this.isSuccess(response)) {
+      console.error("Request failed:", response.status, response.body);
+      throw new Error(`Request failed: ${response.status} - ${response.body}`);
+    }
+    return JSON.parse(response.body);
+  }
+  syncToPushRecord(record) {
+    return {
+      tableName: record.tableName,
+      rowId: record.rowId,
+      data: record.data,
+      version: record.version,
+      deleted: record.deleted,
+      assumedServerVersion: void 0
+      // Match Rust: always None for now
+    };
+  }
+};
+
+// src/index.ts
+function createAuthHeaders(apiKey, appId) {
+  return {
+    apiKey,
+    appId,
+    contentType: "application/json"
+  };
+}
+function withBearer(headers, token) {
+  return {
+    ...headers,
+    authorization: `Bearer ${token}`
+  };
+}
+function createSyncClientConfig(serverUrl, appId, apiKey, options) {
+  return {
+    serverUrl,
+    appId,
+    apiKey,
+    defaultBatchSize: options?.defaultBatchSize ?? 100,
+    timeoutMs: options?.timeoutMs ?? 3e4
+  };
+}
+function initialCheckpoint() {
+  return {
+    updatedAt: "1970-01-01T00:00:00Z",
+    id: ""
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  QmSyncClient,
+  createAuthHeaders,
+  createSyncClientConfig,
+  fetchHttpClient,
+  initialCheckpoint,
+  withBearer
+});

package/dist/index.mjs

@@ -0,0 +1,285 @@
+// src/client.ts
+async function fetchHttpClient(request) {
+  const headers = {
+    "Content-Type": request.headers.contentType,
+    "X-API-Key": request.headers.apiKey,
+    "X-App-Id": request.headers.appId
+  };
+  if (request.headers.authorization) {
+    headers["Authorization"] = request.headers.authorization;
+  }
+  try {
+    const response = await fetch(request.url, {
+      method: request.method,
+      headers,
+      body: request.body
+    });
+    return {
+      status: response.status,
+      body: await response.text()
+    };
+  } catch (error) {
+    throw new Error(
+      `HTTP request failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+var QmSyncClient = class {
+  constructor(config, http = fetchHttpClient) {
+    this.config = config;
+    this.http = http;
+    this._accessToken = null;
+    this._refreshToken = null;
+    this._userId = null;
+  }
+  // =========================================================================
+  // Authentication
+  // =========================================================================
+  /**
+   * Register a new user.
+   */
+  async register(username, email, password) {
+    const url = `${this.config.serverUrl}/api/v1/auth/register`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ username, email, password });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(
+        `Registration failed: ${response.status} - ${response.body}`
+      );
+    }
+    const auth = JSON.parse(response.body);
+    this.storeTokens(auth);
+    console.log("Registered user:", auth.userId);
+    return auth;
+  }
+  /**
+   * Login with email and password.
+   */
+  async login(email, password) {
+    const url = `${this.config.serverUrl}/api/v1/auth/login`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ email, password });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(`Login failed: ${response.status} - ${response.body}`);
+    }
+    const auth = JSON.parse(response.body);
+    this.storeTokens(auth);
+    console.log("Logged in user:", auth.userId);
+    return auth;
+  }
+  /**
+   * Refresh the access token.
+   * Note: Named `refreshToken` to match Rust API (singular).
+   */
+  async refreshToken() {
+    if (!this._refreshToken) {
+      throw new Error("Not authenticated - please login first");
+    }
+    const url = `${this.config.serverUrl}/api/v1/auth/refresh`;
+    const headers = this.buildHeaders();
+    const body = JSON.stringify({ refreshToken: this._refreshToken });
+    const response = await this.http({ method: "POST", url, headers, body });
+    if (!this.isSuccess(response)) {
+      throw new Error(
+        `Token refresh failed: ${response.status} - ${response.body}`
+      );
+    }
+    const refresh = JSON.parse(response.body);
+    this._accessToken = refresh.accessToken;
+    this._refreshToken = refresh.refreshToken;
+    console.log("Token refreshed successfully");
+  }
+  /**
+   * Logout and clear tokens.
+   */
+  logout() {
+    this._accessToken = null;
+    this._refreshToken = null;
+    this._userId = null;
+    console.log("Logged out");
+  }
+  /**
+   * Check if the client is authenticated.
+   */
+  isAuthenticated() {
+    return this._accessToken !== null;
+  }
+  /**
+   * Set tokens directly (for restoring from storage).
+   */
+  setTokens(accessToken, refreshToken, userId) {
+    this._accessToken = accessToken;
+    this._refreshToken = refreshToken;
+    this._userId = userId ?? null;
+  }
+  /**
+   * Get current tokens (for persisting to storage).
+   */
+  getTokens() {
+    return { accessToken: this._accessToken, refreshToken: this._refreshToken };
+  }
+  /**
+   * Get current user ID.
+   */
+  getUserId() {
+    return this._userId;
+  }
+  // =========================================================================
+  // Sync Operations
+  // =========================================================================
+  /**
+   * Push local changes to the server.
+   */
+  async push(records) {
+    const request = {
+      records: records.map(this.syncToPushRecord),
+      clientTimestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/push`;
+    return this.authenticatedPost(url, request);
+  }
+  /**
+   * Pull changes from the server.
+   */
+  async pull(checkpoint, batchSize) {
+    const request = {
+      checkpoint,
+      batchSize: batchSize ?? this.config.defaultBatchSize
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/pull`;
+    return this.authenticatedPost(url, request);
+  }
+  /**
+   * Perform a delta sync (push + pull in one request).
+   */
+  async delta(records, checkpoint) {
+    const request = {
+      push: records.length > 0 ? {
+        records: records.map(this.syncToPushRecord),
+        clientTimestamp: (/* @__PURE__ */ new Date()).toISOString()
+      } : void 0,
+      pull: {
+        checkpoint,
+        batchSize: this.config.defaultBatchSize
+      }
+    };
+    const url = `${this.config.serverUrl}/api/v1/sync/${this.config.appId}/delta`;
+    return this.authenticatedPost(url, request);
+  }
+  // =========================================================================
+  // Internal Helpers
+  // =========================================================================
+  buildHeaders(accessToken) {
+    const headers = {
+      apiKey: this.config.apiKey,
+      appId: this.config.appId,
+      contentType: "application/json"
+    };
+    if (accessToken) {
+      headers.authorization = `Bearer ${accessToken}`;
+    }
+    return headers;
+  }
+  storeTokens(auth) {
+    this._accessToken = auth.accessToken;
+    this._refreshToken = auth.refreshToken;
+    this._userId = auth.userId;
+  }
+  isSuccess(response) {
+    return response.status >= 200 && response.status < 300;
+  }
+  isUnauthorized(response) {
+    return response.status === 401;
+  }
+  async authenticatedPost(url, body) {
+    if (!this._accessToken) {
+      throw new Error("Not authenticated - please login first");
+    }
+    const headers = this.buildHeaders(this._accessToken);
+    const bodyJson = JSON.stringify(body);
+    let response = await this.http({
+      method: "POST",
+      url,
+      headers,
+      body: bodyJson
+    });
+    if (this.isUnauthorized(response)) {
+      console.warn("Access token expired, attempting refresh");
+      await this.refreshToken();
+      const newHeaders = this.buildHeaders(this._accessToken);
+      response = await this.http({
+        method: "POST",
+        url,
+        headers: newHeaders,
+        body: bodyJson
+      });
+      if (!this.isSuccess(response)) {
+        console.error(
+          "Request failed after token refresh:",
+          response.status,
+          response.body
+        );
+        throw new Error(
+          `Request failed: ${response.status} - ${response.body}`
+        );
+      }
+      return JSON.parse(response.body);
+    }
+    if (!this.isSuccess(response)) {
+      console.error("Request failed:", response.status, response.body);
+      throw new Error(`Request failed: ${response.status} - ${response.body}`);
+    }
+    return JSON.parse(response.body);
+  }
+  syncToPushRecord(record) {
+    return {
+      tableName: record.tableName,
+      rowId: record.rowId,
+      data: record.data,
+      version: record.version,
+      deleted: record.deleted,
+      assumedServerVersion: void 0
+      // Match Rust: always None for now
+    };
+  }
+};
+
+// src/index.ts
+function createAuthHeaders(apiKey, appId) {
+  return {
+    apiKey,
+    appId,
+    contentType: "application/json"
+  };
+}
+function withBearer(headers, token) {
+  return {
+    ...headers,
+    authorization: `Bearer ${token}`
+  };
+}
+function createSyncClientConfig(serverUrl, appId, apiKey, options) {
+  return {
+    serverUrl,
+    appId,
+    apiKey,
+    defaultBatchSize: options?.defaultBatchSize ?? 100,
+    timeoutMs: options?.timeoutMs ?? 3e4
+  };
+}
+function initialCheckpoint() {
+  return {
+    updatedAt: "1970-01-01T00:00:00Z",
+    id: ""
+  };
+}
+export {
+  QmSyncClient,
+  createAuthHeaders,
+  createSyncClientConfig,
+  fetchHttpClient,
+  initialCheckpoint,
+  withBearer
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@qm-hub/sync-client-types",
+    "version": "0.2.1",
+    "description": "TypeScript types for qm-sync-client - generated from Rust with Specta",
+    "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"
+    ],
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts",
+        "prepublishOnly": "npm run build"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://https://github.com/loidinhm31/qm-hub.git"
+    },
+    "license": "MIT",
+    "keywords": [
+        "qm-sync",
+        "sync",
+        "typescript",
+        "types"
+    ]
+}