@howuse/feedback 0.1.0

package/README.md

@@ -0,0 +1,237 @@
+# @howuse/feedback
+
+Node.js/Electron SDK for user feedback and activation management.
+
+## 安装
+
+```bash
+npm install @howuse/feedback
+```
+
+或者使用本地路径安装：
+
+```bash
+npm install ./feedback-sdk
+```
+
+## 快速开始
+
+### Node.js 示例
+
+```typescript
+import { initFeedbackClient } from '@howuse/feedback';
+
+async function main() {
+  // 初始化客户端
+  const client = await initFeedbackClient({
+    baseUrl: 'http://localhost:8080',
+    softwareId: 1,
+    version: '1.0.0',
+  });
+
+  // 检查是否可用
+  if (!client.enabled) {
+    console.warn('SDK is disabled, some features may not work');
+    return;
+  }
+
+  // 提交反馈
+  const feedbackResult = await client.feedback({
+    content: 'This is a test feedback',
+    email: 'user@example.com', // 可选
+  });
+  console.log('Feedback result:', feedbackResult);
+
+  // 激活软件
+  const activateResult = await client.activate({
+    machineCode: 'your-machine-code',
+    code: 'your-activation-code',
+  });
+  console.log('Activation result:', activateResult);
+
+  // 检查激活状态
+  const checkResult = await client.check({
+    machineCode: 'your-machine-code',
+  });
+  if (checkResult.expired) {
+    console.log('License expired:', checkResult.reason);
+  } else {
+    console.log('License valid until:', checkResult.expireAt);
+  }
+}
+
+main().catch(console.error);
+```
+
+### Electron 主进程示例
+
+在 Electron 的 `main.js` 或 `main.ts` 中：
+
+```typescript
+import { app, BrowserWindow } from 'electron';
+import { initFeedbackClient } from '@howuse/feedback';
+
+let feedbackClient: any;
+
+async function initApp() {
+  // 初始化 SDK
+  feedbackClient = await initFeedbackClient({
+    baseUrl: 'http://localhost:8080',
+    softwareId: 1,
+    version: app.getVersion(),
+  });
+
+  // 根据 enabled 状态决定是否显示反馈入口
+  if (feedbackClient.enabled) {
+    // 可以设置全局菜单或窗口中的反馈按钮
+  }
+}
+
+app.whenReady().then(() => {
+  initApp();
+  createWindow();
+});
+```
+
+## API 参考
+
+### `initFeedbackClient(options: InitOptions): Promise<FeedbackClient>`
+
+初始化 Feedback 客户端。
+
+**参数：**
+
+- `options.baseUrl` (string): 服务器基础 URL
+- `options.softwareId` (number): 软件 ID
+- `options.version` (string): 软件版本号
+- `options.timeoutMs` (number, 可选): 请求超时时间（毫秒），默认 30000
+
+**返回值：**
+
+返回一个 `FeedbackClient` 实例。即使初始化失败，也不会抛出异常，而是返回 `enabled=false` 的客户端。
+
+### `FeedbackClient`
+
+#### 属性
+
+- `enabled: boolean` - 指示 SDK 是否可用
+
+#### 方法
+
+##### `feedback(data: FeedbackPayload): Promise<FeedbackResult>`
+
+提交用户反馈。
+
+**参数：**
+
+- `data.content` (string): 反馈内容（必填）
+- `data.email` (string, 可选): 邮箱地址
+
+**返回值：**
+
+```typescript
+{
+  success: boolean;
+  id?: number;
+  error?: string;
+}
+```
+
+##### `activate(data: ActivationRequest): Promise<ActivationResult>`
+
+激活软件。
+
+**参数：**
+
+- `data.machineCode` (string): 机器码
+- `data.code` (string): 激活码
+
+**返回值：**
+
+```typescript
+{
+  success: boolean;
+  expireAt?: string;
+  error?: string;
+}
+```
+
+##### `check(data: ActivationCheckRequest): Promise<ActivationCheckResponse>`
+
+检查激活状态。
+
+**重要：** 如果调用失败（网络错误或服务器返回非 2xx），SDK 会直接返回 `expired: true`，而不是抛出异常。这确保了在无法联系服务端时，默认按"授权已到期"处理。
+
+**参数：**
+
+- `data.machineCode` (string): 机器码
+
+**返回值：**
+
+```typescript
+{
+  expired: boolean;
+  activated?: boolean;
+  expireAt?: string;
+  reason?: string;
+}
+```
+
+## 错误处理
+
+SDK 采用"安全降级"策略：
+
+1. **初始化失败**：不会抛出异常，而是返回 `enabled=false` 的客户端
+2. **方法调用**：当 `enabled=false` 时，所有方法都会返回失败结果，而不是抛出异常
+3. **激活检查失败**：`check` 方法在失败时会返回 `expired: true`，确保在无法联系服务端时默认按"授权已到期"处理
+
+## 动态库支持
+
+SDK 支持通过 Go 语言实现的动态库（native library）提供所有 HTTP 请求功能。如果动态库可用，SDK 会自动使用；否则会回退到纯 HTTP 实现。
+
+### 动态库构建
+
+动态库使用 Go 语言实现，源码位于项目根目录的 `native-sdk/` 目录。构建方法：
+
+```bash
+# macOS/Linux
+cd native-sdk
+./build.sh
+
+# Windows
+cd native-sdk
+build.bat
+```
+
+构建完成后，动态库文件会输出到 `feedback-sdk/native/` 目录：
+
+- macOS: `native/libhowuse_feedback.dylib`
+- Windows: `native/howuse_feedback.dll`
+- Linux: `native/libhowuse_feedback.so`
+
+### 动态库优势
+
+- **性能优化**：所有 HTTP 请求在 Go 层执行，性能更好
+- **代码保护**：业务逻辑在编译后的动态库中，不易被逆向
+- **统一实现**：HTTP 客户端逻辑统一在 Go 层管理
+
+详细构建说明请参考 [native-sdk/README.md](./native-sdk/README.md)。
+
+## 类型定义
+
+所有类型都可以从包中导入：
+
+```typescript
+import type {
+  InitOptions,
+  FeedbackPayload,
+  ActivationRequest,
+  ActivationCheckRequest,
+  // ... 其他类型
+} from '@howuse/feedback';
+```
+
+## 许可证
+
+MIT
+

package/dist/index.cjs

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const koffi = require("koffi");
+const path = require("path");
+const fs = require("fs");
+function tryLoadNativeLibrary() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const packageRoot = path.resolve(__dirname, "..");
+  let libName;
+  if (platform === "darwin") {
+    if (arch === "arm64") {
+      libName = "libhowuse_feedback_arm64.dylib";
+    } else {
+      libName = "libhowuse_feedback.dylib";
+    }
+  } else if (platform === "win32") {
+    libName = "howuse_feedback.dll";
+  } else if (platform === "linux") {
+    libName = "libhowuse_feedback.so";
+  } else {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+  const libPath = path.join(packageRoot, "native", libName);
+  if (!fs.existsSync(libPath)) {
+    throw new Error(`Native library not found: ${libPath}. Please run 'npm run build:native' first.`);
+  }
+  try {
+    return koffi.load(libPath);
+  } catch (error) {
+    throw new Error(`Failed to load native library from ${libPath}: ${error.message}`);
+  }
+}
+function createNativeClient() {
+  const lib = tryLoadNativeLibrary();
+  const InitClient = lib.func("InitClient", "str", ["str"]);
+  const SubmitFeedback = lib.func("SubmitFeedback", "str", ["str"]);
+  const Activate = lib.func("Activate", "str", ["str"]);
+  const CheckActivation = lib.func("CheckActivation", "str", ["str"]);
+  return {
+    async initClient(options) {
+      const json = JSON.stringify(options);
+      const result = InitClient(json);
+      return JSON.parse(result);
+    },
+    async submitFeedback(payload, softwareId) {
+      const json = JSON.stringify({ ...payload, softwareId });
+      const result = SubmitFeedback(json);
+      return JSON.parse(result);
+    },
+    async activate(request, softwareId) {
+      const json = JSON.stringify({ ...request, softwareId });
+      const result = Activate(json);
+      return JSON.parse(result);
+    },
+    async checkActivation(request, softwareId) {
+      const json = JSON.stringify({ ...request, softwareId });
+      const result = CheckActivation(json);
+      return JSON.parse(result);
+    }
+  };
+}
+class FeedbackClient {
+  constructor(enabled, baseUrl, softwareId, version, nativeClient) {
+    this.enabled = enabled;
+    this.baseUrl = baseUrl;
+    this.softwareId = softwareId;
+    this.version = version;
+    this.nativeClient = nativeClient;
+  }
+  /**
+   * 提交反馈
+   */
+  async feedback(data) {
+    if (!this.enabled) {
+      return {
+        success: false,
+        error: "sdk_disabled"
+      };
+    }
+    return this.nativeClient.submitFeedback(data, this.softwareId);
+  }
+  /**
+   * 激活软件
+   */
+  async activate(data) {
+    if (!this.enabled) {
+      return {
+        success: false,
+        error: "sdk_disabled"
+      };
+    }
+    return this.nativeClient.activate(data, this.softwareId);
+  }
+  /**
+   * 检查激活状态
+   */
+  async check(data) {
+    if (!this.enabled) {
+      return {
+        expired: true,
+        reason: "sdk_disabled_or_init_failed"
+      };
+    }
+    try {
+      const result = await this.nativeClient.checkActivation(data, this.softwareId);
+      if (!result.expired && !result.activated) {
+        return {
+          expired: true,
+          reason: "Not activated"
+        };
+      }
+      return result;
+    } catch (error) {
+      return {
+        expired: true,
+        reason: error.message || "Activation check failed"
+      };
+    }
+  }
+}
+async function initFeedbackClient(options) {
+  if (!options.baseUrl || !options.softwareId || !options.version) {
+    throw new Error("baseUrl, softwareId, and version are required");
+  }
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const nativeClient = createNativeClient();
+  let initResult;
+  try {
+    initResult = await nativeClient.initClient({
+      ...options,
+      baseUrl
+    });
+  } catch (error) {
+    return new FeedbackClient(false, baseUrl, options.softwareId, options.version, nativeClient);
+  }
+  return new FeedbackClient(
+    initResult.enabled,
+    baseUrl,
+    options.softwareId,
+    options.version,
+    nativeClient
+  );
+}
+exports.FeedbackClient = FeedbackClient;
+exports.initFeedbackClient = initFeedbackClient;

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { type NativeClient } from './native';
+import type { InitOptions, FeedbackPayload, FeedbackResult, ActivationRequest, ActivationResult, ActivationCheckRequest, ActivationCheckResponse } from './types';
+/**
+ * FeedbackClient 类
+ */
+export declare class FeedbackClient {
+    readonly enabled: boolean;
+    private readonly baseUrl;
+    private readonly softwareId;
+    private readonly version;
+    private readonly nativeClient;
+    constructor(enabled: boolean, baseUrl: string, softwareId: number, version: string, nativeClient: NativeClient);
+    /**
+     * 提交反馈
+     */
+    feedback(data: FeedbackPayload): Promise<FeedbackResult>;
+    /**
+     * 激活软件
+     */
+    activate(data: ActivationRequest): Promise<ActivationResult>;
+    /**
+     * 检查激活状态
+     */
+    check(data: ActivationCheckRequest): Promise<ActivationCheckResponse>;
+}
+/**
+ * 初始化 Feedback 客户端
+ * @param options 初始化选项
+ * @returns Promise<FeedbackClient>
+ */
+export declare function initFeedbackClient(options: InitOptions): Promise<FeedbackClient>;
+export type { InitOptions, InitResult, FeedbackPayload, FeedbackResult, ActivationRequest, ActivationResult, ActivationCheckRequest, ActivationCheckResponse, } from './types';

package/dist/index.mjs

@@ -0,0 +1,146 @@
+const koffi = require("koffi");
+const path = require("path");
+const fs = require("fs");
+function tryLoadNativeLibrary() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const packageRoot = path.resolve(__dirname, "..");
+  let libName;
+  if (platform === "darwin") {
+    if (arch === "arm64") {
+      libName = "libhowuse_feedback_arm64.dylib";
+    } else {
+      libName = "libhowuse_feedback.dylib";
+    }
+  } else if (platform === "win32") {
+    libName = "howuse_feedback.dll";
+  } else if (platform === "linux") {
+    libName = "libhowuse_feedback.so";
+  } else {
+    throw new Error(`Unsupported platform: ${platform}`);
+  }
+  const libPath = path.join(packageRoot, "native", libName);
+  if (!fs.existsSync(libPath)) {
+    throw new Error(`Native library not found: ${libPath}. Please run 'npm run build:native' first.`);
+  }
+  try {
+    return koffi.load(libPath);
+  } catch (error) {
+    throw new Error(`Failed to load native library from ${libPath}: ${error.message}`);
+  }
+}
+function createNativeClient() {
+  const lib = tryLoadNativeLibrary();
+  const InitClient = lib.func("InitClient", "str", ["str"]);
+  const SubmitFeedback = lib.func("SubmitFeedback", "str", ["str"]);
+  const Activate = lib.func("Activate", "str", ["str"]);
+  const CheckActivation = lib.func("CheckActivation", "str", ["str"]);
+  return {
+    async initClient(options) {
+      const json = JSON.stringify(options);
+      const result = InitClient(json);
+      return JSON.parse(result);
+    },
+    async submitFeedback(payload, softwareId) {
+      const json = JSON.stringify({ ...payload, softwareId });
+      const result = SubmitFeedback(json);
+      return JSON.parse(result);
+    },
+    async activate(request, softwareId) {
+      const json = JSON.stringify({ ...request, softwareId });
+      const result = Activate(json);
+      return JSON.parse(result);
+    },
+    async checkActivation(request, softwareId) {
+      const json = JSON.stringify({ ...request, softwareId });
+      const result = CheckActivation(json);
+      return JSON.parse(result);
+    }
+  };
+}
+class FeedbackClient {
+  constructor(enabled, baseUrl, softwareId, version, nativeClient) {
+    this.enabled = enabled;
+    this.baseUrl = baseUrl;
+    this.softwareId = softwareId;
+    this.version = version;
+    this.nativeClient = nativeClient;
+  }
+  /**
+   * 提交反馈
+   */
+  async feedback(data) {
+    if (!this.enabled) {
+      return {
+        success: false,
+        error: "sdk_disabled"
+      };
+    }
+    return this.nativeClient.submitFeedback(data, this.softwareId);
+  }
+  /**
+   * 激活软件
+   */
+  async activate(data) {
+    if (!this.enabled) {
+      return {
+        success: false,
+        error: "sdk_disabled"
+      };
+    }
+    return this.nativeClient.activate(data, this.softwareId);
+  }
+  /**
+   * 检查激活状态
+   */
+  async check(data) {
+    if (!this.enabled) {
+      return {
+        expired: true,
+        reason: "sdk_disabled_or_init_failed"
+      };
+    }
+    try {
+      const result = await this.nativeClient.checkActivation(data, this.softwareId);
+      if (!result.expired && !result.activated) {
+        return {
+          expired: true,
+          reason: "Not activated"
+        };
+      }
+      return result;
+    } catch (error) {
+      return {
+        expired: true,
+        reason: error.message || "Activation check failed"
+      };
+    }
+  }
+}
+async function initFeedbackClient(options) {
+  if (!options.baseUrl || !options.softwareId || !options.version) {
+    throw new Error("baseUrl, softwareId, and version are required");
+  }
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const nativeClient = createNativeClient();
+  let initResult;
+  try {
+    initResult = await nativeClient.initClient({
+      ...options,
+      baseUrl
+    });
+  } catch (error) {
+    return new FeedbackClient(false, baseUrl, options.softwareId, options.version, nativeClient);
+  }
+  return new FeedbackClient(
+    initResult.enabled,
+    baseUrl,
+    options.softwareId,
+    options.version,
+    nativeClient
+  );
+}
+export {
+  FeedbackClient,
+  initFeedbackClient
+};

package/dist/native/index.d.ts

@@ -0,0 +1,14 @@
+import type { InitOptions, InitResult, FeedbackPayload, FeedbackResult, ActivationRequest, ActivationResult, ActivationCheckRequest, ActivationCheckResponse } from '../types';
+/**
+ * Native 客户端接口
+ */
+export interface NativeClient {
+    initClient(options: InitOptions): Promise<InitResult>;
+    submitFeedback(payload: FeedbackPayload, softwareId: number): Promise<FeedbackResult>;
+    activate(request: ActivationRequest, softwareId: number): Promise<ActivationResult>;
+    checkActivation(request: ActivationCheckRequest, softwareId: number): Promise<ActivationCheckResponse>;
+}
+/**
+ * 创建 Native 客户端
+ */
+export declare function createNativeClient(): NativeClient;

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 初始化选项
+ */
+export interface InitOptions {
+    /** 服务器基础 URL */
+    baseUrl: string;
+    /** 软件 ID */
+    softwareId: number;
+    /** 软件版本号 */
+    version: string;
+    /** 请求超时时间（毫秒），可选 */
+    timeoutMs?: number;
+}
+/**
+ * 初始化结果
+ */
+export interface InitResult {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 错误信息（如果初始化失败） */
+    error?: string;
+}
+/**
+ * 版本信息请求
+ */
+export interface VersionRequest {
+    softwareId: number;
+    version: string;
+}
+/**
+ * 版本信息响应
+ */
+export interface VersionResponse {
+    ok: boolean;
+    id?: number;
+    error?: string;
+}
+/**
+ * 活跃度上报请求
+ */
+export interface ActivityRequest {
+    softwareId: number;
+}
+/**
+ * 活跃度上报响应
+ */
+export interface ActivityResponse {
+    ok: boolean;
+    id?: number;
+    error?: string;
+}
+/**
+ * 反馈提交请求
+ */
+export interface FeedbackPayload {
+    /** 反馈内容 */
+    content: string;
+    /** 邮箱（可选） */
+    email?: string;
+}
+/**
+ * 反馈提交响应
+ */
+export interface FeedbackResult {
+    success: boolean;
+    id?: number;
+    error?: string;
+}
+/**
+ * 激活请求
+ */
+export interface ActivationRequest {
+    /** 机器码 */
+    machineCode: string;
+    /** 激活码 */
+    code: string;
+}
+/**
+ * 激活响应
+ */
+export interface ActivationResult {
+    success: boolean;
+    expireAt?: string;
+    error?: string;
+}
+/**
+ * 激活检查请求
+ */
+export interface ActivationCheckRequest {
+    /** 机器码 */
+    machineCode: string;
+}
+/**
+ * 激活检查响应
+ */
+export interface ActivationCheckResponse {
+    /** 是否过期 */
+    expired: boolean;
+    /** 是否已激活 */
+    activated?: boolean;
+    /** 过期时间 */
+    expireAt?: string;
+    /** 错误原因 */
+    reason?: string;
+}

package/native/howuse_feedback.h

@@ -0,0 +1,90 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package command-line-arguments */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 3 "main.go"
+
+#include <stdlib.h>
+
+#line 1 "cgo-generated-wrapper"
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern __declspec(dllexport) char* InitClient(char* jsonOptions);
+extern __declspec(dllexport) char* SubmitFeedback(char* jsonPayload);
+extern __declspec(dllexport) char* Activate(char* jsonRequest);
+extern __declspec(dllexport) char* CheckActivation(char* jsonRequest);
+extern __declspec(dllexport) void FreeString(char* ptr);
+
+#ifdef __cplusplus
+}
+#endif

package/native/libhowuse_feedback.h

@@ -0,0 +1,90 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package command-line-arguments */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 3 "main.go"
+
+#include <stdlib.h>
+
+#line 1 "cgo-generated-wrapper"
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* InitClient(char* jsonOptions);
+extern char* SubmitFeedback(char* jsonPayload);
+extern char* Activate(char* jsonRequest);
+extern char* CheckActivation(char* jsonRequest);
+extern void FreeString(char* ptr);
+
+#ifdef __cplusplus
+}
+#endif

package/native/libhowuse_feedback_arm64.h

@@ -0,0 +1,90 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package command-line-arguments */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 3 "main.go"
+
+#include <stdlib.h>
+
+#line 1 "cgo-generated-wrapper"
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* InitClient(char* jsonOptions);
+extern char* SubmitFeedback(char* jsonPayload);
+extern char* Activate(char* jsonRequest);
+extern char* CheckActivation(char* jsonRequest);
+extern void FreeString(char* ptr);
+
+#ifdef __cplusplus
+}
+#endif

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@howuse/feedback",
+  "version": "0.1.0",
+  "description": "Node.js/Electron SDK for user feedback and activation management",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build:native": "cd native-sdk && bash build.sh",
+    "build:js": "vite build && tsc --emitDeclarationOnly --outDir dist",
+    "build": "npm run build:native && npm run build:js",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "feedback",
+    "activation",
+    "sdk",
+    "electron"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "koffi": "^2.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "native",
+    "README.md"
+  ]
+}
+