@lumeweb/portal-sdk 0.1.0 → 0.1.1

package/dist/cjs/query-utils.d.cts

@@ -1,65 +0,0 @@
-import { SerializeInput } from "@lumeweb/query-builder";
-
-//#region src/query-utils.d.ts
-
-/**
- * Operations query parameters for the operations API
- *
- * Uses query-builder helpers to construct the API query parameters:
- * - filters: Array of filter objects → serialized to filters[field][operator]=value
- * - sorters: Array of sort objects → serialized to _sort=field&_order=direction
- * - pagination: Object with start/end → serialized to _start=0&_end=20
- * - search: Search term → passed directly as search=value
- *
- * @example
- * ```ts
- * const params: OperationsQueryParams = {
- *   filters: [
- *     { field: "status", operator: "eq", value: "completed" },
- *     { field: "operation", operator: "in", value: ["upload", "download"] }
- *   ],
- *   sorters: [{ field: "id", order: "desc" }],
- *   pagination: { start: 0, end: 20, page: 1, pageSize: 20 },
- *   search: "myfile"
- * };
- * ```
- */
-interface OperationsQueryParams extends SerializeInput {
-  /** Search term for filename or other relevant operation data */
-  search?: string;
-}
-/**
- * Unified operations query parameters
- */
-type OperationsListParams = OperationsQueryParams;
-/**
- * Builds URL query parameters for operations API
- *
- * Serializes query-builder parameters to the API's expected format:
- * - filters → filters[field][operator]=value
- * - sorters → _sort=field&_order=direction
- * - pagination → _start=0&_end=20
- * - search → search=value
- *
- * @param params - Query parameters using query-builder helpers
- * @returns URLSearchParams object ready to use with fetch
- *
- * @example
- * ```ts
- * const searchParams = buildOperationsQueryParams({
- *   filters: [
- *     { field: "status", operator: "eq", value: "completed" },
- *     { field: "operation", operator: "in", value: ["upload", "download"] }
- *   ],
- *   sorters: [{ field: "id", order: "desc" }],
- *   pagination: { start: 0, end: 20, page: 1, pageSize: 20 },
- *   search: "myfile"
- * });
- *
- * // Result URL: ?filters[status][eq]=completed&filters[operation][in][0]=upload&filters[operation][in][1]=download&_sort=id&_order=desc&_start=0&_end=20&search=myfile
- * ```
- */
-declare function buildOperationsQueryParams(params: OperationsQueryParams): URLSearchParams;
-//#endregion
-export { OperationsListParams, OperationsQueryParams, buildOperationsQueryParams };
-//# sourceMappingURL=query-utils.d.cts.map

package/dist/cjs/sdk.cjs

@@ -1,20 +0,0 @@
-const require_account = require('./account.cjs');
-
-//#region src/sdk.ts
-var Sdk = class {
-	accountApi;
-	constructor(apiUrl) {
-		if (!apiUrl) throw new Error("API URL is required");
-		this.accountApi = new require_account.AccountApi(apiUrl);
-	}
-	account() {
-		return this.accountApi;
-	}
-	setAuthToken(token) {
-		this.accountApi.setToken(token);
-	}
-};
-
-//#endregion
-exports.Sdk = Sdk;
-//# sourceMappingURL=sdk.cjs.map

package/dist/cjs/sdk.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk.cjs","names":["AccountApi"],"sources":["../../src/sdk.ts"],"sourcesContent":["import { AccountApi } from \"@/account\";\n\nexport class Sdk {\n  private readonly accountApi: AccountApi;\n\n  constructor(apiUrl: string) {\n    if (!apiUrl) throw new Error(\"API URL is required\");\n    this.accountApi = new AccountApi(apiUrl);\n  }\n\n  public account(): AccountApi {\n    return this.accountApi;\n  }\n\n  public setAuthToken(token: string): void {\n    this.accountApi.setToken(token);\n  }\n}\n"],"mappings":";;;AAEA,IAAa,MAAb,MAAiB;CACf,AAAiB;CAEjB,YAAY,QAAgB;AAC1B,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,sBAAsB;AACnD,OAAK,aAAa,IAAIA,2BAAW,OAAO;;CAG1C,AAAO,UAAsB;AAC3B,SAAO,KAAK;;CAGd,AAAO,aAAa,OAAqB;AACvC,OAAK,WAAW,SAAS,MAAM"}

package/dist/cjs/sdk.d.cts

@@ -1,12 +0,0 @@
-import { AccountApi } from "./account.cjs";
-
-//#region src/sdk.d.ts
-declare class Sdk {
-  private readonly accountApi;
-  constructor(apiUrl: string);
-  account(): AccountApi;
-  setAuthToken(token: string): void;
-}
-//#endregion
-export { Sdk };
-//# sourceMappingURL=sdk.d.cts.map

package/dist/cjs/types.cjs

@@ -1,116 +0,0 @@
-const require_http_utils = require('./http-utils.cjs');
-
-//#region src/types.ts
-/**
-* Standard error type for account-related operations
-*/
-var AccountError = class extends Error {
-	details;
-	fields;
-	constructor(message, statusCode, details, fields) {
-		super(message);
-		this.statusCode = statusCode;
-		this.name = "AccountError";
-		this.details = details;
-		this.fields = fields;
-	}
-	toJSON() {
-		return {
-			details: this.details,
-			fields: this.fields,
-			message: this.message,
-			statusCode: this.statusCode
-		};
-	}
-};
-/**
-* Helper function to normalize field values
-*/
-function normalizeFields(fields) {
-	if (!fields) return void 0;
-	const normalized = {};
-	for (const [key, value] of Object.entries(fields)) if (Array.isArray(value)) normalized[key] = value.join(", ");
-	else if (value === null || value === void 0) normalized[key] = "";
-	else if (typeof value === "object") normalized[key] = JSON.stringify(value);
-	else normalized[key] = String(value);
-	return normalized;
-}
-/**
-* Extract error details from a response JSON object
-*/
-function extractErrorDetails(data) {
-	let result = {
-		message: "",
-		details: void 0,
-		fields: void 0
-	};
-	if (data?.error) {
-		if (typeof data.error === "string") result.message = data.error;
-		else if (data.error?.message) {
-			result.message = data.error.message;
-			result.details = data.error.details;
-			result.fields = normalizeFields(data.error.fields);
-		}
-	} else if (data?.message) {
-		result.message = data.message;
-		result.details = data.details;
-		result.fields = normalizeFields(data.fields);
-	} else result.message = JSON.stringify(data);
-	if (!result.fields) result.fields = normalizeFields(data?.fields) || normalizeFields(data?.error?.fields);
-	return result;
-}
-/**
-* Convert a failed fetch Response to an AccountError
-* @param response The failed Response object
-* @returns A properly formatted AccountError
-*/
-async function handleFetchError(response) {
-	try {
-		const isJson = response.headers.get("content-type")?.toLowerCase()?.includes("json");
-		const clone = response.clone();
-		let errorData;
-		if (isJson) try {
-			errorData = await response.json();
-		} catch {
-			errorData = await clone.text().catch(() => "") || response.statusText;
-		}
-		else {
-			errorData = await response.text();
-			if (!errorData) errorData = response.statusText;
-		}
-		const { message, details, fields } = typeof errorData === "string" ? { message: errorData } : extractErrorDetails(errorData);
-		return new AccountError(message || "Unknown error", response.status, details, fields);
-	} catch (e) {
-		return new AccountError(response.statusText || "Unknown error", response.status, { cause: e });
-	}
-}
-/**
-* Convert an unknown error to an AccountError
-* @param e The unknown error
-* @returns A properly formatted AccountError
-*/
-function handleUnknownError(e) {
-	if (e instanceof AccountError) return e;
-	if (e instanceof Error) return new AccountError(e.message, 500, { cause: e });
-	if (typeof e === "object" && e !== null) {
-		let msg;
-		try {
-			msg = JSON.stringify(e);
-		} catch {
-			msg = String(e);
-		}
-		return new AccountError(msg, 500, { cause: e });
-	}
-	return new AccountError(String(e), 500);
-}
-
-//#endregion
-exports.AccountError = AccountError;
-exports.delay = require_http_utils.delay;
-exports.fetchWithHandling = require_http_utils.fetchWithHandling;
-exports.handleFetchError = handleFetchError;
-exports.handleUnknownError = handleUnknownError;
-exports.isEmptyResponse = require_http_utils.isEmptyResponse;
-exports.parseResponse = require_http_utils.parseResponse;
-exports.poll = require_http_utils.poll;
-//# sourceMappingURL=types.cjs.map

package/dist/cjs/types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../src/types.ts"],"sourcesContent":["export interface RequestInit extends Omit<globalThis.RequestInit, \"headers\"> {\n  headers?: Record<string, string>;\n}\n\n/**\n * Generic Result type for consistent error handling\n * @template T The type of data returned on success\n */\nexport type Result<T> =\n  | {\n      data: T;\n      success: true;\n    }\n  | {\n      error: AccountError;\n      success: false;\n    };\n\n/**\n * Standard error type for account-related operations\n */\nexport class AccountError extends Error {\n  public details?: any;\n  public fields?: Record<string, string>;\n\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    details?: any,\n    fields?: Record<string, string>,\n  ) {\n    super(message);\n    this.name = \"AccountError\";\n    this.details = details;\n    this.fields = fields;\n  }\n\n  toJSON() {\n    return {\n      details: this.details,\n      fields: this.fields,\n      message: this.message,\n      statusCode: this.statusCode,\n    };\n  }\n}\n\n/**\n * Helper function to normalize field values\n */\nfunction normalizeFields(fields: Record<string, any>): Record<string, string> | undefined {\n  if (!fields) return undefined;\n  \n  const normalized: Record<string, string> = {};\n  for (const [key, value] of Object.entries(fields)) {\n    if (Array.isArray(value)) {\n      normalized[key] = value.join(', ');\n    } else if (value === null || value === undefined) {\n      normalized[key] = '';\n    } else if (typeof value === 'object') {\n      normalized[key] = JSON.stringify(value);\n    } else {\n      normalized[key] = String(value);\n    }\n  }\n  return normalized;\n}\n\n/**\n * Extract error details from a response JSON object\n */\nfunction extractErrorDetails(data: any): {\n  message: string;\n  details?: any;\n  fields?: Record<string, string>;\n} {\n  let result: {\n    message: string;\n    details?: any;\n    fields?: Record<string, string>;\n  } = {\n    message: '',\n    details: undefined,\n    fields: undefined\n  };\n\n  // Handle standard error format\n  if (data?.error) {\n    if (typeof data.error === 'string') {\n      result.message = data.error;\n    } else if (data.error?.message) {\n      result.message = data.error.message;\n      result.details = data.error.details;\n      result.fields = normalizeFields(data.error.fields);\n    }\n  } \n  // Handle alternative error formats\n  else if (data?.message) {\n    result.message = data.message;\n    result.details = data.details;\n    result.fields = normalizeFields(data.fields);\n  } else {\n    result.message = JSON.stringify(data);\n  }\n\n  // Always include fields if they exist at any level\n  if (!result.fields) {\n    result.fields = normalizeFields(data?.fields) || normalizeFields(data?.error?.fields);\n  }\n\n  return result;\n}\n\n/**\n * Convert a failed fetch Response to an AccountError\n * @param response The failed Response object\n * @returns A properly formatted AccountError\n */\nexport async function handleFetchError(\n  response: Response,\n): Promise<AccountError> {\n  try {\n    const contentType = response.headers.get('content-type');\n    const isJson = contentType?.toLowerCase()?.includes('json');\n    const clone = response.clone();\n    let errorData: any;\n\n    if (isJson) {\n      try {\n        errorData = await response.json();\n      } catch {\n        // Preserve status; fall back to text/statusText\n        const txt = await clone.text().catch(() => '');\n        errorData = txt || response.statusText;\n      }\n    } else {\n      errorData = await response.text();\n      if (!errorData) errorData = response.statusText;\n    }\n\n    const { message, details, fields } = typeof errorData === 'string' \n      ? { message: errorData }\n      : extractErrorDetails(errorData);\n\n    return new AccountError(\n      message || 'Unknown error',\n      response.status,\n      details,\n      fields\n    );\n  } catch (e) {\n    // As a last resort, still preserve the HTTP status when possible\n    return new AccountError(\n      response.statusText || 'Unknown error',\n      response.status,\n      { cause: e }\n    );\n  }\n}\n\n/**\n * Convert an unknown error to an AccountError\n * @param e The unknown error\n * @returns A properly formatted AccountError\n */\nexport function handleUnknownError(e: unknown): AccountError {\n  if (e instanceof AccountError) {\n    return e;\n  }\n\n  if (e instanceof Error) {\n    return new AccountError(e.message, 500, { cause: e });\n  }\n\n  if (typeof e === \"object\" && e !== null) {\n    let msg: string;\n    try {\n      msg = JSON.stringify(e);\n    } catch {\n      msg = String(e);\n    }\n    return new AccountError(msg, 500, { cause: e });\n  }\n\n  return new AccountError(String(e), 500);\n}\n\n/**\n * Options for polling/waiting for an operation to complete\n */\nexport interface OperationPollingOptions {\n  /** Polling interval in milliseconds (default: 2000) */\n  interval?: number;\n  /** Maximum time to wait in milliseconds (default: 300000 = 5 minutes) */\n  timeout?: number;\n  /** Operation statuses that are considered \"settled\" (default: ['completed', 'failed', 'error']) */\n  settledStates?: string[];\n}\n\n// Re-export HTTP utilities for convenience\nexport {\n  delay,\n  isEmptyResponse,\n  parseResponse,\n  fetchWithHandling,\n  poll,\n  type PollOptions,\n} from \"@/http-utils\";\n"],"mappings":";;;;;;AAqBA,IAAa,eAAb,cAAkC,MAAM;CACtC,AAAO;CACP,AAAO;CAEP,YACE,SACA,AAAgB,YAChB,SACA,QACA;AACA,QAAM,QAAQ;EAJE;AAKhB,OAAK,OAAO;AACZ,OAAK,UAAU;AACf,OAAK,SAAS;;CAGhB,SAAS;AACP,SAAO;GACL,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,SAAS,KAAK;GACd,YAAY,KAAK;GAClB;;;;;;AAOL,SAAS,gBAAgB,QAAiE;AACxF,KAAI,CAAC,OAAQ,QAAO;CAEpB,MAAM,aAAqC,EAAE;AAC7C,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,MAAM,QAAQ,MAAM,CACtB,YAAW,OAAO,MAAM,KAAK,KAAK;UACzB,UAAU,QAAQ,UAAU,OACrC,YAAW,OAAO;UACT,OAAO,UAAU,SAC1B,YAAW,OAAO,KAAK,UAAU,MAAM;KAEvC,YAAW,OAAO,OAAO,MAAM;AAGnC,QAAO;;;;;AAMT,SAAS,oBAAoB,MAI3B;CACA,IAAI,SAIA;EACF,SAAS;EACT,SAAS;EACT,QAAQ;EACT;AAGD,KAAI,MAAM,OACR;MAAI,OAAO,KAAK,UAAU,SACxB,QAAO,UAAU,KAAK;WACb,KAAK,OAAO,SAAS;AAC9B,UAAO,UAAU,KAAK,MAAM;AAC5B,UAAO,UAAU,KAAK,MAAM;AAC5B,UAAO,SAAS,gBAAgB,KAAK,MAAM,OAAO;;YAI7C,MAAM,SAAS;AACtB,SAAO,UAAU,KAAK;AACtB,SAAO,UAAU,KAAK;AACtB,SAAO,SAAS,gBAAgB,KAAK,OAAO;OAE5C,QAAO,UAAU,KAAK,UAAU,KAAK;AAIvC,KAAI,CAAC,OAAO,OACV,QAAO,SAAS,gBAAgB,MAAM,OAAO,IAAI,gBAAgB,MAAM,OAAO,OAAO;AAGvF,QAAO;;;;;;;AAQT,eAAsB,iBACpB,UACuB;AACvB,KAAI;EAEF,MAAM,SADc,SAAS,QAAQ,IAAI,eAAe,EAC5B,aAAa,EAAE,SAAS,OAAO;EAC3D,MAAM,QAAQ,SAAS,OAAO;EAC9B,IAAI;AAEJ,MAAI,OACF,KAAI;AACF,eAAY,MAAM,SAAS,MAAM;UAC3B;AAGN,eADY,MAAM,MAAM,MAAM,CAAC,YAAY,GAAG,IAC3B,SAAS;;OAEzB;AACL,eAAY,MAAM,SAAS,MAAM;AACjC,OAAI,CAAC,UAAW,aAAY,SAAS;;EAGvC,MAAM,EAAE,SAAS,SAAS,WAAW,OAAO,cAAc,WACtD,EAAE,SAAS,WAAW,GACtB,oBAAoB,UAAU;AAElC,SAAO,IAAI,aACT,WAAW,iBACX,SAAS,QACT,SACA,OACD;UACM,GAAG;AAEV,SAAO,IAAI,aACT,SAAS,cAAc,iBACvB,SAAS,QACT,EAAE,OAAO,GAAG,CACb;;;;;;;;AASL,SAAgB,mBAAmB,GAA0B;AAC3D,KAAI,aAAa,aACf,QAAO;AAGT,KAAI,aAAa,MACf,QAAO,IAAI,aAAa,EAAE,SAAS,KAAK,EAAE,OAAO,GAAG,CAAC;AAGvD,KAAI,OAAO,MAAM,YAAY,MAAM,MAAM;EACvC,IAAI;AACJ,MAAI;AACF,SAAM,KAAK,UAAU,EAAE;UACjB;AACN,SAAM,OAAO,EAAE;;AAEjB,SAAO,IAAI,aAAa,KAAK,KAAK,EAAE,OAAO,GAAG,CAAC;;AAGjD,QAAO,IAAI,aAAa,OAAO,EAAE,EAAE,IAAI"}

package/dist/cjs/types.d.cts

@@ -1,58 +0,0 @@
-import { PollOptions, delay, fetchWithHandling, isEmptyResponse, parseResponse, poll } from "./http-utils.cjs";
-
-//#region src/types.d.ts
-interface RequestInit extends Omit<globalThis.RequestInit, "headers"> {
-  headers?: Record<string, string>;
-}
-/**
- * Generic Result type for consistent error handling
- * @template T The type of data returned on success
- */
-type Result<T> = {
-  data: T;
-  success: true;
-} | {
-  error: AccountError;
-  success: false;
-};
-/**
- * Standard error type for account-related operations
- */
-declare class AccountError extends Error {
-  readonly statusCode: number;
-  details?: any;
-  fields?: Record<string, string>;
-  constructor(message: string, statusCode: number, details?: any, fields?: Record<string, string>);
-  toJSON(): {
-    details: any;
-    fields: Record<string, string> | undefined;
-    message: string;
-    statusCode: number;
-  };
-}
-/**
- * Convert a failed fetch Response to an AccountError
- * @param response The failed Response object
- * @returns A properly formatted AccountError
- */
-declare function handleFetchError(response: Response): Promise<AccountError>;
-/**
- * Convert an unknown error to an AccountError
- * @param e The unknown error
- * @returns A properly formatted AccountError
- */
-declare function handleUnknownError(e: unknown): AccountError;
-/**
- * Options for polling/waiting for an operation to complete
- */
-interface OperationPollingOptions {
-  /** Polling interval in milliseconds (default: 2000) */
-  interval?: number;
-  /** Maximum time to wait in milliseconds (default: 300000 = 5 minutes) */
-  timeout?: number;
-  /** Operation statuses that are considered "settled" (default: ['completed', 'failed', 'error']) */
-  settledStates?: string[];
-}
-//#endregion
-export { AccountError, OperationPollingOptions, type PollOptions, RequestInit, Result, delay, fetchWithHandling, handleFetchError, handleUnknownError, isEmptyResponse, parseResponse, poll };
-//# sourceMappingURL=types.d.cts.map