Fix memory leak

examples/basic/index.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Basic example module for zig-napi
+ * OpenHarmony/HarmonyNext native module written in Zig
+ */
+
+// ============== Number Functions ==============
+
+/**
+ * Adds two 32-bit signed integers
+ * @param left - The first integer
+ * @param right - The second integer
+ * @returns The sum of left and right
+ */
+export function test_i32(left: number, right: number): number;
+
+/**
+ * Adds two 32-bit floating-point numbers
+ * @param left - The first float
+ * @param right - The second float
+ * @returns The sum of left and right
+ */
+export function test_f32(left: number, right: number): number;
+
+/**
+ * Adds two 32-bit unsigned integers
+ * @param left - The first unsigned integer
+ * @param right - The second unsigned integer
+ * @returns The sum of left and right
+ */
+export function test_u32(left: number, right: number): number;
+
+// ============== String Functions ==============
+
+/**
+ * Returns a greeting message
+ * @param name - The name to greet
+ * @returns A greeting string "Hello, {name}!"
+ */
+export function hello(name: string): string;
+
+/**
+ * A constant text string
+ */
+export const text: string;
+
+// ============== Error Functions ==============
+
+/**
+ * Throws a test error
+ * @throws {Error} Always throws an error with reason "test"
+ */
+export function throw_error(): void;
+
+// ============== Worker Functions ==============
+
+/**
+ * Calculates fibonacci number asynchronously (fire and forget)
+ * @param n - The fibonacci index
+ */
+export function fib(n: number): void;
+
+/**
+ * Calculates fibonacci number asynchronously with Promise
+ * @param n - The fibonacci index
+ * @returns A Promise that resolves when calculation is complete
+ */
+export function fib_async(n: number): Promise<void>;
+
+// ============== Array Functions ==============
+
+/**
+ * Takes an array and returns it
+ * @param array - An array of numbers
+ * @returns The same array
+ */
+export function get_and_return_array(array: number[]): number[];
+
+/**
+ * Takes a tuple array and returns it
+ * @param array - A tuple of [number, boolean, string]
+ * @returns The same tuple
+ */
+export function get_named_array(array: [number, boolean, string]): [number, boolean, string];
+
+/**
+ * Takes an ArrayList and returns it
+ * @param array - An array of numbers
+ * @returns The same array
+ */
+export function get_arraylist(array: number[]): number[];
+
+// ============== Object Types ==============
+
+/**
+ * Full field object with all required fields
+ */
+export interface FullField {
+  name: string;
+  age: number;
+  is_student: boolean;
+}
+
+/**
+ * Object with optional fields
+ */
+export interface OptionalField {
+  name: string;
+  age?: number;
+  is_student?: boolean;
+}
+
+/**
+ * Object with nullable field
+ */
+export interface NullableField {
+  name: string | null;
+}
+
+// ============== Object Functions ==============
+
+/**
+ * Takes a full field object and returns it
+ * @param config - Object with name, age, and is_student
+ * @returns The same object
+ */
+export function get_object(config: FullField): FullField;
+
+/**
+ * Takes an object with optional fields
+ * @param config - Object with name (required), age and is_student (optional)
+ * @returns Object with default values applied (age: 18, is_student: true)
+ */
+export function get_object_optional(config: OptionalField): OptionalField;
+
+/**
+ * Takes an optional object and returns it
+ * @param config - Object with optional fields
+ * @returns The same object
+ */
+export function get_optional_object_and_return_optional(config: OptionalField): OptionalField;
+
+/**
+ * Takes an object with nullable name field
+ * @param config - Object with nullable name
+ * @returns The same object
+ */
+export function get_nullable_object(config: NullableField): NullableField;
+
+/**
+ * Returns a nullable object with null name
+ * @returns Object with name set to null
+ */
+export function return_nullable(): NullableField;
+
+// ============== Function Types ==============
+
+/**
+ * Callback function type that takes two numbers and returns a number
+ */
+export type CallbackFunction = (arg0: number, arg1: number) => number;
+
+// ============== Function Functions ==============
+
+/**
+ * Calls the provided callback function with (1, 2)
+ * @param cb - A callback function that takes two numbers and returns a number
+ * @returns The result of calling cb(1, 2)
+ */
+export function call_function(cb: CallbackFunction): number;
+
+/**
+ * Adds two numbers
+ * @param left - The first number
+ * @param right - The second number
+ * @returns The sum of left and right
+ */
+export function basic_function(left: number, right: number): number;
+
+/**
+ * Creates a new function that wraps basic_function
+ * @returns A function that adds two numbers
+ */
+export function create_function(): CallbackFunction;
+
+// ============== Thread Safe Function ==============
+
+/**
+ * Calls the thread safe function from multiple threads
+ * @param tsfn - A thread-safe callback function
+ */
+export function call_thread_safe_function(tsfn: CallbackFunction): void;
+
+// ============== Class Types ==============
+
+/**
+ * Basic test class with name and age properties
+ */
+export class TestClass {
+  constructor(name: string, age: number);
+  name: string;
+  age: number;
+}
+
+/**
+ * Test class with custom init function
+ * Constructor takes (age, name) instead of field order
+ */
+export class TestWithInitClass {
+  constructor(age: number, name: string);
+  name: string;
+  age: number;
+  static readonly hello: string;
+}
+
+/**
+ * Test class without constructor (abstract-like)
+ */
+export class TestWithoutInitClass {
+  private constructor();
+  name: string;
+  age: number;
+  static readonly hello: string;
+}
+
+/**
+ * Test class with factory method
+ */
+export class TestFactoryClass {
+  constructor(age: number, name: string);
+  name: string;
+  age: number;
+  /**
+   * Formats the object as a string
+   * @returns Formatted string representation
+   */
+  format(): string;
+}
+
+// ============== Log Functions ==============
+
+/**
+ * Tests hilog functionality (OpenHarmony logging)
+ */
+export function test_hilog(): void;
+
+// ============== Module Export ==============
+
+declare const hello: {
+  // Number
+  test_i32: typeof test_i32;
+  test_f32: typeof test_f32;
+  test_u32: typeof test_u32;
+
+  // String
+  hello: typeof hello;
+  text: typeof text;
+
+  // Error
+  throw_error: typeof throw_error;
+
+  // Worker
+  fib: typeof fib;
+  fib_async: typeof fib_async;
+
+  // Array
+  get_and_return_array: typeof get_and_return_array;
+  get_named_array: typeof get_named_array;
+  get_arraylist: typeof get_arraylist;
+
+  // Object
+  get_object: typeof get_object;
+  get_object_optional: typeof get_object_optional;
+  get_optional_object_and_return_optional: typeof get_optional_object_and_return_optional;
+  get_nullable_object: typeof get_nullable_object;
+  return_nullable: typeof return_nullable;
+
+  // Function
+  call_function: typeof call_function;
+  basic_function: typeof basic_function;
+  create_function: typeof create_function;
+
+  // Thread Safe Function
+  call_thread_safe_function: typeof call_thread_safe_function;
+
+  // Class
+  TestClass: typeof TestClass;
+  TestWithInitClass: typeof TestWithInitClass;
+  TestWithoutInitClass: typeof TestWithoutInitClass;
+  TestFactoryClass: typeof TestFactoryClass;
+
+  // Log
+  test_hilog: typeof test_hilog;
+};
+
+export default hello;