@nilejs/client 0.0.1 → 0.0.3

package/dist/index.cjs

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  createNileClient: () => createNileClient
+  buildFormData: () => buildFormData,
+  createNileClient: () => createNileClient,
+  sendUploadRequest: () => sendUploadRequest
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -79,14 +81,7 @@ async function sendNileRequest(config, intent, service, action, payload, options
     return json;
   });
   if (requestResult.isErr) {
-    const error = requestResult.error;
-    let errorMsg = "An unknown error occurred";
-    if (error instanceof Error) {
-      errorMsg = error.name === "AbortError" ? "Request timed out" : error.message;
-    } else {
-      errorMsg = String(error);
-    }
-    return { error: errorMsg, data: null };
+    return resolveError(requestResult.error);
   }
   const result = requestResult.value;
   if (!result.status) {
@@ -94,51 +89,127 @@ async function sendNileRequest(config, intent, service, action, payload, options
   }
   return { error: null, data: result.data };
 }
+async function sendUploadRequest(config, service, action, files, fields, options = {}) {
+  const { timeout = config.timeout ?? 3e4, ...fetchOptions } = options;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  const formData = buildFormData(service, action, files, fields);
+  const requestResult = await safeTry(async () => {
+    const { "Content-Type": _ct, ...safeHeaders } = config.headers ?? {};
+    const { "Content-Type": _ct2, ...safeFetchHeaders } = fetchOptions.headers ?? {};
+    const response = await fetch(`${config.baseUrl}/services`, {
+      method: "POST",
+      headers: {
+        ...safeHeaders,
+        ...safeFetchHeaders
+      },
+      credentials: config.credentials,
+      body: formData,
+      signal: controller.signal,
+      ...fetchOptions
+    });
+    clearTimeout(timeoutId);
+    const json = await response.json();
+    return json;
+  });
+  if (requestResult.isErr) {
+    return resolveError(requestResult.error);
+  }
+  const result = requestResult.value;
+  if (!result.status) {
+    return { error: result.message, data: result.data };
+  }
+  return { error: null, data: result.data };
+}
+function buildFormData(service, action, files, fields) {
+  const formData = new FormData();
+  formData.append("intent", "execute");
+  formData.append("service", service);
+  formData.append("action", action);
+  if (fields) {
+    for (const [key, value] of Object.entries(fields)) {
+      formData.append(key, value);
+    }
+  }
+  for (const [key, value] of Object.entries(files)) {
+    if (Array.isArray(value)) {
+      for (const file of value) {
+        formData.append(key, file);
+      }
+    } else {
+      formData.append(key, value);
+    }
+  }
+  return formData;
+}
+function resolveError(error) {
+  let errorMsg = "An unknown error occurred";
+  if (error instanceof Error) {
+    errorMsg = error.name === "AbortError" ? "Request timed out" : error.message;
+  } else {
+    errorMsg = String(error);
+  }
+  return { error: errorMsg, data: null };
+}
 
 // src/create-client.ts
 function createNileClient(config) {
   return {
     /** Invoke a service action through the backend engine pipeline */
     invoke: async (params) => {
-      const { service, action, payload, ...options } = params;
+      const { service, action, payload, fetchOptions } = params;
       const result = await sendNileRequest(
         config,
         "execute",
         service,
         action,
         payload,
-        options
+        fetchOptions
       );
       return result;
     },
     /** Discover available services and actions (supports "*" wildcard) */
     explore: async (params) => {
-      const { service, action, ...options } = params;
+      const { service, action, fetchOptions } = params;
       return await sendNileRequest(
         config,
         "explore",
         service,
         action,
         {},
-        options
+        fetchOptions
       );
     },
     /** Get action schemas as JSON Schema (supports "*" wildcard) */
     schema: async (params) => {
-      const { service, action, ...options } = params;
+      const { service, action, fetchOptions } = params;
       return await sendNileRequest(
         config,
         "schema",
         service,
         action,
         {},
-        options
+        fetchOptions
+      );
+    },
+    /** Upload files to an action via multipart form-data */
+    upload: async (params) => {
+      const { service, action, files, fields, fetchOptions } = params;
+      return await sendUploadRequest(
+        config,
+        service,
+        action,
+        files,
+        fields,
+        fetchOptions
       );
     }
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createNileClient
+  buildFormData,
+  createNileClient,
+  sendUploadRequest
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/safe-try.ts","../src/request.ts","../src/create-client.ts"],"sourcesContent":["export { createNileClient } from \"./create-client.js\";\nexport type * from \"./types.js\";\n","/**\n * Internal result type for safeTry\n */\nexport type SafeResult<T, E = unknown> =\n  | { isOk: true; value: T; isErr: false; error: null }\n  | { isOk: false; value: null; isErr: true; error: E };\n\n/**\n * Gracefully handles both synchronous and asynchronous operations by returning a result object.\n * This replaces the need for external slang-ts dependency and avoids try/catch boilerplate.\n *\n * @param fn - The function to execute (sync or async)\n * @returns A result object containing either the value or the error\n *\n * @example\n * const { isOk, value, error } = await safeTry(() => fetch(url));\n */\nexport function safeTry<T>(\n  fn: () => T | Promise<T>\n): Promise<SafeResult<T>> | SafeResult<T> {\n  try {\n    const result = fn();\n\n    if (result instanceof Promise) {\n      return result\n        .then(\n          (value): SafeResult<T> => ({\n            isOk: true,\n            value,\n            isErr: false,\n            error: null,\n          })\n        )\n        .catch(\n          (error): SafeResult<T> => ({\n            isOk: false,\n            value: null,\n            isErr: true,\n            error,\n          })\n        );\n    }\n\n    return { isOk: true, value: result, isErr: false, error: null };\n  } catch (error) {\n    return { isOk: false, value: null, isErr: true, error };\n  }\n}\n","import { safeTry } from \"./safe-try.js\";\nimport type {\n  ClientResult,\n  ExternalResponse,\n  FetchOptions,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Handles communication with the Nile /services endpoint.\n * Uses fetch + safeTry for crash safety and consistent { error, data } results.\n */\nexport async function sendNileRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  intent: \"explore\" | \"execute\" | \"schema\",\n  service: string,\n  action: string,\n  payload: unknown,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const requestResult = await safeTry(async () => {\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...config.headers,\n        ...(fetchOptions.headers as Record<string, string>),\n      },\n      credentials: config.credentials,\n      body: JSON.stringify({\n        intent,\n        service,\n        action,\n        payload: payload ?? {},\n      }),\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    const error: unknown = requestResult.error;\n    let errorMsg = \"An unknown error occurred\";\n\n    if (error instanceof Error) {\n      errorMsg =\n        error.name === \"AbortError\" ? \"Request timed out\" : error.message;\n    } else {\n      errorMsg = String(error);\n    }\n\n    return { error: errorMsg, data: null };\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n","import { sendNileRequest } from \"./request.js\";\nimport type {\n  ClientResult,\n  FetchOptions,\n  NileClient,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Creates a type-safe Nile client for interacting with backend services.\n *\n * @param config - The client configuration including baseUrl\n * @returns A factory object with execute, explore, and schema methods\n *\n * @example\n * const nile = createNileClient<ServicePayloads>({ baseUrl: \"/api\" });\n * const { error, data } = await nile.invoke({\n *   service: \"tasks\",\n *   action: \"create\",\n *   payload: { title: \"Buy milk\" }\n * });\n */\nexport function createNileClient<\n  TPayloads = Record<string, Record<string, unknown>>,\n>(config: NileClientConfig): NileClient<TPayloads> {\n  return {\n    /** Invoke a service action through the backend engine pipeline */\n    invoke: async <\n      S extends keyof TPayloads & string,\n      A extends keyof TPayloads[S] & string,\n    >(\n      params: { service: S; action: A; payload: TPayloads[S][A] } & FetchOptions\n    ) => {\n      const { service, action, payload, ...options } = params;\n      const result = await sendNileRequest<Record<string, unknown>>(\n        config,\n        \"execute\",\n        service,\n        action,\n        payload,\n        options\n      );\n      return result as ClientResult;\n    },\n\n    /** Discover available services and actions (supports \"*\" wildcard) */\n    explore: async (\n      params: { service: string; action: string } & FetchOptions\n    ) => {\n      const { service, action, ...options } = params;\n      return await sendNileRequest(\n        config,\n        \"explore\",\n        service,\n        action,\n        {},\n        options\n      );\n    },\n\n    /** Get action schemas as JSON Schema (supports \"*\" wildcard) */\n    schema: async (\n      params: { service: string; action: string } & FetchOptions\n    ) => {\n      const { service, action, ...options } = params;\n      return await sendNileRequest(\n        config,\n        \"schema\",\n        service,\n        action,\n        {},\n        options\n      );\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/safe-try.ts","../src/request.ts","../src/create-client.ts"],"sourcesContent":["export { createNileClient } from \"./create-client.js\";\nexport { buildFormData, sendUploadRequest } from \"./request.js\";\nexport type * from \"./types.js\";\n","/**\n * Internal result type for safeTry\n */\nexport type SafeResult<T, E = unknown> =\n  | { isOk: true; value: T; isErr: false; error: null }\n  | { isOk: false; value: null; isErr: true; error: E };\n\n/**\n * Gracefully handles both synchronous and asynchronous operations by returning a result object.\n * This replaces the need for external slang-ts dependency and avoids try/catch boilerplate.\n *\n * @param fn - The function to execute (sync or async)\n * @returns A result object containing either the value or the error\n *\n * @example\n * const { isOk, value, error } = await safeTry(() => fetch(url));\n */\nexport function safeTry<T>(\n  fn: () => T | Promise<T>\n): Promise<SafeResult<T>> | SafeResult<T> {\n  try {\n    const result = fn();\n\n    if (result instanceof Promise) {\n      return result\n        .then(\n          (value): SafeResult<T> => ({\n            isOk: true,\n            value,\n            isErr: false,\n            error: null,\n          })\n        )\n        .catch(\n          (error): SafeResult<T> => ({\n            isOk: false,\n            value: null,\n            isErr: true,\n            error,\n          })\n        );\n    }\n\n    return { isOk: true, value: result, isErr: false, error: null };\n  } catch (error) {\n    return { isOk: false, value: null, isErr: true, error };\n  }\n}\n","import { safeTry } from \"./safe-try.js\";\nimport type {\n  ClientResult,\n  ExternalResponse,\n  FetchOptions,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Handles JSON communication with the Nile /services endpoint.\n * Uses fetch + safeTry for crash safety and consistent { error, data } results.\n */\nexport async function sendNileRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  intent: \"explore\" | \"execute\" | \"schema\",\n  service: string,\n  action: string,\n  payload: unknown,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const requestResult = await safeTry(async () => {\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...config.headers,\n        ...(fetchOptions.headers as Record<string, string>),\n      },\n      credentials: config.credentials,\n      body: JSON.stringify({\n        intent,\n        service,\n        action,\n        payload: payload ?? {},\n      }),\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    return resolveError(requestResult.error);\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n\n/**\n * Handles multipart form-data uploads to the Nile /services endpoint.\n * Builds a FormData body with RPC routing fields (intent, service, action),\n * user-provided fields, and file attachments.\n *\n * Content-Type header is intentionally omitted so the runtime sets the\n * correct multipart boundary automatically.\n */\nexport async function sendUploadRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  service: string,\n  action: string,\n  files: Record<string, File | File[]>,\n  fields?: Record<string, string>,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const formData = buildFormData(service, action, files, fields);\n\n  const requestResult = await safeTry(async () => {\n    // Spread config.headers but strip Content-Type — let the runtime set multipart boundary\n    const { \"Content-Type\": _ct, ...safeHeaders } = config.headers ?? {};\n    const { \"Content-Type\": _ct2, ...safeFetchHeaders } =\n      (fetchOptions.headers as Record<string, string>) ?? {};\n\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        ...safeHeaders,\n        ...safeFetchHeaders,\n      },\n      credentials: config.credentials,\n      body: formData,\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    return resolveError(requestResult.error);\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n\n/**\n * Builds a FormData instance with RPC routing fields and file/field entries.\n * The server expects 'intent', 'service', 'action' as string fields.\n */\nexport function buildFormData(\n  service: string,\n  action: string,\n  files: Record<string, File | File[]>,\n  fields?: Record<string, string>\n): FormData {\n  const formData = new FormData();\n\n  // RPC routing fields the server expects\n  formData.append(\"intent\", \"execute\");\n  formData.append(\"service\", service);\n  formData.append(\"action\", action);\n\n  // User-provided string fields\n  if (fields) {\n    for (const [key, value] of Object.entries(fields)) {\n      formData.append(key, value);\n    }\n  }\n\n  // File attachments — arrays append multiple entries under the same key\n  for (const [key, value] of Object.entries(files)) {\n    if (Array.isArray(value)) {\n      for (const file of value) {\n        formData.append(key, file);\n      }\n    } else {\n      formData.append(key, value);\n    }\n  }\n\n  return formData;\n}\n\n/** Resolve error from safeTry into a ClientResult */\nfunction resolveError<T>(error: unknown): ClientResult<T> {\n  let errorMsg = \"An unknown error occurred\";\n\n  if (error instanceof Error) {\n    errorMsg =\n      error.name === \"AbortError\" ? \"Request timed out\" : error.message;\n  } else {\n    errorMsg = String(error);\n  }\n\n  return { error: errorMsg, data: null };\n}\n","import { sendNileRequest, sendUploadRequest } from \"./request.js\";\nimport type {\n  ClientResult,\n  NileClient,\n  NileClientConfig,\n  UploadParams,\n} from \"./types.js\";\n\n/**\n * Creates a type-safe Nile client for interacting with backend services.\n *\n * @param config - The client configuration including baseUrl\n * @returns A factory object with invoke, explore, schema, and upload methods\n *\n * @example\n * const nile = createNileClient<ServicePayloads>({ baseUrl: \"/api\" });\n * const { error, data } = await nile.invoke({\n *   service: \"tasks\",\n *   action: \"create\",\n *   payload: { title: \"Buy milk\" }\n * });\n */\nexport function createNileClient<\n  TPayloads = Record<string, Record<string, unknown>>,\n>(config: NileClientConfig): NileClient<TPayloads> {\n  return {\n    /** Invoke a service action through the backend engine pipeline */\n    invoke: async <\n      S extends keyof TPayloads & string,\n      A extends keyof TPayloads[S] & string,\n    >(\n      params: {\n        service: S;\n        action: A;\n        payload: TPayloads[S][A];\n        fetchOptions?: Parameters<typeof sendNileRequest>[5];\n      }\n    ) => {\n      const { service, action, payload, fetchOptions } = params;\n      const result = await sendNileRequest<Record<string, unknown>>(\n        config,\n        \"execute\",\n        service,\n        action,\n        payload,\n        fetchOptions\n      );\n      return result as ClientResult;\n    },\n\n    /** Discover available services and actions (supports \"*\" wildcard) */\n    explore: async (params) => {\n      const { service, action, fetchOptions } = params;\n      return await sendNileRequest(\n        config,\n        \"explore\",\n        service,\n        action,\n        {},\n        fetchOptions\n      );\n    },\n\n    /** Get action schemas as JSON Schema (supports \"*\" wildcard) */\n    schema: async (params) => {\n      const { service, action, fetchOptions } = params;\n      return await sendNileRequest(\n        config,\n        \"schema\",\n        service,\n        action,\n        {},\n        fetchOptions\n      );\n    },\n\n    /** Upload files to an action via multipart form-data */\n    upload: async (params: UploadParams) => {\n      const { service, action, files, fields, fetchOptions } = params;\n      return await sendUploadRequest(\n        config,\n        service,\n        action,\n        files,\n        fields,\n        fetchOptions\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,SAAS,QACd,IACwC;AACxC,MAAI;AACF,UAAM,SAAS,GAAG;AAElB,QAAI,kBAAkB,SAAS;AAC7B,aAAO,OACJ;AAAA,QACC,CAAC,WAA0B;AAAA,UACzB,MAAM;AAAA,UACN;AAAA,UACA,OAAO;AAAA,UACP,OAAO;AAAA,QACT;AAAA,MACF,EACC;AAAA,QACC,CAAC,WAA0B;AAAA,UACzB,MAAM;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,QACF;AAAA,MACF;AAAA,IACJ;AAEA,WAAO,EAAE,MAAM,MAAM,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK;AAAA,EAChE,SAAS,OAAO;AACd,WAAO,EAAE,MAAM,OAAO,OAAO,MAAM,OAAO,MAAM,MAAM;AAAA,EACxD;AACF;;;ACnCA,eAAsB,gBACpB,QACA,QACA,SACA,QACA,SACA,UAAwB,CAAC,GACC;AAC1B,QAAM,EAAE,UAAU,OAAO,WAAW,KAAQ,GAAG,aAAa,IAAI;AAEhE,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAE9D,QAAM,gBAAgB,MAAM,QAAQ,YAAY;AAC9C,UAAM,WAAW,MAAM,MAAM,GAAG,OAAO,OAAO,aAAa;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,OAAO;AAAA,QACV,GAAI,aAAa;AAAA,MACnB;AAAA,MACA,aAAa,OAAO;AAAA,MACpB,MAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAS,WAAW,CAAC;AAAA,MACvB,CAAC;AAAA,MACD,QAAQ,WAAW;AAAA,MACnB,GAAG;AAAA,IACL,CAAC;AAED,iBAAa,SAAS;AAEtB,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,EACT,CAAC;AAED,MAAI,cAAc,OAAO;AACvB,WAAO,aAAa,cAAc,KAAK;AAAA,EACzC;AAEA,QAAM,SAAS,cAAc;AAE7B,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO,EAAE,OAAO,OAAO,SAAS,MAAM,OAAO,KAAK;AAAA,EACpD;AAEA,SAAO,EAAE,OAAO,MAAM,MAAM,OAAO,KAAK;AAC1C;AAUA,eAAsB,kBACpB,QACA,SACA,QACA,OACA,QACA,UAAwB,CAAC,GACC;AAC1B,QAAM,EAAE,UAAU,OAAO,WAAW,KAAQ,GAAG,aAAa,IAAI;AAEhE,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAE9D,QAAM,WAAW,cAAc,SAAS,QAAQ,OAAO,MAAM;AAE7D,QAAM,gBAAgB,MAAM,QAAQ,YAAY;AAE9C,UAAM,EAAE,gBAAgB,KAAK,GAAG,YAAY,IAAI,OAAO,WAAW,CAAC;AACnE,UAAM,EAAE,gBAAgB,MAAM,GAAG,iBAAiB,IAC/C,aAAa,WAAsC,CAAC;AAEvD,UAAM,WAAW,MAAM,MAAM,GAAG,OAAO,OAAO,aAAa;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,GAAG;AAAA,QACH,GAAG;AAAA,MACL;AAAA,MACA,aAAa,OAAO;AAAA,MACpB,MAAM;AAAA,MACN,QAAQ,WAAW;AAAA,MACnB,GAAG;AAAA,IACL,CAAC;AAED,iBAAa,SAAS;AAEtB,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,EACT,CAAC;AAED,MAAI,cAAc,OAAO;AACvB,WAAO,aAAa,cAAc,KAAK;AAAA,EACzC;AAEA,QAAM,SAAS,cAAc;AAE7B,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO,EAAE,OAAO,OAAO,SAAS,MAAM,OAAO,KAAK;AAAA,EACpD;AAEA,SAAO,EAAE,OAAO,MAAM,MAAM,OAAO,KAAK;AAC1C;AAMO,SAAS,cACd,SACA,QACA,OACA,QACU;AACV,QAAM,WAAW,IAAI,SAAS;AAG9B,WAAS,OAAO,UAAU,SAAS;AACnC,WAAS,OAAO,WAAW,OAAO;AAClC,WAAS,OAAO,UAAU,MAAM;AAGhC,MAAI,QAAQ;AACV,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,eAAS,OAAO,KAAK,KAAK;AAAA,IAC5B;AAAA,EACF;AAGA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,iBAAW,QAAQ,OAAO;AACxB,iBAAS,OAAO,KAAK,IAAI;AAAA,MAC3B;AAAA,IACF,OAAO;AACL,eAAS,OAAO,KAAK,KAAK;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO;AACT;AAGA,SAAS,aAAgB,OAAiC;AACxD,MAAI,WAAW;AAEf,MAAI,iBAAiB,OAAO;AAC1B,eACE,MAAM,SAAS,eAAe,sBAAsB,MAAM;AAAA,EAC9D,OAAO;AACL,eAAW,OAAO,KAAK;AAAA,EACzB;AAEA,SAAO,EAAE,OAAO,UAAU,MAAM,KAAK;AACvC;;;ACvJO,SAAS,iBAEd,QAAiD;AACjD,SAAO;AAAA;AAAA,IAEL,QAAQ,OAIN,WAMG;AACH,YAAM,EAAE,SAAS,QAAQ,SAAS,aAAa,IAAI;AACnD,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA;AAAA,IAGA,SAAS,OAAO,WAAW;AACzB,YAAM,EAAE,SAAS,QAAQ,aAAa,IAAI;AAC1C,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,CAAC;AAAA,QACD;AAAA,MACF;AAAA,IACF;AAAA;AAAA,IAGA,QAAQ,OAAO,WAAW;AACxB,YAAM,EAAE,SAAS,QAAQ,aAAa,IAAI;AAC1C,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,CAAC;AAAA,QACD;AAAA,MACF;AAAA,IACF;AAAA;AAAA,IAGA,QAAQ,OAAO,WAAyB;AACtC,YAAM,EAAE,SAAS,QAAQ,OAAO,QAAQ,aAAa,IAAI;AACzD,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -23,10 +23,33 @@ interface NileClientConfig {
     /** Optional timeout in ms (default: 30000) */
     timeout?: number;
 }
-/** Options for individual fetch calls */
+/** Options for individual fetch calls (body and method are managed internally) */
 interface FetchOptions extends Omit<RequestInit, "body" | "method"> {
     timeout?: number;
 }
+/** Parameters for invoke (execute intent) */
+interface InvokeParams<TPayloads = Record<string, Record<string, unknown>>, S extends keyof TPayloads & string = keyof TPayloads & string, A extends keyof TPayloads[S] & string = keyof TPayloads[S] & string> {
+    service: S;
+    action: A;
+    payload: TPayloads[S][A];
+    fetchOptions?: FetchOptions;
+}
+/** Parameters for explore and schema intents */
+interface DiscoveryParams {
+    service: string;
+    action: string;
+    fetchOptions?: FetchOptions;
+}
+/** Parameters for upload (multipart form-data execute) */
+interface UploadParams {
+    service: string;
+    action: string;
+    /** Files to upload — keyed by field name */
+    files: Record<string, File | File[]>;
+    /** Additional string fields to include in the form data */
+    fields?: Record<string, string>;
+    fetchOptions?: FetchOptions;
+}
 /** Interface for the typed client */
 interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
     /** Invoke an action with full type-safety for payload */
@@ -34,24 +57,21 @@ interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
         service: S;
         action: A;
         payload: TPayloads[S][A];
-    } & FetchOptions) => Promise<ClientResult>;
+        fetchOptions?: FetchOptions;
+    }) => Promise<ClientResult>;
     /** Discover services/actions (supports "*" wildcard) */
-    explore: (params: {
-        service: string;
-        action: string;
-    } & FetchOptions) => Promise<ClientResult>;
+    explore: (params: DiscoveryParams) => Promise<ClientResult>;
     /** Get action schemas as JSON Schema (supports "*" wildcard) */
-    schema: (params: {
-        service: string;
-        action: string;
-    } & FetchOptions) => Promise<ClientResult>;
+    schema: (params: DiscoveryParams) => Promise<ClientResult>;
+    /** Upload files to an action via multipart form-data */
+    upload: (params: UploadParams) => Promise<ClientResult>;
 }
 
 /**
  * Creates a type-safe Nile client for interacting with backend services.
  *
  * @param config - The client configuration including baseUrl
- * @returns A factory object with execute, explore, and schema methods
+ * @returns A factory object with invoke, explore, schema, and upload methods
  *
  * @example
  * const nile = createNileClient<ServicePayloads>({ baseUrl: "/api" });
@@ -63,4 +83,19 @@ interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
  */
 declare function createNileClient<TPayloads = Record<string, Record<string, unknown>>>(config: NileClientConfig): NileClient<TPayloads>;
 
-export { type ClientResult, type ExternalResponse, type FetchOptions, type NileClient, type NileClientConfig, type NileIntentParams, createNileClient };
+/**
+ * Handles multipart form-data uploads to the Nile /services endpoint.
+ * Builds a FormData body with RPC routing fields (intent, service, action),
+ * user-provided fields, and file attachments.
+ *
+ * Content-Type header is intentionally omitted so the runtime sets the
+ * correct multipart boundary automatically.
+ */
+declare function sendUploadRequest<T = Record<string, unknown>>(config: NileClientConfig, service: string, action: string, files: Record<string, File | File[]>, fields?: Record<string, string>, options?: FetchOptions): Promise<ClientResult<T>>;
+/**
+ * Builds a FormData instance with RPC routing fields and file/field entries.
+ * The server expects 'intent', 'service', 'action' as string fields.
+ */
+declare function buildFormData(service: string, action: string, files: Record<string, File | File[]>, fields?: Record<string, string>): FormData;
+
+export { type ClientResult, type DiscoveryParams, type ExternalResponse, type FetchOptions, type InvokeParams, type NileClient, type NileClientConfig, type NileIntentParams, type UploadParams, buildFormData, createNileClient, sendUploadRequest };

package/dist/index.d.ts

@@ -23,10 +23,33 @@ interface NileClientConfig {
     /** Optional timeout in ms (default: 30000) */
     timeout?: number;
 }
-/** Options for individual fetch calls */
+/** Options for individual fetch calls (body and method are managed internally) */
 interface FetchOptions extends Omit<RequestInit, "body" | "method"> {
     timeout?: number;
 }
+/** Parameters for invoke (execute intent) */
+interface InvokeParams<TPayloads = Record<string, Record<string, unknown>>, S extends keyof TPayloads & string = keyof TPayloads & string, A extends keyof TPayloads[S] & string = keyof TPayloads[S] & string> {
+    service: S;
+    action: A;
+    payload: TPayloads[S][A];
+    fetchOptions?: FetchOptions;
+}
+/** Parameters for explore and schema intents */
+interface DiscoveryParams {
+    service: string;
+    action: string;
+    fetchOptions?: FetchOptions;
+}
+/** Parameters for upload (multipart form-data execute) */
+interface UploadParams {
+    service: string;
+    action: string;
+    /** Files to upload — keyed by field name */
+    files: Record<string, File | File[]>;
+    /** Additional string fields to include in the form data */
+    fields?: Record<string, string>;
+    fetchOptions?: FetchOptions;
+}
 /** Interface for the typed client */
 interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
     /** Invoke an action with full type-safety for payload */
@@ -34,24 +57,21 @@ interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
         service: S;
         action: A;
         payload: TPayloads[S][A];
-    } & FetchOptions) => Promise<ClientResult>;
+        fetchOptions?: FetchOptions;
+    }) => Promise<ClientResult>;
     /** Discover services/actions (supports "*" wildcard) */
-    explore: (params: {
-        service: string;
-        action: string;
-    } & FetchOptions) => Promise<ClientResult>;
+    explore: (params: DiscoveryParams) => Promise<ClientResult>;
     /** Get action schemas as JSON Schema (supports "*" wildcard) */
-    schema: (params: {
-        service: string;
-        action: string;
-    } & FetchOptions) => Promise<ClientResult>;
+    schema: (params: DiscoveryParams) => Promise<ClientResult>;
+    /** Upload files to an action via multipart form-data */
+    upload: (params: UploadParams) => Promise<ClientResult>;
 }
 
 /**
  * Creates a type-safe Nile client for interacting with backend services.
  *
  * @param config - The client configuration including baseUrl
- * @returns A factory object with execute, explore, and schema methods
+ * @returns A factory object with invoke, explore, schema, and upload methods
  *
  * @example
  * const nile = createNileClient<ServicePayloads>({ baseUrl: "/api" });
@@ -63,4 +83,19 @@ interface NileClient<TPayloads = Record<string, Record<string, unknown>>> {
  */
 declare function createNileClient<TPayloads = Record<string, Record<string, unknown>>>(config: NileClientConfig): NileClient<TPayloads>;
 
-export { type ClientResult, type ExternalResponse, type FetchOptions, type NileClient, type NileClientConfig, type NileIntentParams, createNileClient };
+/**
+ * Handles multipart form-data uploads to the Nile /services endpoint.
+ * Builds a FormData body with RPC routing fields (intent, service, action),
+ * user-provided fields, and file attachments.
+ *
+ * Content-Type header is intentionally omitted so the runtime sets the
+ * correct multipart boundary automatically.
+ */
+declare function sendUploadRequest<T = Record<string, unknown>>(config: NileClientConfig, service: string, action: string, files: Record<string, File | File[]>, fields?: Record<string, string>, options?: FetchOptions): Promise<ClientResult<T>>;
+/**
+ * Builds a FormData instance with RPC routing fields and file/field entries.
+ * The server expects 'intent', 'service', 'action' as string fields.
+ */
+declare function buildFormData(service: string, action: string, files: Record<string, File | File[]>, fields?: Record<string, string>): FormData;
+
+export { type ClientResult, type DiscoveryParams, type ExternalResponse, type FetchOptions, type InvokeParams, type NileClient, type NileClientConfig, type NileIntentParams, type UploadParams, buildFormData, createNileClient, sendUploadRequest };

package/dist/index.js

@@ -53,14 +53,7 @@ async function sendNileRequest(config, intent, service, action, payload, options
     return json;
   });
   if (requestResult.isErr) {
-    const error = requestResult.error;
-    let errorMsg = "An unknown error occurred";
-    if (error instanceof Error) {
-      errorMsg = error.name === "AbortError" ? "Request timed out" : error.message;
-    } else {
-      errorMsg = String(error);
-    }
-    return { error: errorMsg, data: null };
+    return resolveError(requestResult.error);
   }
   const result = requestResult.value;
   if (!result.status) {
@@ -68,50 +61,126 @@ async function sendNileRequest(config, intent, service, action, payload, options
   }
   return { error: null, data: result.data };
 }
+async function sendUploadRequest(config, service, action, files, fields, options = {}) {
+  const { timeout = config.timeout ?? 3e4, ...fetchOptions } = options;
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  const formData = buildFormData(service, action, files, fields);
+  const requestResult = await safeTry(async () => {
+    const { "Content-Type": _ct, ...safeHeaders } = config.headers ?? {};
+    const { "Content-Type": _ct2, ...safeFetchHeaders } = fetchOptions.headers ?? {};
+    const response = await fetch(`${config.baseUrl}/services`, {
+      method: "POST",
+      headers: {
+        ...safeHeaders,
+        ...safeFetchHeaders
+      },
+      credentials: config.credentials,
+      body: formData,
+      signal: controller.signal,
+      ...fetchOptions
+    });
+    clearTimeout(timeoutId);
+    const json = await response.json();
+    return json;
+  });
+  if (requestResult.isErr) {
+    return resolveError(requestResult.error);
+  }
+  const result = requestResult.value;
+  if (!result.status) {
+    return { error: result.message, data: result.data };
+  }
+  return { error: null, data: result.data };
+}
+function buildFormData(service, action, files, fields) {
+  const formData = new FormData();
+  formData.append("intent", "execute");
+  formData.append("service", service);
+  formData.append("action", action);
+  if (fields) {
+    for (const [key, value] of Object.entries(fields)) {
+      formData.append(key, value);
+    }
+  }
+  for (const [key, value] of Object.entries(files)) {
+    if (Array.isArray(value)) {
+      for (const file of value) {
+        formData.append(key, file);
+      }
+    } else {
+      formData.append(key, value);
+    }
+  }
+  return formData;
+}
+function resolveError(error) {
+  let errorMsg = "An unknown error occurred";
+  if (error instanceof Error) {
+    errorMsg = error.name === "AbortError" ? "Request timed out" : error.message;
+  } else {
+    errorMsg = String(error);
+  }
+  return { error: errorMsg, data: null };
+}
 
 // src/create-client.ts
 function createNileClient(config) {
   return {
     /** Invoke a service action through the backend engine pipeline */
     invoke: async (params) => {
-      const { service, action, payload, ...options } = params;
+      const { service, action, payload, fetchOptions } = params;
       const result = await sendNileRequest(
         config,
         "execute",
         service,
         action,
         payload,
-        options
+        fetchOptions
       );
       return result;
     },
     /** Discover available services and actions (supports "*" wildcard) */
     explore: async (params) => {
-      const { service, action, ...options } = params;
+      const { service, action, fetchOptions } = params;
       return await sendNileRequest(
         config,
         "explore",
         service,
         action,
         {},
-        options
+        fetchOptions
       );
     },
     /** Get action schemas as JSON Schema (supports "*" wildcard) */
     schema: async (params) => {
-      const { service, action, ...options } = params;
+      const { service, action, fetchOptions } = params;
       return await sendNileRequest(
         config,
         "schema",
         service,
         action,
         {},
-        options
+        fetchOptions
+      );
+    },
+    /** Upload files to an action via multipart form-data */
+    upload: async (params) => {
+      const { service, action, files, fields, fetchOptions } = params;
+      return await sendUploadRequest(
+        config,
+        service,
+        action,
+        files,
+        fields,
+        fetchOptions
       );
     }
   };
 }
 export {
-  createNileClient
+  buildFormData,
+  createNileClient,
+  sendUploadRequest
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/safe-try.ts","../src/request.ts","../src/create-client.ts"],"sourcesContent":["/**\n * Internal result type for safeTry\n */\nexport type SafeResult<T, E = unknown> =\n  | { isOk: true; value: T; isErr: false; error: null }\n  | { isOk: false; value: null; isErr: true; error: E };\n\n/**\n * Gracefully handles both synchronous and asynchronous operations by returning a result object.\n * This replaces the need for external slang-ts dependency and avoids try/catch boilerplate.\n *\n * @param fn - The function to execute (sync or async)\n * @returns A result object containing either the value or the error\n *\n * @example\n * const { isOk, value, error } = await safeTry(() => fetch(url));\n */\nexport function safeTry<T>(\n  fn: () => T | Promise<T>\n): Promise<SafeResult<T>> | SafeResult<T> {\n  try {\n    const result = fn();\n\n    if (result instanceof Promise) {\n      return result\n        .then(\n          (value): SafeResult<T> => ({\n            isOk: true,\n            value,\n            isErr: false,\n            error: null,\n          })\n        )\n        .catch(\n          (error): SafeResult<T> => ({\n            isOk: false,\n            value: null,\n            isErr: true,\n            error,\n          })\n        );\n    }\n\n    return { isOk: true, value: result, isErr: false, error: null };\n  } catch (error) {\n    return { isOk: false, value: null, isErr: true, error };\n  }\n}\n","import { safeTry } from \"./safe-try.js\";\nimport type {\n  ClientResult,\n  ExternalResponse,\n  FetchOptions,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Handles communication with the Nile /services endpoint.\n * Uses fetch + safeTry for crash safety and consistent { error, data } results.\n */\nexport async function sendNileRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  intent: \"explore\" | \"execute\" | \"schema\",\n  service: string,\n  action: string,\n  payload: unknown,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const requestResult = await safeTry(async () => {\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...config.headers,\n        ...(fetchOptions.headers as Record<string, string>),\n      },\n      credentials: config.credentials,\n      body: JSON.stringify({\n        intent,\n        service,\n        action,\n        payload: payload ?? {},\n      }),\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    const error: unknown = requestResult.error;\n    let errorMsg = \"An unknown error occurred\";\n\n    if (error instanceof Error) {\n      errorMsg =\n        error.name === \"AbortError\" ? \"Request timed out\" : error.message;\n    } else {\n      errorMsg = String(error);\n    }\n\n    return { error: errorMsg, data: null };\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n","import { sendNileRequest } from \"./request.js\";\nimport type {\n  ClientResult,\n  FetchOptions,\n  NileClient,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Creates a type-safe Nile client for interacting with backend services.\n *\n * @param config - The client configuration including baseUrl\n * @returns A factory object with execute, explore, and schema methods\n *\n * @example\n * const nile = createNileClient<ServicePayloads>({ baseUrl: \"/api\" });\n * const { error, data } = await nile.invoke({\n *   service: \"tasks\",\n *   action: \"create\",\n *   payload: { title: \"Buy milk\" }\n * });\n */\nexport function createNileClient<\n  TPayloads = Record<string, Record<string, unknown>>,\n>(config: NileClientConfig): NileClient<TPayloads> {\n  return {\n    /** Invoke a service action through the backend engine pipeline */\n    invoke: async <\n      S extends keyof TPayloads & string,\n      A extends keyof TPayloads[S] & string,\n    >(\n      params: { service: S; action: A; payload: TPayloads[S][A] } & FetchOptions\n    ) => {\n      const { service, action, payload, ...options } = params;\n      const result = await sendNileRequest<Record<string, unknown>>(\n        config,\n        \"execute\",\n        service,\n        action,\n        payload,\n        options\n      );\n      return result as ClientResult;\n    },\n\n    /** Discover available services and actions (supports \"*\" wildcard) */\n    explore: async (\n      params: { service: string; action: string } & FetchOptions\n    ) => {\n      const { service, action, ...options } = params;\n      return await sendNileRequest(\n        config,\n        \"explore\",\n        service,\n        action,\n        {},\n        options\n      );\n    },\n\n    /** Get action schemas as JSON Schema (supports \"*\" wildcard) */\n    schema: async (\n      params: { service: string; action: string } & FetchOptions\n    ) => {\n      const { service, action, ...options } = params;\n      return await sendNileRequest(\n        config,\n        \"schema\",\n        service,\n        action,\n        {},\n        options\n      );\n    },\n  };\n}\n"],"mappings":";AAiBO,SAAS,QACd,IACwC;AACxC,MAAI;AACF,UAAM,SAAS,GAAG;AAElB,QAAI,kBAAkB,SAAS;AAC7B,aAAO,OACJ;AAAA,QACC,CAAC,WAA0B;AAAA,UACzB,MAAM;AAAA,UACN;AAAA,UACA,OAAO;AAAA,UACP,OAAO;AAAA,QACT;AAAA,MACF,EACC;AAAA,QACC,CAAC,WAA0B;AAAA,UACzB,MAAM;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,QACF;AAAA,MACF;AAAA,IACJ;AAEA,WAAO,EAAE,MAAM,MAAM,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK;AAAA,EAChE,SAAS,OAAO;AACd,WAAO,EAAE,MAAM,OAAO,OAAO,MAAM,OAAO,MAAM,MAAM;AAAA,EACxD;AACF;;;ACnCA,eAAsB,gBACpB,QACA,QACA,SACA,QACA,SACA,UAAwB,CAAC,GACC;AAC1B,QAAM,EAAE,UAAU,OAAO,WAAW,KAAQ,GAAG,aAAa,IAAI;AAEhE,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAE9D,QAAM,gBAAgB,MAAM,QAAQ,YAAY;AAC9C,UAAM,WAAW,MAAM,MAAM,GAAG,OAAO,OAAO,aAAa;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,OAAO;AAAA,QACV,GAAI,aAAa;AAAA,MACnB;AAAA,MACA,aAAa,OAAO;AAAA,MACpB,MAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAS,WAAW,CAAC;AAAA,MACvB,CAAC;AAAA,MACD,QAAQ,WAAW;AAAA,MACnB,GAAG;AAAA,IACL,CAAC;AAED,iBAAa,SAAS;AAEtB,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,EACT,CAAC;AAED,MAAI,cAAc,OAAO;AACvB,UAAM,QAAiB,cAAc;AACrC,QAAI,WAAW;AAEf,QAAI,iBAAiB,OAAO;AAC1B,iBACE,MAAM,SAAS,eAAe,sBAAsB,MAAM;AAAA,IAC9D,OAAO;AACL,iBAAW,OAAO,KAAK;AAAA,IACzB;AAEA,WAAO,EAAE,OAAO,UAAU,MAAM,KAAK;AAAA,EACvC;AAEA,QAAM,SAAS,cAAc;AAE7B,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO,EAAE,OAAO,OAAO,SAAS,MAAM,OAAO,KAAK;AAAA,EACpD;AAEA,SAAO,EAAE,OAAO,MAAM,MAAM,OAAO,KAAK;AAC1C;;;ACjDO,SAAS,iBAEd,QAAiD;AACjD,SAAO;AAAA;AAAA,IAEL,QAAQ,OAIN,WACG;AACH,YAAM,EAAE,SAAS,QAAQ,SAAS,GAAG,QAAQ,IAAI;AACjD,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA;AAAA,IAGA,SAAS,OACP,WACG;AACH,YAAM,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI;AACxC,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,CAAC;AAAA,QACD;AAAA,MACF;AAAA,IACF;AAAA;AAAA,IAGA,QAAQ,OACN,WACG;AACH,YAAM,EAAE,SAAS,QAAQ,GAAG,QAAQ,IAAI;AACxC,aAAO,MAAM;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,CAAC;AAAA,QACD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/safe-try.ts","../src/request.ts","../src/create-client.ts"],"sourcesContent":["/**\n * Internal result type for safeTry\n */\nexport type SafeResult<T, E = unknown> =\n  | { isOk: true; value: T; isErr: false; error: null }\n  | { isOk: false; value: null; isErr: true; error: E };\n\n/**\n * Gracefully handles both synchronous and asynchronous operations by returning a result object.\n * This replaces the need for external slang-ts dependency and avoids try/catch boilerplate.\n *\n * @param fn - The function to execute (sync or async)\n * @returns A result object containing either the value or the error\n *\n * @example\n * const { isOk, value, error } = await safeTry(() => fetch(url));\n */\nexport function safeTry<T>(\n  fn: () => T | Promise<T>\n): Promise<SafeResult<T>> | SafeResult<T> {\n  try {\n    const result = fn();\n\n    if (result instanceof Promise) {\n      return result\n        .then(\n          (value): SafeResult<T> => ({\n            isOk: true,\n            value,\n            isErr: false,\n            error: null,\n          })\n        )\n        .catch(\n          (error): SafeResult<T> => ({\n            isOk: false,\n            value: null,\n            isErr: true,\n            error,\n          })\n        );\n    }\n\n    return { isOk: true, value: result, isErr: false, error: null };\n  } catch (error) {\n    return { isOk: false, value: null, isErr: true, error };\n  }\n}\n","import { safeTry } from \"./safe-try.js\";\nimport type {\n  ClientResult,\n  ExternalResponse,\n  FetchOptions,\n  NileClientConfig,\n} from \"./types.js\";\n\n/**\n * Handles JSON communication with the Nile /services endpoint.\n * Uses fetch + safeTry for crash safety and consistent { error, data } results.\n */\nexport async function sendNileRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  intent: \"explore\" | \"execute\" | \"schema\",\n  service: string,\n  action: string,\n  payload: unknown,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const requestResult = await safeTry(async () => {\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...config.headers,\n        ...(fetchOptions.headers as Record<string, string>),\n      },\n      credentials: config.credentials,\n      body: JSON.stringify({\n        intent,\n        service,\n        action,\n        payload: payload ?? {},\n      }),\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    return resolveError(requestResult.error);\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n\n/**\n * Handles multipart form-data uploads to the Nile /services endpoint.\n * Builds a FormData body with RPC routing fields (intent, service, action),\n * user-provided fields, and file attachments.\n *\n * Content-Type header is intentionally omitted so the runtime sets the\n * correct multipart boundary automatically.\n */\nexport async function sendUploadRequest<T = Record<string, unknown>>(\n  config: NileClientConfig,\n  service: string,\n  action: string,\n  files: Record<string, File | File[]>,\n  fields?: Record<string, string>,\n  options: FetchOptions = {}\n): Promise<ClientResult<T>> {\n  const { timeout = config.timeout ?? 30_000, ...fetchOptions } = options;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const formData = buildFormData(service, action, files, fields);\n\n  const requestResult = await safeTry(async () => {\n    // Spread config.headers but strip Content-Type — let the runtime set multipart boundary\n    const { \"Content-Type\": _ct, ...safeHeaders } = config.headers ?? {};\n    const { \"Content-Type\": _ct2, ...safeFetchHeaders } =\n      (fetchOptions.headers as Record<string, string>) ?? {};\n\n    const response = await fetch(`${config.baseUrl}/services`, {\n      method: \"POST\",\n      headers: {\n        ...safeHeaders,\n        ...safeFetchHeaders,\n      },\n      credentials: config.credentials,\n      body: formData,\n      signal: controller.signal,\n      ...fetchOptions,\n    });\n\n    clearTimeout(timeoutId);\n\n    const json = (await response.json()) as ExternalResponse<T>;\n    return json;\n  });\n\n  if (requestResult.isErr) {\n    return resolveError(requestResult.error);\n  }\n\n  const result = requestResult.value;\n\n  if (!result.status) {\n    return { error: result.message, data: result.data };\n  }\n\n  return { error: null, data: result.data };\n}\n\n/**\n * Builds a FormData instance with RPC routing fields and file/field entries.\n * The server expects 'intent', 'service', 'action' as string fields.\n */\nexport function buildFormData(\n  service: string,\n  action: string,\n  files: Record<string, File | File[]>,\n  fields?: Record<string, string>\n): FormData {\n  const formData = new FormData();\n\n  // RPC routing fields the server expects\n  formData.append(\"intent\", \"execute\");\n  formData.append(\"service\", service);\n  formData.append(\"action\", action);\n\n  // User-provided string fields\n  if (fields) {\n    for (const [key, value] of Object.entries(fields)) {\n      formData.append(key, value);\n    }\n  }\n\n  // File attachments — arrays append multiple entries under the same key\n  for (const [key, value] of Object.entries(files)) {\n    if (Array.isArray(value)) {\n      for (const file of value) {\n        formData.append(key, file);\n      }\n    } else {\n      formData.append(key, value);\n    }\n  }\n\n  return formData;\n}\n\n/** Resolve error from safeTry into a ClientResult */\nfunction resolveError<T>(error: unknown): ClientResult<T> {\n  let errorMsg = \"An unknown error occurred\";\n\n  if (error instanceof Error) {\n    errorMsg =\n      error.name === \"AbortError\" ? \"Request timed out\" : error.message;\n  } else {\n    errorMsg = String(error);\n  }\n\n  return { error: errorMsg, data: null };\n}\n","import { sendNileRequest, sendUploadRequest } from \"./request.js\";\nimport type {\n  ClientResult,\n  NileClient,\n  NileClientConfig,\n  UploadParams,\n} from \"./types.js\";\n\n/**\n * Creates a type-safe Nile client for interacting with backend services.\n *\n * @param config - The client configuration including baseUrl\n * @returns A factory object with invoke, explore, schema, and upload methods\n *\n * @example\n * const nile = createNileClient<ServicePayloads>({ baseUrl: \"/api\" });\n * const { error, data } = await nile.invoke({\n *   service: \"tasks\",\n *   action: \"create\",\n *   payload: { title: \"Buy milk\" }\n * });\n */\nexport function createNileClient<\n  TPayloads = Record<string, Record<string, unknown>>,\n>(config: NileClientConfig): NileClient<TPayloads> {\n  return {\n    /** Invoke a service action through the backend engine pipeline */\n    invoke: async <\n      S extends keyof TPayloads & string,\n      A extends keyof TPayloads[S] & string,\n    >(\n      params: {\n        service: S;\n        action: A;\n        payload: TPayloads[S][A];\n        fetchOptions?: Parameters<typeof sendNileRequest>[5];\n      }\n    ) => {\n      const { service, action, payload, fetchOptions } = params;\n      const result = await sendNileRequest<Record<string, unknown>>(\n        config,\n        \"execute\",\n        service,\n        action,\n        payload,\n        fetchOptions\n      );\n      return result as ClientResult;\n    },\n\n    /** Discover available services and actions (supports \"*\" wildcard) */\n    explore: async (params) => {\n      const { service, action, fetchOptions } = params;\n      return await sendNileRequest(\n        config,\n        \"explore\",\n        service,\n        action,\n        {},\n        fetchOptions\n      );\n    },\n\n    /** Get action schemas as JSON Schema (supports \"*\" wildcard) */\n    schema: async (params) => {\n      const { service, action, fetchOptions } = params;\n      return await sendNileRequest(\n        config,\n        \"schema\",\n        service,\n        action,\n        {},\n        fetchOptions\n      );\n    },\n\n    /** Upload files to an action via multipart form-data */\n    upload: async (params: UploadParams) => {\n      const { service, action, files, fields, fetchOptions } = params;\n      return await sendUploadRequest(\n        config,\n        service,\n        action,\n        files,\n        fields,\n        fetchOptions\n      );\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nilejs/client",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "Standalone, type-safe client for Nile backend framework",
   "main": "./dist/index.cjs",
@@ -18,10 +18,14 @@
   ],
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch"
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^5",
-    "tsup": "^8.5.1"
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.0.18"
   }
 }