@opendatalabs/vana-sdk 0.1.0-alpha.ffe4659 → 2.0.0

package/dist/types/data.js

@@ -0,0 +1 @@
+//# sourceMappingURL=data.js.map

package/dist/types/data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/eccrypto-js.d.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=eccrypto-js.d.cjs.map

package/dist/types/eccrypto-js.d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/eccrypto-js.d.js

@@ -0,0 +1 @@
+//# sourceMappingURL=eccrypto-js.d.js.map

package/dist/types/eccrypto-js.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/external-apis.cjs

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var external_apis_exports = {};
+__export(external_apis_exports, {
+  isAPIResponse: () => isAPIResponse,
+  isReplicateAPIResponse: () => isReplicateAPIResponse,
+  parseReplicateOutput: () => parseReplicateOutput,
+  safeParseJSON: () => safeParseJSON
+});
+module.exports = __toCommonJS(external_apis_exports);
+function isReplicateAPIResponse(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return "id" in obj && "status" in obj && "urls" in obj && typeof obj.id === "string" && ["starting", "processing", "succeeded", "failed", "canceled"].includes(
+    obj.status
+  );
+}
+function isAPIResponse(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return "success" in obj && typeof obj.success === "boolean";
+}
+function safeParseJSON(jsonString, typeGuard) {
+  try {
+    const parsed = JSON.parse(jsonString);
+    return typeGuard(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function parseReplicateOutput(response, typeGuard) {
+  if (!response.output) return null;
+  if (typeof response.output === "string") {
+    return safeParseJSON(response.output, typeGuard);
+  }
+  return typeGuard(response.output) ? response.output : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isAPIResponse,
+  isReplicateAPIResponse,
+  parseReplicateOutput,
+  safeParseJSON
+});
+//# sourceMappingURL=external-apis.cjs.map

package/dist/types/external-apis.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/external-apis.ts"],"sourcesContent":["/**\n * Types for external API responses used by the Vana SDK\n * These types help ensure type safety when interacting with third-party services\n */\n\n/**\n * Replicate API Response Types\n * Documentation: https://replicate.com/docs/reference/http\n */\n\n/** Status values for Replicate predictions */\nexport type ReplicateStatus =\n  | \"starting\"\n  | \"processing\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"canceled\";\n\n/** Base Replicate API prediction response */\nexport interface ReplicateAPIResponse {\n  /** Unique identifier for the prediction */\n  id: string;\n  /** Model version identifier */\n  version: string;\n  /** Current status of the prediction */\n  status: ReplicateStatus;\n  /** Input parameters sent to the model */\n  input: Record<string, unknown>;\n  /** Output from the model (if completed successfully) */\n  output?: unknown;\n  /** Error message (if failed) */\n  error?: string | null;\n  /** Logs from the prediction run */\n  logs?: string;\n  /** Whether data has been removed due to content policy */\n  data_removed?: boolean;\n  /** Timestamp when prediction was created */\n  created_at: string;\n  /** Timestamp when prediction started processing */\n  started_at?: string;\n  /** Timestamp when prediction completed */\n  completed_at?: string;\n  /** URLs for interacting with the prediction */\n  urls: {\n    /** URL to get prediction status/results */\n    get: string;\n    /** URL to cancel the prediction */\n    cancel: string;\n    /** Web interface URL */\n    web?: string;\n  };\n  /** Performance metrics */\n  metrics?: {\n    /** Time spent in prediction (seconds) */\n    predict_time?: number;\n    /** Total time including setup (seconds) */\n    total_time?: number;\n  };\n}\n\n// Note: Server-specific types have been moved to auto-generated types in server.ts\n// Import types from @opendatalabs/vana-sdk/types/server-exports instead\n\n/**\n * Storage Provider API Types\n */\n\n/** Pinata IPFS upload response */\nexport interface PinataUploadResponse {\n  /** IPFS hash of the uploaded content */\n  IpfsHash: string;\n  /** Size of the pinned content in bytes */\n  PinSize: number;\n  /** Timestamp of when content was pinned */\n  Timestamp: string;\n  /** Whether this content was already pinned */\n  isDuplicate?: boolean;\n}\n\n/** Pinata pin information */\nexport interface PinataPin {\n  /** IPFS hash */\n  ipfs_pin_hash: string;\n  /** Pin size in bytes */\n  size: number;\n  /** User ID */\n  user_id: string;\n  /** Date pinned */\n  date_pinned: string;\n  /** Date unpinned (if applicable) */\n  date_unpinned?: string;\n  /** Additional metadata */\n  metadata?: {\n    name?: string;\n    keyvalues?: Record<string, string>;\n  };\n}\n\n/** Pinata list response */\nexport interface PinataListResponse {\n  /** Total count of pins */\n  count: number;\n  /** Array of pin information */\n  rows: PinataPin[];\n}\n\n/**\n * Generic API Response Wrapper\n * Used for internal API routes in the demo application\n */\n\n/** Standard API response wrapper */\nexport interface APIResponse<T = unknown> {\n  /** Whether the request was successful */\n  success: boolean;\n  /** Response data (if successful) */\n  data?: T;\n  /** Error message (if unsuccessful) */\n  error?: string;\n}\n\n/**\n * Type Guards for Runtime Validation\n */\n\n/**\n * Validates whether a value is a valid ReplicateAPIResponse.\n *\n * @param value - The value to check\n * @returns True if the value matches the ReplicateAPIResponse structure\n * @example\n * ```typescript\n * const response = await fetch('/api/replicate');\n * const data = await response.json();\n *\n * if (isReplicateAPIResponse(data)) {\n *   console.log('Status:', data.status);\n *   console.log('Output:', data.output);\n * }\n * ```\n */\nexport function isReplicateAPIResponse(\n  value: unknown,\n): value is ReplicateAPIResponse {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n  return (\n    \"id\" in obj &&\n    \"status\" in obj &&\n    \"urls\" in obj &&\n    typeof obj.id === \"string\" &&\n    [\"starting\", \"processing\", \"succeeded\", \"failed\", \"canceled\"].includes(\n      obj.status as string,\n    )\n  );\n}\n\n// Note: Type guards for server types removed - use generated types and create\n// type guards for IdentityResponseModel and PersonalServerModel from\n// @opendatalabs/vana-sdk/types/server-exports if needed\n\n/**\n * Validates whether a value is a valid APIResponse.\n *\n * @param value - The value to check\n * @returns True if the value matches the APIResponse structure\n * @example\n * ```typescript\n * const response = await fetch('/api/data');\n * const data = await response.json();\n *\n * if (isAPIResponse(data)) {\n *   if (data.success) {\n *     console.log('Data:', data.data);\n *   } else {\n *     console.error('Error:', data.error);\n *   }\n * }\n * ```\n */\nexport function isAPIResponse<T>(value: unknown): value is APIResponse<T> {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n  return \"success\" in obj && typeof obj.success === \"boolean\";\n}\n\n/**\n * Utility Functions for Safe JSON Parsing\n */\n\n/**\n * Safely parses JSON string with type validation.\n *\n * @param jsonString - The JSON string to parse\n * @param typeGuard - Type guard function to validate the parsed value\n * @returns The parsed and validated value, or null if parsing/validation fails\n * @example\n * ```typescript\n * const jsonStr = '{\"user_address\": \"0x123...\", \"identity\": {}}';\n * const result = safeParseJSON(jsonStr, isAPIResponse);\n *\n * if (result) {\n *   console.log('Parsed server output:', result.user_address);\n * } else {\n *   console.log('Invalid JSON or type mismatch');\n * }\n * ```\n */\nexport function safeParseJSON<T>(\n  jsonString: string,\n  typeGuard: (value: unknown) => value is T,\n): T | null {\n  try {\n    const parsed = JSON.parse(jsonString);\n    return typeGuard(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses Replicate API response output with type safety.\n *\n * @param response - The Replicate API response\n * @param typeGuard - Type guard function to validate the output\n * @returns The parsed and validated output, or null if validation fails\n * @example\n * ```typescript\n * const response = await replicateClient.get(predictionId);\n * const output = parseReplicateOutput(response, isReplicateAPIResponse);\n *\n * if (output) {\n *   console.log('Identity server result:', output.user_address);\n * } else {\n *   console.log('Output not available or invalid format');\n * }\n * ```\n */\nexport function parseReplicateOutput<T>(\n  response: ReplicateAPIResponse,\n  typeGuard: (value: unknown) => value is T,\n): T | null {\n  if (!response.output) return null;\n\n  if (typeof response.output === \"string\") {\n    return safeParseJSON(response.output, typeGuard);\n  }\n\n  return typeGuard(response.output) ? response.output : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6IO,SAAS,uBACd,OAC+B;AAC/B,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AAExD,QAAM,MAAM;AACZ,SACE,QAAQ,OACR,YAAY,OACZ,UAAU,OACV,OAAO,IAAI,OAAO,YAClB,CAAC,YAAY,cAAc,aAAa,UAAU,UAAU,EAAE;AAAA,IAC5D,IAAI;AAAA,EACN;AAEJ;AAyBO,SAAS,cAAiB,OAAyC;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AAExD,QAAM,MAAM;AACZ,SAAO,aAAa,OAAO,OAAO,IAAI,YAAY;AACpD;AAwBO,SAAS,cACd,YACA,WACU;AACV,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,UAAU;AACpC,WAAO,UAAU,MAAM,IAAI,SAAS;AAAA,EACtC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAoBO,SAAS,qBACd,UACA,WACU;AACV,MAAI,CAAC,SAAS,OAAQ,QAAO;AAE7B,MAAI,OAAO,SAAS,WAAW,UAAU;AACvC,WAAO,cAAc,SAAS,QAAQ,SAAS;AAAA,EACjD;AAEA,SAAO,UAAU,SAAS,MAAM,IAAI,SAAS,SAAS;AACxD;","names":[]}

package/dist/types/external-apis.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Types for external API responses used by the Vana SDK
+ * These types help ensure type safety when interacting with third-party services
+ */
+/**
+ * Replicate API Response Types
+ * Documentation: https://replicate.com/docs/reference/http
+ */
+/** Status values for Replicate predictions */
+export type ReplicateStatus = "starting" | "processing" | "succeeded" | "failed" | "canceled";
+/** Base Replicate API prediction response */
+export interface ReplicateAPIResponse {
+    /** Unique identifier for the prediction */
+    id: string;
+    /** Model version identifier */
+    version: string;
+    /** Current status of the prediction */
+    status: ReplicateStatus;
+    /** Input parameters sent to the model */
+    input: Record<string, unknown>;
+    /** Output from the model (if completed successfully) */
+    output?: unknown;
+    /** Error message (if failed) */
+    error?: string | null;
+    /** Logs from the prediction run */
+    logs?: string;
+    /** Whether data has been removed due to content policy */
+    data_removed?: boolean;
+    /** Timestamp when prediction was created */
+    created_at: string;
+    /** Timestamp when prediction started processing */
+    started_at?: string;
+    /** Timestamp when prediction completed */
+    completed_at?: string;
+    /** URLs for interacting with the prediction */
+    urls: {
+        /** URL to get prediction status/results */
+        get: string;
+        /** URL to cancel the prediction */
+        cancel: string;
+        /** Web interface URL */
+        web?: string;
+    };
+    /** Performance metrics */
+    metrics?: {
+        /** Time spent in prediction (seconds) */
+        predict_time?: number;
+        /** Total time including setup (seconds) */
+        total_time?: number;
+    };
+}
+/**
+ * Storage Provider API Types
+ */
+/** Pinata IPFS upload response */
+export interface PinataUploadResponse {
+    /** IPFS hash of the uploaded content */
+    IpfsHash: string;
+    /** Size of the pinned content in bytes */
+    PinSize: number;
+    /** Timestamp of when content was pinned */
+    Timestamp: string;
+    /** Whether this content was already pinned */
+    isDuplicate?: boolean;
+}
+/** Pinata pin information */
+export interface PinataPin {
+    /** IPFS hash */
+    ipfs_pin_hash: string;
+    /** Pin size in bytes */
+    size: number;
+    /** User ID */
+    user_id: string;
+    /** Date pinned */
+    date_pinned: string;
+    /** Date unpinned (if applicable) */
+    date_unpinned?: string;
+    /** Additional metadata */
+    metadata?: {
+        name?: string;
+        keyvalues?: Record<string, string>;
+    };
+}
+/** Pinata list response */
+export interface PinataListResponse {
+    /** Total count of pins */
+    count: number;
+    /** Array of pin information */
+    rows: PinataPin[];
+}
+/**
+ * Generic API Response Wrapper
+ * Used for internal API routes in the demo application
+ */
+/** Standard API response wrapper */
+export interface APIResponse<T = unknown> {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Response data (if successful) */
+    data?: T;
+    /** Error message (if unsuccessful) */
+    error?: string;
+}
+/**
+ * Type Guards for Runtime Validation
+ */
+/**
+ * Validates whether a value is a valid ReplicateAPIResponse.
+ *
+ * @param value - The value to check
+ * @returns True if the value matches the ReplicateAPIResponse structure
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/replicate');
+ * const data = await response.json();
+ *
+ * if (isReplicateAPIResponse(data)) {
+ *   console.log('Status:', data.status);
+ *   console.log('Output:', data.output);
+ * }
+ * ```
+ */
+export declare function isReplicateAPIResponse(value: unknown): value is ReplicateAPIResponse;
+/**
+ * Validates whether a value is a valid APIResponse.
+ *
+ * @param value - The value to check
+ * @returns True if the value matches the APIResponse structure
+ * @example
+ * ```typescript
+ * const response = await fetch('/api/data');
+ * const data = await response.json();
+ *
+ * if (isAPIResponse(data)) {
+ *   if (data.success) {
+ *     console.log('Data:', data.data);
+ *   } else {
+ *     console.error('Error:', data.error);
+ *   }
+ * }
+ * ```
+ */
+export declare function isAPIResponse<T>(value: unknown): value is APIResponse<T>;
+/**
+ * Utility Functions for Safe JSON Parsing
+ */
+/**
+ * Safely parses JSON string with type validation.
+ *
+ * @param jsonString - The JSON string to parse
+ * @param typeGuard - Type guard function to validate the parsed value
+ * @returns The parsed and validated value, or null if parsing/validation fails
+ * @example
+ * ```typescript
+ * const jsonStr = '{"user_address": "0x123...", "identity": {}}';
+ * const result = safeParseJSON(jsonStr, isAPIResponse);
+ *
+ * if (result) {
+ *   console.log('Parsed server output:', result.user_address);
+ * } else {
+ *   console.log('Invalid JSON or type mismatch');
+ * }
+ * ```
+ */
+export declare function safeParseJSON<T>(jsonString: string, typeGuard: (value: unknown) => value is T): T | null;
+/**
+ * Parses Replicate API response output with type safety.
+ *
+ * @param response - The Replicate API response
+ * @param typeGuard - Type guard function to validate the output
+ * @returns The parsed and validated output, or null if validation fails
+ * @example
+ * ```typescript
+ * const response = await replicateClient.get(predictionId);
+ * const output = parseReplicateOutput(response, isReplicateAPIResponse);
+ *
+ * if (output) {
+ *   console.log('Identity server result:', output.user_address);
+ * } else {
+ *   console.log('Output not available or invalid format');
+ * }
+ * ```
+ */
+export declare function parseReplicateOutput<T>(response: ReplicateAPIResponse, typeGuard: (value: unknown) => value is T): T | null;

package/dist/types/external-apis.js

@@ -0,0 +1,34 @@
+function isReplicateAPIResponse(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return "id" in obj && "status" in obj && "urls" in obj && typeof obj.id === "string" && ["starting", "processing", "succeeded", "failed", "canceled"].includes(
+    obj.status
+  );
+}
+function isAPIResponse(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return "success" in obj && typeof obj.success === "boolean";
+}
+function safeParseJSON(jsonString, typeGuard) {
+  try {
+    const parsed = JSON.parse(jsonString);
+    return typeGuard(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function parseReplicateOutput(response, typeGuard) {
+  if (!response.output) return null;
+  if (typeof response.output === "string") {
+    return safeParseJSON(response.output, typeGuard);
+  }
+  return typeGuard(response.output) ? response.output : null;
+}
+export {
+  isAPIResponse,
+  isReplicateAPIResponse,
+  parseReplicateOutput,
+  safeParseJSON
+};
+//# sourceMappingURL=external-apis.js.map

package/dist/types/external-apis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/external-apis.ts"],"sourcesContent":["/**\n * Types for external API responses used by the Vana SDK\n * These types help ensure type safety when interacting with third-party services\n */\n\n/**\n * Replicate API Response Types\n * Documentation: https://replicate.com/docs/reference/http\n */\n\n/** Status values for Replicate predictions */\nexport type ReplicateStatus =\n  | \"starting\"\n  | \"processing\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"canceled\";\n\n/** Base Replicate API prediction response */\nexport interface ReplicateAPIResponse {\n  /** Unique identifier for the prediction */\n  id: string;\n  /** Model version identifier */\n  version: string;\n  /** Current status of the prediction */\n  status: ReplicateStatus;\n  /** Input parameters sent to the model */\n  input: Record<string, unknown>;\n  /** Output from the model (if completed successfully) */\n  output?: unknown;\n  /** Error message (if failed) */\n  error?: string | null;\n  /** Logs from the prediction run */\n  logs?: string;\n  /** Whether data has been removed due to content policy */\n  data_removed?: boolean;\n  /** Timestamp when prediction was created */\n  created_at: string;\n  /** Timestamp when prediction started processing */\n  started_at?: string;\n  /** Timestamp when prediction completed */\n  completed_at?: string;\n  /** URLs for interacting with the prediction */\n  urls: {\n    /** URL to get prediction status/results */\n    get: string;\n    /** URL to cancel the prediction */\n    cancel: string;\n    /** Web interface URL */\n    web?: string;\n  };\n  /** Performance metrics */\n  metrics?: {\n    /** Time spent in prediction (seconds) */\n    predict_time?: number;\n    /** Total time including setup (seconds) */\n    total_time?: number;\n  };\n}\n\n// Note: Server-specific types have been moved to auto-generated types in server.ts\n// Import types from @opendatalabs/vana-sdk/types/server-exports instead\n\n/**\n * Storage Provider API Types\n */\n\n/** Pinata IPFS upload response */\nexport interface PinataUploadResponse {\n  /** IPFS hash of the uploaded content */\n  IpfsHash: string;\n  /** Size of the pinned content in bytes */\n  PinSize: number;\n  /** Timestamp of when content was pinned */\n  Timestamp: string;\n  /** Whether this content was already pinned */\n  isDuplicate?: boolean;\n}\n\n/** Pinata pin information */\nexport interface PinataPin {\n  /** IPFS hash */\n  ipfs_pin_hash: string;\n  /** Pin size in bytes */\n  size: number;\n  /** User ID */\n  user_id: string;\n  /** Date pinned */\n  date_pinned: string;\n  /** Date unpinned (if applicable) */\n  date_unpinned?: string;\n  /** Additional metadata */\n  metadata?: {\n    name?: string;\n    keyvalues?: Record<string, string>;\n  };\n}\n\n/** Pinata list response */\nexport interface PinataListResponse {\n  /** Total count of pins */\n  count: number;\n  /** Array of pin information */\n  rows: PinataPin[];\n}\n\n/**\n * Generic API Response Wrapper\n * Used for internal API routes in the demo application\n */\n\n/** Standard API response wrapper */\nexport interface APIResponse<T = unknown> {\n  /** Whether the request was successful */\n  success: boolean;\n  /** Response data (if successful) */\n  data?: T;\n  /** Error message (if unsuccessful) */\n  error?: string;\n}\n\n/**\n * Type Guards for Runtime Validation\n */\n\n/**\n * Validates whether a value is a valid ReplicateAPIResponse.\n *\n * @param value - The value to check\n * @returns True if the value matches the ReplicateAPIResponse structure\n * @example\n * ```typescript\n * const response = await fetch('/api/replicate');\n * const data = await response.json();\n *\n * if (isReplicateAPIResponse(data)) {\n *   console.log('Status:', data.status);\n *   console.log('Output:', data.output);\n * }\n * ```\n */\nexport function isReplicateAPIResponse(\n  value: unknown,\n): value is ReplicateAPIResponse {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n  return (\n    \"id\" in obj &&\n    \"status\" in obj &&\n    \"urls\" in obj &&\n    typeof obj.id === \"string\" &&\n    [\"starting\", \"processing\", \"succeeded\", \"failed\", \"canceled\"].includes(\n      obj.status as string,\n    )\n  );\n}\n\n// Note: Type guards for server types removed - use generated types and create\n// type guards for IdentityResponseModel and PersonalServerModel from\n// @opendatalabs/vana-sdk/types/server-exports if needed\n\n/**\n * Validates whether a value is a valid APIResponse.\n *\n * @param value - The value to check\n * @returns True if the value matches the APIResponse structure\n * @example\n * ```typescript\n * const response = await fetch('/api/data');\n * const data = await response.json();\n *\n * if (isAPIResponse(data)) {\n *   if (data.success) {\n *     console.log('Data:', data.data);\n *   } else {\n *     console.error('Error:', data.error);\n *   }\n * }\n * ```\n */\nexport function isAPIResponse<T>(value: unknown): value is APIResponse<T> {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n  return \"success\" in obj && typeof obj.success === \"boolean\";\n}\n\n/**\n * Utility Functions for Safe JSON Parsing\n */\n\n/**\n * Safely parses JSON string with type validation.\n *\n * @param jsonString - The JSON string to parse\n * @param typeGuard - Type guard function to validate the parsed value\n * @returns The parsed and validated value, or null if parsing/validation fails\n * @example\n * ```typescript\n * const jsonStr = '{\"user_address\": \"0x123...\", \"identity\": {}}';\n * const result = safeParseJSON(jsonStr, isAPIResponse);\n *\n * if (result) {\n *   console.log('Parsed server output:', result.user_address);\n * } else {\n *   console.log('Invalid JSON or type mismatch');\n * }\n * ```\n */\nexport function safeParseJSON<T>(\n  jsonString: string,\n  typeGuard: (value: unknown) => value is T,\n): T | null {\n  try {\n    const parsed = JSON.parse(jsonString);\n    return typeGuard(parsed) ? parsed : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses Replicate API response output with type safety.\n *\n * @param response - The Replicate API response\n * @param typeGuard - Type guard function to validate the output\n * @returns The parsed and validated output, or null if validation fails\n * @example\n * ```typescript\n * const response = await replicateClient.get(predictionId);\n * const output = parseReplicateOutput(response, isReplicateAPIResponse);\n *\n * if (output) {\n *   console.log('Identity server result:', output.user_address);\n * } else {\n *   console.log('Output not available or invalid format');\n * }\n * ```\n */\nexport function parseReplicateOutput<T>(\n  response: ReplicateAPIResponse,\n  typeGuard: (value: unknown) => value is T,\n): T | null {\n  if (!response.output) return null;\n\n  if (typeof response.output === \"string\") {\n    return safeParseJSON(response.output, typeGuard);\n  }\n\n  return typeGuard(response.output) ? response.output : null;\n}\n"],"mappings":"AA6IO,SAAS,uBACd,OAC+B;AAC/B,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AAExD,QAAM,MAAM;AACZ,SACE,QAAQ,OACR,YAAY,OACZ,UAAU,OACV,OAAO,IAAI,OAAO,YAClB,CAAC,YAAY,cAAc,aAAa,UAAU,UAAU,EAAE;AAAA,IAC5D,IAAI;AAAA,EACN;AAEJ;AAyBO,SAAS,cAAiB,OAAyC;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AAExD,QAAM,MAAM;AACZ,SAAO,aAAa,OAAO,OAAO,IAAI,YAAY;AACpD;AAwBO,SAAS,cACd,YACA,WACU;AACV,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,UAAU;AACpC,WAAO,UAAU,MAAM,IAAI,SAAS;AAAA,EACtC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAoBO,SAAS,qBACd,UACA,WACU;AACV,MAAI,CAAC,SAAS,OAAQ,QAAO;AAE7B,MAAI,OAAO,SAAS,WAAW,UAAU;AACvC,WAAO,cAAc,SAAS,QAAQ,SAAS;AAAA,EACjD;AAEA,SAAO,UAAU,SAAS,MAAM,IAAI,SAAS,SAAS;AACxD;","names":[]}

package/dist/types/generics.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var generics_exports = {};
+module.exports = __toCommonJS(generics_exports);
+//# sourceMappingURL=generics.cjs.map

package/dist/types/generics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/generics.ts"],"sourcesContent":["/**\n * Defines generic types and interfaces for SDK infrastructure.\n *\n * @remarks\n * This module provides reusable type definitions and interfaces that form\n * the foundation of the SDK's architecture. It includes patterns for requests,\n * responses, caching, middleware, repositories, and other common software\n * engineering abstractions.\n *\n * @category Types\n * @module types/generics\n */\n\nimport type { Address, Hash } from \"viem\";\n\n/**\n * Represents a standardized request structure for SDK operations.\n *\n * @remarks\n * Provides consistent request handling across all SDK methods with\n * typed parameters and optional configuration.\n *\n * @typeParam TParams - Type of request parameters\n * @typeParam TOptions - Type of optional configuration\n *\n * @category Reference\n */\nexport interface GenericRequest<TParams = unknown, TOptions = unknown> {\n  /** Request parameters */\n  params: TParams;\n  /** Additional request options */\n  options?: TOptions;\n}\n\n/**\n * Represents a standardized response structure for SDK operations.\n *\n * @remarks\n * Provides consistent response handling with success/error states\n * and optional metadata for additional context.\n *\n * @typeParam TData - Type of response data\n * @typeParam TMeta - Type of response metadata\n *\n * @category Reference\n */\nexport interface GenericResponse<TData = unknown, TMeta = unknown> {\n  /** Response data */\n  data: TData;\n  /** Response metadata */\n  meta?: TMeta;\n  /** Success status */\n  success: boolean;\n  /** Error information if not successful */\n  error?: {\n    code: string;\n    message: string;\n    details?: unknown;\n  };\n}\n\n/**\n * Represents the result of an asynchronous blockchain operation.\n *\n * @remarks\n * Includes transaction details when the operation involves\n * blockchain state changes.\n *\n * @typeParam T - Type of the operation result\n *\n * @category Reference\n */\nexport interface AsyncResult<T> {\n  /** Operation result */\n  result: T;\n  /** Transaction hash if applicable */\n  transactionHash?: Hash;\n  /** Block number if applicable */\n  blockNumber?: bigint;\n  /** Gas used if applicable */\n  gasUsed?: bigint;\n}\n\n/**\n * Generic contract interaction parameters\n *\n * @category Reference\n */\nexport interface ContractCall<\n  TArgs extends readonly unknown[] = readonly unknown[],\n> {\n  /** Contract method name */\n  method: string;\n  /** Method arguments */\n  args: TArgs;\n  /** Call options */\n  options?: {\n    /** Gas limit */\n    gas?: bigint;\n    /** Gas price */\n    gasPrice?: bigint;\n    /** Value to send */\n    value?: bigint;\n  };\n}\n\n/**\n * Generic contract event filter\n *\n * @category Reference\n */\nexport interface EventFilter<TEventArgs = unknown> {\n  /** Event name */\n  event: string;\n  /** Event arguments filter */\n  args?: TEventArgs;\n  /** From block */\n  fromBlock?: bigint;\n  /** To block */\n  toBlock?: bigint;\n  /** Address filter */\n  address?: Address | Address[];\n}\n\n/**\n * Generic event log\n *\n * @category Reference\n */\nexport interface EventLog<TArgs = unknown> {\n  /** Event name */\n  event: string;\n  /** Event arguments */\n  args: TArgs;\n  /** Block number */\n  blockNumber: bigint;\n  /** Transaction hash */\n  transactionHash: Hash;\n  /** Log index */\n  logIndex: number;\n  /** Transaction index */\n  transactionIndex: number;\n  /** Contract address */\n  address: Address;\n}\n\n/**\n * Generic controller context for dependency injection\n *\n * @category Reference\n */\nexport interface ControllerContext<TClient = unknown, TConfig = unknown> {\n  /** Client instance */\n  client: TClient;\n  /** Configuration */\n  config?: TConfig;\n  /** Additional context */\n  [key: string]: unknown;\n}\n\n/**\n * Generic controller interface\n *\n * @category Reference\n */\nexport interface Controller<TContext = unknown> {\n  /** Controller context */\n  readonly context: TContext;\n}\n\n/**\n * Generic storage provider interface\n *\n * @category Reference\n */\nexport interface StorageProvider<TConfig = unknown, TOptions = unknown> {\n  /** Provider name */\n  readonly name: string;\n  /** Provider configuration */\n  readonly config: TConfig;\n\n  /** Upload data */\n  upload(\n    data: Uint8Array,\n    options?: TOptions,\n  ): Promise<{\n    url: string;\n    size: number;\n    checksum?: string;\n  }>;\n\n  /** Download data */\n  download(\n    url: string,\n    options?: TOptions,\n  ): Promise<{\n    data: Uint8Array;\n    size: number;\n    checksum?: string;\n  }>;\n\n  /** Delete data */\n  delete?(url: string, options?: TOptions): Promise<boolean>;\n\n  /** Check if data exists */\n  exists?(url: string, options?: TOptions): Promise<boolean>;\n}\n\n/**\n * Defines a generic caching interface with TTL support.\n *\n * @remarks\n * Provides standard cache operations for performance optimization\n * and reducing redundant computations or network requests.\n *\n * @typeParam TKey - Type of cache keys\n * @typeParam TValue - Type of cached values\n *\n * @category Reference\n */\nexport interface Cache<TKey = string, TValue = unknown> {\n  /** Get value from cache */\n  get(key: TKey): Promise<TValue | undefined>;\n\n  /** Set value in cache */\n  set(key: TKey, value: TValue, ttl?: number): Promise<void>;\n\n  /** Delete value from cache */\n  delete(key: TKey): Promise<boolean>;\n\n  /** Clear all cache */\n  clear(): Promise<void>;\n\n  /** Check if key exists */\n  has(key: TKey): Promise<boolean>;\n}\n\n/**\n * Configures retry behavior for resilient operations.\n *\n * @remarks\n * Supports exponential backoff, jitter, and custom retry conditions\n * for handling transient failures gracefully.\n *\n * @typeParam TError - Type of errors to handle\n *\n * @category Reference\n */\nexport interface RetryConfig<TError = Error> {\n  /** Maximum retry attempts */\n  maxAttempts: number;\n  /** Base delay in milliseconds */\n  baseDelay: number;\n  /** Backoff multiplier */\n  backoffMultiplier?: number;\n  /** Maximum delay */\n  maxDelay?: number;\n  /** Jitter factor */\n  jitter?: number;\n  /** Retry condition */\n  shouldRetry?: (error: TError, attempt: number) => boolean;\n}\n\n/**\n * Generic rate limiter configuration\n *\n * @category Reference\n */\nexport interface RateLimiterConfig {\n  /** Requests per time window */\n  requestsPerWindow: number;\n  /** Time window in milliseconds */\n  windowMs: number;\n  /** Burst allowance */\n  burstLimit?: number;\n}\n\n/**\n * Defines middleware for request/response processing pipelines.\n *\n * @remarks\n * Middleware can transform requests, responses, and handle errors\n * in a composable chain of responsibility pattern.\n *\n * @typeParam TRequest - Type of requests to process\n * @typeParam TResponse - Type of responses to process\n *\n * @category Reference\n */\nexport interface Middleware<TRequest = unknown, TResponse = unknown> {\n  /** Middleware name */\n  readonly name: string;\n\n  /** Process request */\n  request?(req: TRequest): Promise<TRequest>;\n\n  /** Process response */\n  response?(res: TResponse): Promise<TResponse>;\n\n  /** Handle errors */\n  error?(error: Error, req: TRequest): Promise<TResponse | void>;\n}\n\n/**\n * Generic plugin interface\n *\n * @category Reference\n */\nexport interface Plugin<TConfig = unknown> {\n  /** Plugin name */\n  readonly name: string;\n  /** Plugin version */\n  readonly version: string;\n  /** Plugin configuration */\n  readonly config: TConfig;\n\n  /** Initialize plugin */\n  init?(): Promise<void>;\n\n  /** Cleanup plugin */\n  cleanup?(): Promise<void>;\n}\n\n/**\n * Generic factory interface\n *\n * @category Reference\n */\nexport interface Factory<T, TParams = unknown> {\n  /** Create instance */\n  create(params: TParams): T;\n\n  /** Create multiple instances */\n  createMany?(params: TParams[]): T[];\n\n  /** Validate parameters */\n  validate?(params: TParams): boolean;\n}\n\n/**\n * Defines a repository pattern for data access abstraction.\n *\n * @remarks\n * Provides CRUD operations with filtering, sorting, and pagination\n * for consistent data access across different storage backends.\n *\n * @typeParam TEntity - Type of entities managed by the repository\n * @typeParam TKey - Type of entity identifiers\n *\n * @category Reference\n */\nexport interface Repository<TEntity, TKey = string | number> {\n  /** Find by ID */\n  findById(id: TKey): Promise<TEntity | undefined>;\n\n  /** Find all entities */\n  findAll(options?: {\n    limit?: number;\n    offset?: number;\n    filter?: Partial<TEntity>;\n    sort?: Array<{ field: keyof TEntity; direction: \"asc\" | \"desc\" }>;\n  }): Promise<{\n    entities: TEntity[];\n    total: number;\n    hasMore: boolean;\n  }>;\n\n  /** Create entity */\n  create(entity: Omit<TEntity, \"id\">): Promise<TEntity>;\n\n  /** Update entity */\n  update(id: TKey, updates: Partial<TEntity>): Promise<TEntity>;\n\n  /** Delete entity */\n  delete(id: TKey): Promise<boolean>;\n\n  /** Check if entity exists */\n  exists(id: TKey): Promise<boolean>;\n}\n\n/**\n * Generic validator interface\n *\n * @category Reference\n */\nexport interface Validator<T> {\n  /** Validate value */\n  validate(value: unknown): value is T;\n\n  /** Get validation errors */\n  getErrors?(value: unknown): string[];\n\n  /** Get validation schema */\n  getSchema?(): unknown;\n}\n\n/**\n * Generic transformer interface\n *\n * @category Reference\n */\nexport interface Transformer<TInput, TOutput> {\n  /** Transform input to output */\n  transform(input: TInput): TOutput | Promise<TOutput>;\n\n  /** Reverse transform output to input */\n  reverse?(output: TOutput): TInput | Promise<TInput>;\n}\n\n/**\n * Generic service interface\n *\n * @category Reference\n */\nexport interface Service<TConfig = unknown> {\n  /** Service name */\n  readonly name: string;\n  /** Service configuration */\n  readonly config: TConfig;\n  /** Service status */\n  readonly status:\n    | \"idle\"\n    | \"starting\"\n    | \"running\"\n    | \"stopping\"\n    | \"stopped\"\n    | \"error\";\n\n  /** Start service */\n  start(): Promise<void>;\n\n  /** Stop service */\n  stop(): Promise<void>;\n\n  /** Restart service */\n  restart?(): Promise<void>;\n\n  /** Get health status */\n  getHealth?(): Promise<{\n    healthy: boolean;\n    details?: Record<string, unknown>;\n  }>;\n}\n\n/**\n * Implements the observer in the observer pattern.\n *\n * @remarks\n * Receives notifications about events from observable subjects\n * for decoupled event handling.\n *\n * @typeParam TEvent - Type of events to observe\n *\n * @category Reference\n */\nexport interface Observer<TEvent = unknown> {\n  /** Handle event */\n  notify(event: TEvent): void | Promise<void>;\n}\n\n/**\n * Implements the subject in the observer pattern.\n *\n * @remarks\n * Manages observers and emits events to all subscribed observers\n * for event-driven architectures.\n *\n * @typeParam TEvent - Type of events to emit\n *\n * @category Reference\n */\nexport interface Observable<TEvent = unknown> {\n  /** Subscribe to events */\n  subscribe(observer: Observer<TEvent>): () => void;\n\n  /** Unsubscribe from events */\n  unsubscribe(observer: Observer<TEvent>): void;\n\n  /** Emit event */\n  emit(event: TEvent): void;\n}\n\n/**\n * Generic state machine interface\n *\n * @category Reference\n */\nexport interface StateMachine<TState, TEvent> {\n  /** Current state */\n  readonly currentState: TState;\n\n  /** Transition to new state */\n  transition(event: TEvent): TState;\n\n  /** Check if transition is valid */\n  canTransition(event: TEvent): boolean;\n\n  /** Get available transitions */\n  getAvailableTransitions(): TEvent[];\n}\n\n/**\n * Helper type to make properties optional conditionally\n *\n * @category Reference\n */\nexport type ConditionalOptional<\n  T,\n  K extends keyof T,\n  Condition extends boolean,\n> = Condition extends true ? Omit<T, K> & Partial<Pick<T, K>> : T;\n\n/**\n * Helper type to extract promise result type\n *\n * @category Reference\n */\nexport type PromiseResult<T> = T extends Promise<infer U> ? U : T;\n\n/**\n * Helper type to create a union of all possible keys\n *\n * @category Reference\n */\nexport type AllKeys<T> = T extends unknown ? keyof T : never;\n\n/**\n * Helper type to create a deep partial type\n *\n * @category Reference\n */\nexport type DeepPartial<T> = {\n  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];\n};\n\n/**\n * Helper type to create a deep readonly type\n *\n * @category Reference\n */\nexport type DeepReadonly<T> = {\n  readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];\n};\n\n/**\n * Helper type to create a required type with specific keys\n *\n * @category Reference\n */\nexport type RequireKeys<T, K extends keyof T> = Required<Pick<T, K>> &\n  Omit<T, K>;\n\n/**\n * Helper type to create an optional type with specific keys\n *\n * @category Reference\n */\nexport type OptionalKeys<T, K extends keyof T> = Partial<Pick<T, K>> &\n  Omit<T, K>;\n\n/**\n * Helper type to exclude null and undefined\n *\n * @category Reference\n */\nexport type NonNullable<T> = T extends null | undefined ? never : T;\n\n/**\n * Helper type to create a type with only specific keys\n *\n * @category Reference\n */\nexport type PickByType<T, U> = {\n  [K in keyof T as T[K] extends U ? K : never]: T[K];\n};\n\n/**\n * Helper type to omit keys by type\n *\n * @category Reference\n */\nexport type OmitByType<T, U> = {\n  [K in keyof T as T[K] extends U ? never : K]: T[K];\n};\n\n/**\n * Helper type for branded types\n *\n * @category Reference\n */\nexport type Brand<T, B> = T & { readonly __brand: B };\n\n/**\n * Helper type for nominal types\n *\n * @category Reference\n */\nexport type Nominal<T, N extends string> = T & { readonly __nominal: N };\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}