@sereel/sdk 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# Seree TypeScript SDK
+
+TypeScript SDK for the Seree SDK-facing REST asset endpoints.
+
+## Install
+
+```bash
+npm install @seree/sdk
+```
+
+## Quickstart
+
+```ts
+import { createClient } from "@seree/sdk";
+
+const client = createClient({
+  environment: "mainnet",
+  apiKey: process.env.SEREE_SDK_API_KEY!,
+});
+
+const assets = await client.getAssets();
+const asset = await client.getAssetByTokenAddress("0x123");
+```
+
+## Authentication
+
+The SDK sends your API key in the `x-api-key` header.
+
+Only MATATA-issued API keys are supported right now.
+
+```ts
+import { createClient } from "@seree/sdk";
+
+const client = createClient({
+  environment: "testnet",
+  apiKey: process.env.SEREE_SDK_API_KEY!,
+});
+
+const assets = await client.getAssets();
+```
+
+## Environments
+
+The SDK resolves the API base URL from the configured environment so callers do not need to pass a raw URL in normal usage.
+
+- `devnet` => `https://api-lazer.sereel.com`
+- `testnet` => `https://api-lazer-v2.sereel.com`
+- `mainnet` => `https://cahokia.sereel.com`
+
+## Client API
+
+### `createClient`
+
+```ts
+import { createClient } from "@seree/sdk";
+
+const client = createClient({
+  environment: "testnet",
+  apiKey: process.env.SEREE_SDK_API_KEY!,
+  timeoutMs: 10_000,
+});
+```
+
+Advanced option:
+
+`baseUrl` can be provided as an explicit override for local integration testing or temporary pre-release environments, but `environment` remains the primary and recommended path.
+
+```ts
+const client = createClient({
+  environment: "devnet",
+  apiKey: process.env.SEREE_SDK_API_KEY!,
+  baseUrl: "http://localhost:8080",
+});
+```
+
+### `client.getAssets()`
+
+Fetches `GET /sdk/assets`.
+
+```ts
+const assets = await client.getAssets();
+
+console.log(assets.count);
+console.log(assets.data[0]?.security.token_symbol);
+```
+
+### `client.getAssetByTokenAddress(tokenAddress)`
+
+Fetches `GET /sdk/assets/{token_address}`.
+
+```ts
+const asset = await client.getAssetByTokenAddress("0x123");
+
+console.log(asset.data.security.token_name);
+console.log(asset.data.books.length);
+```
+
+## Response shape
+
+The SDK models the backend SDK DTOs and returns joined asset records with:
+
+- `security`
+- `seller_organization`
+- `books`
+
+Token price fields are intentionally not included in the SDK types.
+
+## Errors
+
+The SDK throws typed errors for common failure cases:
+
+- `InvalidConfigurationError`
+- `UnauthorizedError`
+- `NotFoundError`
+- `ServerError`
+- `TimeoutError`
+- `MalformedResponseError`
+
+## Runtime support
+
+The SDK is framework-agnostic and uses the platform `fetch` API. In runtimes without a global `fetch`, pass a compatible implementation through `createClient({ fetch })`.

package/dist/index.cjs

@@ -0,0 +1,282 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ENVIRONMENT_BASE_URLS: () => ENVIRONMENT_BASE_URLS,
+  HttpError: () => HttpError,
+  InvalidConfigurationError: () => InvalidConfigurationError,
+  MalformedResponseError: () => MalformedResponseError,
+  NotFoundError: () => NotFoundError,
+  SereeSdkError: () => SereeSdkError,
+  ServerError: () => ServerError,
+  TimeoutError: () => TimeoutError,
+  UnauthorizedError: () => UnauthorizedError,
+  createClient: () => createClient,
+  resolveBaseUrl: () => resolveBaseUrl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var SereeSdkError = class extends Error {
+  status;
+  code;
+  details;
+  constructor(message, options = {}) {
+    super(message, options.cause ? { cause: options.cause } : void 0);
+    this.name = new.target.name;
+    this.status = options.status;
+    this.code = options.code;
+    this.details = options.details;
+  }
+};
+var InvalidConfigurationError = class extends SereeSdkError {
+};
+var HttpError = class extends SereeSdkError {
+};
+var UnauthorizedError = class extends HttpError {
+};
+var NotFoundError = class extends HttpError {
+};
+var ServerError = class extends HttpError {
+};
+var TimeoutError = class extends SereeSdkError {
+};
+var MalformedResponseError = class extends SereeSdkError {
+};
+
+// src/config.ts
+var ENVIRONMENT_BASE_URLS = {
+  devnet: "https://api-lazer.sereel.com",
+  testnet: "https://api-lazer-v2.sereel.com",
+  mainnet: "https://cahokia.sereel.com"
+};
+var DEFAULT_TIMEOUT_MS = 1e4;
+function getFetchImplementation(providedFetch) {
+  if (providedFetch) {
+    return providedFetch;
+  }
+  if (typeof globalThis.fetch === "function") {
+    return globalThis.fetch.bind(globalThis);
+  }
+  throw new InvalidConfigurationError(
+    "No fetch implementation is available. Provide config.fetch in this runtime."
+  );
+}
+function normalizeBaseUrl(baseUrl) {
+  const trimmed = baseUrl.trim();
+  if (!trimmed) {
+    throw new InvalidConfigurationError("baseUrl must not be empty when provided.");
+  }
+  try {
+    return new URL(trimmed).toString().replace(/\/+$/, "");
+  } catch (cause) {
+    throw new InvalidConfigurationError("baseUrl must be a valid absolute URL.", {
+      cause
+    });
+  }
+}
+function resolveBaseUrl(environment, baseUrl) {
+  if (baseUrl) {
+    return normalizeBaseUrl(baseUrl);
+  }
+  return ENVIRONMENT_BASE_URLS[environment];
+}
+function resolveClientConfig(config) {
+  const apiKey = config.apiKey.trim();
+  if (!apiKey) {
+    throw new InvalidConfigurationError("apiKey must not be empty.");
+  }
+  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new InvalidConfigurationError("timeoutMs must be a positive number.");
+  }
+  return {
+    environment: config.environment,
+    apiKey,
+    timeoutMs,
+    baseUrl: resolveBaseUrl(config.environment, config.baseUrl),
+    fetch: getFetchImplementation(config.fetch)
+  };
+}
+
+// src/transport.ts
+function createTimeoutSignal(timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  return {
+    signal: controller.signal,
+    cleanup: () => clearTimeout(timeout)
+  };
+}
+async function parseBody(response) {
+  const text = await response.text();
+  if (!text) {
+    return null;
+  }
+  try {
+    return JSON.parse(text);
+  } catch (cause) {
+    throw new MalformedResponseError("Received a non-JSON response body.", {
+      cause,
+      status: response.status,
+      details: text
+    });
+  }
+}
+function getErrorMessage(status, body) {
+  if (body && typeof body === "object") {
+    const apiError = body;
+    if (typeof apiError.error === "string" && apiError.error.trim()) {
+      return apiError.error;
+    }
+    if (typeof apiError.message === "string" && apiError.message.trim()) {
+      return apiError.message;
+    }
+  }
+  return `Request failed with status ${status}.`;
+}
+function toHttpError(status, body) {
+  const message = getErrorMessage(status, body);
+  const options = { status, details: body };
+  if (status === 401) {
+    return new UnauthorizedError(message, options);
+  }
+  if (status === 404) {
+    return new NotFoundError(message, options);
+  }
+  if (status >= 500) {
+    return new ServerError(message, options);
+  }
+  return new HttpError(message, options);
+}
+async function requestJson(config, path, validate) {
+  const { signal, cleanup } = createTimeoutSignal(config.timeoutMs);
+  try {
+    const response = await config.fetch(`${config.baseUrl}${path}`, {
+      method: "GET",
+      signal,
+      headers: {
+        accept: "application/json",
+        "x-api-key": config.apiKey
+      }
+    });
+    const body = await parseBody(response);
+    if (!response.ok) {
+      throw toHttpError(response.status, body);
+    }
+    return validate(body);
+  } catch (error) {
+    if (error instanceof HttpError || error instanceof MalformedResponseError) {
+      throw error;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new TimeoutError(
+        `Request timed out after ${config.timeoutMs}ms.`,
+        { cause: error }
+      );
+    }
+    throw error;
+  } finally {
+    cleanup();
+  }
+}
+
+// src/validation.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNullableString(value) {
+  return typeof value === "string" || value === null;
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function isSecuritySummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.token_address) && isString(value.token_name) && isString(value.token_symbol) && isString(value.network_id) && isString(value.token_type);
+}
+function isSellerOrganizationSummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.legal_name) && isNullableString(value.display_name) && isString(value.jurisdiction) && isNullableString(value.website);
+}
+function isBookSummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.order_book_address) && isString(value.status) && isString(value.network_id) && isFiniteNumber(value.subscription_start) && isFiniteNumber(value.subscription_end) && isString(value.prospectus_file_url);
+}
+function isAssetRecord(value) {
+  return isRecord(value) && isSecuritySummary(value.security) && isSellerOrganizationSummary(value.seller_organization) && Array.isArray(value.books) && value.books.every(isBookSummary);
+}
+function validateSdkAssetsResponse(value) {
+  if (!isRecord(value) || !Array.isArray(value.data) || !isFiniteNumber(value.count) || !value.data.every(isAssetRecord)) {
+    throw new MalformedResponseError(
+      "Received an invalid SDK assets response shape.",
+      { details: value }
+    );
+  }
+  return value;
+}
+function validateSdkAssetResponse(value) {
+  if (!isRecord(value) || !isAssetRecord(value.data)) {
+    throw new MalformedResponseError(
+      "Received an invalid SDK asset response shape.",
+      { details: value }
+    );
+  }
+  return value;
+}
+
+// src/client.ts
+function createClient(config) {
+  const resolved = resolveClientConfig(config);
+  return {
+    getAssets() {
+      return requestJson(resolved, "/sdk/assets", validateSdkAssetsResponse);
+    },
+    getAssetByTokenAddress(tokenAddress) {
+      const trimmedTokenAddress = tokenAddress.trim();
+      if (!trimmedTokenAddress) {
+        throw new InvalidConfigurationError(
+          "tokenAddress must not be empty."
+        );
+      }
+      return requestJson(
+        resolved,
+        `/sdk/assets/${encodeURIComponent(trimmedTokenAddress)}`,
+        validateSdkAssetResponse
+      );
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ENVIRONMENT_BASE_URLS,
+  HttpError,
+  InvalidConfigurationError,
+  MalformedResponseError,
+  NotFoundError,
+  SereeSdkError,
+  ServerError,
+  TimeoutError,
+  UnauthorizedError,
+  createClient,
+  resolveBaseUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/config.ts","../src/transport.ts","../src/validation.ts","../src/client.ts"],"sourcesContent":["export { createClient } from \"./client\";\nexport { ENVIRONMENT_BASE_URLS, resolveBaseUrl } from \"./config\";\nexport {\n  HttpError,\n  InvalidConfigurationError,\n  MalformedResponseError,\n  NotFoundError,\n  ServerError,\n  SereeSdkError,\n  TimeoutError,\n  UnauthorizedError,\n} from \"./errors\";\nexport type {\n  ClientConfig,\n  SdkAssetRecord,\n  SdkAssetResponse,\n  SdkAssetsResponse,\n  SdkBookSummary,\n  SdkSecuritySummary,\n  SdkSellerOrganizationSummary,\n  SereeEnvironment,\n  SereeSdkClient,\n} from \"./types\";\n","export interface SereeSdkErrorOptions {\n  status?: number;\n  code?: string;\n  cause?: unknown;\n  details?: unknown;\n}\n\nexport class SereeSdkError extends Error {\n  readonly status: number | undefined;\n  readonly code: string | undefined;\n  readonly details?: unknown;\n\n  constructor(message: string, options: SereeSdkErrorOptions = {}) {\n    super(message, options.cause ? { cause: options.cause } : undefined);\n    this.name = new.target.name;\n    this.status = options.status;\n    this.code = options.code;\n    this.details = options.details;\n  }\n}\n\nexport class InvalidConfigurationError extends SereeSdkError {}\n\nexport class HttpError extends SereeSdkError {}\n\nexport class UnauthorizedError extends HttpError {}\n\nexport class NotFoundError extends HttpError {}\n\nexport class ServerError extends HttpError {}\n\nexport class TimeoutError extends SereeSdkError {}\n\nexport class MalformedResponseError extends SereeSdkError {}\n","import { InvalidConfigurationError } from \"./errors\";\nimport type { ClientConfig, SereeEnvironment } from \"./types\";\n\nexport const ENVIRONMENT_BASE_URLS: Record<SereeEnvironment, string> = {\n  devnet: \"https://api-lazer.sereel.com\",\n  testnet: \"https://api-lazer-v2.sereel.com\",\n  mainnet: \"https://cahokia.sereel.com\",\n};\n\nexport interface ResolvedClientConfig {\n  environment: SereeEnvironment;\n  apiKey: string;\n  timeoutMs: number;\n  baseUrl: string;\n  fetch: typeof fetch;\n}\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\nfunction getFetchImplementation(\n  providedFetch: ClientConfig[\"fetch\"],\n): typeof fetch {\n  if (providedFetch) {\n    return providedFetch;\n  }\n\n  if (typeof globalThis.fetch === \"function\") {\n    return globalThis.fetch.bind(globalThis);\n  }\n\n  throw new InvalidConfigurationError(\n    \"No fetch implementation is available. Provide config.fetch in this runtime.\",\n  );\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  const trimmed = baseUrl.trim();\n\n  if (!trimmed) {\n    throw new InvalidConfigurationError(\"baseUrl must not be empty when provided.\");\n  }\n\n  try {\n    return new URL(trimmed).toString().replace(/\\/+$/, \"\");\n  } catch (cause) {\n    throw new InvalidConfigurationError(\"baseUrl must be a valid absolute URL.\", {\n      cause,\n    });\n  }\n}\n\nexport function resolveBaseUrl(\n  environment: SereeEnvironment,\n  baseUrl?: string,\n): string {\n  if (baseUrl) {\n    return normalizeBaseUrl(baseUrl);\n  }\n\n  return ENVIRONMENT_BASE_URLS[environment];\n}\n\nexport function resolveClientConfig(config: ClientConfig): ResolvedClientConfig {\n  const apiKey = config.apiKey.trim();\n\n  if (!apiKey) {\n    throw new InvalidConfigurationError(\"apiKey must not be empty.\");\n  }\n\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new InvalidConfigurationError(\"timeoutMs must be a positive number.\");\n  }\n\n  return {\n    environment: config.environment,\n    apiKey,\n    timeoutMs,\n    baseUrl: resolveBaseUrl(config.environment, config.baseUrl),\n    fetch: getFetchImplementation(config.fetch),\n  };\n}\n","import {\n  HttpError,\n  MalformedResponseError,\n  NotFoundError,\n  ServerError,\n  TimeoutError,\n  UnauthorizedError,\n} from \"./errors\";\nimport type { ResolvedClientConfig } from \"./config\";\n\ninterface ApiErrorBody {\n  error?: string;\n  message?: string;\n}\n\nfunction createTimeoutSignal(timeoutMs: number): {\n  signal: AbortSignal;\n  cleanup: () => void;\n} {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  return {\n    signal: controller.signal,\n    cleanup: () => clearTimeout(timeout),\n  };\n}\n\nasync function parseBody(response: Response): Promise<unknown> {\n  const text = await response.text();\n  if (!text) {\n    return null;\n  }\n\n  try {\n    return JSON.parse(text) as unknown;\n  } catch (cause) {\n    throw new MalformedResponseError(\"Received a non-JSON response body.\", {\n      cause,\n      status: response.status,\n      details: text,\n    });\n  }\n}\n\nfunction getErrorMessage(status: number, body: unknown): string {\n  if (body && typeof body === \"object\") {\n    const apiError = body as ApiErrorBody;\n    if (typeof apiError.error === \"string\" && apiError.error.trim()) {\n      return apiError.error;\n    }\n    if (typeof apiError.message === \"string\" && apiError.message.trim()) {\n      return apiError.message;\n    }\n  }\n\n  return `Request failed with status ${status}.`;\n}\n\nfunction toHttpError(status: number, body: unknown): HttpError {\n  const message = getErrorMessage(status, body);\n  const options = { status, details: body };\n\n  if (status === 401) {\n    return new UnauthorizedError(message, options);\n  }\n  if (status === 404) {\n    return new NotFoundError(message, options);\n  }\n  if (status >= 500) {\n    return new ServerError(message, options);\n  }\n\n  return new HttpError(message, options);\n}\n\nexport async function requestJson<T>(\n  config: ResolvedClientConfig,\n  path: string,\n  validate: (value: unknown) => T,\n): Promise<T> {\n  const { signal, cleanup } = createTimeoutSignal(config.timeoutMs);\n\n  try {\n    const response = await config.fetch(`${config.baseUrl}${path}`, {\n      method: \"GET\",\n      signal,\n      headers: {\n        accept: \"application/json\",\n        \"x-api-key\": config.apiKey,\n      },\n    });\n\n    const body = await parseBody(response);\n    if (!response.ok) {\n      throw toHttpError(response.status, body);\n    }\n\n    return validate(body);\n  } catch (error) {\n    if (error instanceof HttpError || error instanceof MalformedResponseError) {\n      throw error;\n    }\n\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw new TimeoutError(\n        `Request timed out after ${config.timeoutMs}ms.`,\n        { cause: error },\n      );\n    }\n\n    throw error;\n  } finally {\n    cleanup();\n  }\n}\n","import { MalformedResponseError } from \"./errors\";\nimport type {\n  SdkAssetRecord,\n  SdkAssetResponse,\n  SdkAssetsResponse,\n  SdkBookSummary,\n  SdkSecuritySummary,\n  SdkSellerOrganizationSummary,\n} from \"./types\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\nfunction isNullableString(value: unknown): value is string | null {\n  return typeof value === \"string\" || value === null;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isSecuritySummary(value: unknown): value is SdkSecuritySummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.token_address) &&\n    isString(value.token_name) &&\n    isString(value.token_symbol) &&\n    isString(value.network_id) &&\n    isString(value.token_type)\n  );\n}\n\nfunction isSellerOrganizationSummary(\n  value: unknown,\n): value is SdkSellerOrganizationSummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.legal_name) &&\n    isNullableString(value.display_name) &&\n    isString(value.jurisdiction) &&\n    isNullableString(value.website)\n  );\n}\n\nfunction isBookSummary(value: unknown): value is SdkBookSummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.order_book_address) &&\n    isString(value.status) &&\n    isString(value.network_id) &&\n    isFiniteNumber(value.subscription_start) &&\n    isFiniteNumber(value.subscription_end) &&\n    isString(value.prospectus_file_url)\n  );\n}\n\nfunction isAssetRecord(value: unknown): value is SdkAssetRecord {\n  return (\n    isRecord(value) &&\n    isSecuritySummary(value.security) &&\n    isSellerOrganizationSummary(value.seller_organization) &&\n    Array.isArray(value.books) &&\n    value.books.every(isBookSummary)\n  );\n}\n\nexport function validateSdkAssetsResponse(value: unknown): SdkAssetsResponse {\n  if (\n    !isRecord(value) ||\n    !Array.isArray(value.data) ||\n    !isFiniteNumber(value.count) ||\n    !value.data.every(isAssetRecord)\n  ) {\n    throw new MalformedResponseError(\n      \"Received an invalid SDK assets response shape.\",\n      { details: value },\n    );\n  }\n\n  return value as unknown as SdkAssetsResponse;\n}\n\nexport function validateSdkAssetResponse(value: unknown): SdkAssetResponse {\n  if (!isRecord(value) || !isAssetRecord(value.data)) {\n    throw new MalformedResponseError(\n      \"Received an invalid SDK asset response shape.\",\n      { details: value },\n    );\n  }\n\n  return value as unknown as SdkAssetResponse;\n}\n","import { resolveClientConfig } from \"./config\";\nimport { InvalidConfigurationError } from \"./errors\";\nimport { requestJson } from \"./transport\";\nimport type {\n  ClientConfig,\n  SdkAssetResponse,\n  SdkAssetsResponse,\n  SereeSdkClient,\n} from \"./types\";\nimport {\n  validateSdkAssetResponse,\n  validateSdkAssetsResponse,\n} from \"./validation\";\n\nexport function createClient(config: ClientConfig): SereeSdkClient {\n  const resolved = resolveClientConfig(config);\n\n  return {\n    getAssets(): Promise<SdkAssetsResponse> {\n      return requestJson(resolved, \"/sdk/assets\", validateSdkAssetsResponse);\n    },\n\n    getAssetByTokenAddress(tokenAddress: string): Promise<SdkAssetResponse> {\n      const trimmedTokenAddress = tokenAddress.trim();\n      if (!trimmedTokenAddress) {\n        throw new InvalidConfigurationError(\n          \"tokenAddress must not be empty.\",\n        );\n      }\n\n      return requestJson(\n        resolved,\n        `/sdk/assets/${encodeURIComponent(trimmedTokenAddress)}`,\n        validateSdkAssetResponse,\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,SAAiB,UAAgC,CAAC,GAAG;AAC/D,UAAM,SAAS,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,MAAS;AACnE,SAAK,OAAO,WAAW;AACvB,SAAK,SAAS,QAAQ;AACtB,SAAK,OAAO,QAAQ;AACpB,SAAK,UAAU,QAAQ;AAAA,EACzB;AACF;AAEO,IAAM,4BAAN,cAAwC,cAAc;AAAC;AAEvD,IAAM,YAAN,cAAwB,cAAc;AAAC;AAEvC,IAAM,oBAAN,cAAgC,UAAU;AAAC;AAE3C,IAAM,gBAAN,cAA4B,UAAU;AAAC;AAEvC,IAAM,cAAN,cAA0B,UAAU;AAAC;AAErC,IAAM,eAAN,cAA2B,cAAc;AAAC;AAE1C,IAAM,yBAAN,cAAqC,cAAc;AAAC;;;AC9BpD,IAAM,wBAA0D;AAAA,EACrE,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AACX;AAUA,IAAM,qBAAqB;AAE3B,SAAS,uBACP,eACc;AACd,MAAI,eAAe;AACjB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU,YAAY;AAC1C,WAAO,WAAW,MAAM,KAAK,UAAU;AAAA,EACzC;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,SAAyB;AACjD,QAAM,UAAU,QAAQ,KAAK;AAE7B,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,0BAA0B,0CAA0C;AAAA,EAChF;AAEA,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,EAAE,SAAS,EAAE,QAAQ,QAAQ,EAAE;AAAA,EACvD,SAAS,OAAO;AACd,UAAM,IAAI,0BAA0B,yCAAyC;AAAA,MAC3E;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEO,SAAS,eACd,aACA,SACQ;AACR,MAAI,SAAS;AACX,WAAO,iBAAiB,OAAO;AAAA,EACjC;AAEA,SAAO,sBAAsB,WAAW;AAC1C;AAEO,SAAS,oBAAoB,QAA4C;AAC9E,QAAM,SAAS,OAAO,OAAO,KAAK;AAElC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,2BAA2B;AAAA,EACjE;AAEA,QAAM,YAAY,OAAO,aAAa;AACtC,MAAI,CAAC,OAAO,SAAS,SAAS,KAAK,aAAa,GAAG;AACjD,UAAM,IAAI,0BAA0B,sCAAsC;AAAA,EAC5E;AAEA,SAAO;AAAA,IACL,aAAa,OAAO;AAAA,IACpB;AAAA,IACA;AAAA,IACA,SAAS,eAAe,OAAO,aAAa,OAAO,OAAO;AAAA,IAC1D,OAAO,uBAAuB,OAAO,KAAK;AAAA,EAC5C;AACF;;;AClEA,SAAS,oBAAoB,WAG3B;AACA,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAE9D,SAAO;AAAA,IACL,QAAQ,WAAW;AAAA,IACnB,SAAS,MAAM,aAAa,OAAO;AAAA,EACrC;AACF;AAEA,eAAe,UAAU,UAAsC;AAC7D,QAAM,OAAO,MAAM,SAAS,KAAK;AACjC,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,SAAS,OAAO;AACd,UAAM,IAAI,uBAAuB,sCAAsC;AAAA,MACrE;AAAA,MACA,QAAQ,SAAS;AAAA,MACjB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAEA,SAAS,gBAAgB,QAAgB,MAAuB;AAC9D,MAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,UAAM,WAAW;AACjB,QAAI,OAAO,SAAS,UAAU,YAAY,SAAS,MAAM,KAAK,GAAG;AAC/D,aAAO,SAAS;AAAA,IAClB;AACA,QAAI,OAAO,SAAS,YAAY,YAAY,SAAS,QAAQ,KAAK,GAAG;AACnE,aAAO,SAAS;AAAA,IAClB;AAAA,EACF;AAEA,SAAO,8BAA8B,MAAM;AAC7C;AAEA,SAAS,YAAY,QAAgB,MAA0B;AAC7D,QAAM,UAAU,gBAAgB,QAAQ,IAAI;AAC5C,QAAM,UAAU,EAAE,QAAQ,SAAS,KAAK;AAExC,MAAI,WAAW,KAAK;AAClB,WAAO,IAAI,kBAAkB,SAAS,OAAO;AAAA,EAC/C;AACA,MAAI,WAAW,KAAK;AAClB,WAAO,IAAI,cAAc,SAAS,OAAO;AAAA,EAC3C;AACA,MAAI,UAAU,KAAK;AACjB,WAAO,IAAI,YAAY,SAAS,OAAO;AAAA,EACzC;AAEA,SAAO,IAAI,UAAU,SAAS,OAAO;AACvC;AAEA,eAAsB,YACpB,QACA,MACA,UACY;AACZ,QAAM,EAAE,QAAQ,QAAQ,IAAI,oBAAoB,OAAO,SAAS;AAEhE,MAAI;AACF,UAAM,WAAW,MAAM,OAAO,MAAM,GAAG,OAAO,OAAO,GAAG,IAAI,IAAI;AAAA,MAC9D,QAAQ;AAAA,MACR;AAAA,MACA,SAAS;AAAA,QACP,QAAQ;AAAA,QACR,aAAa,OAAO;AAAA,MACtB;AAAA,IACF,CAAC;AAED,UAAM,OAAO,MAAM,UAAU,QAAQ;AACrC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,YAAY,SAAS,QAAQ,IAAI;AAAA,IACzC;AAEA,WAAO,SAAS,IAAI;AAAA,EACtB,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa,iBAAiB,wBAAwB;AACzE,YAAM;AAAA,IACR;AAEA,QAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,YAAM,IAAI;AAAA,QACR,2BAA2B,OAAO,SAAS;AAAA,QAC3C,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAEA,UAAM;AAAA,EACR,UAAE;AACA,YAAQ;AAAA,EACV;AACF;;;ACzGA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,SAAS,OAAiC;AACjD,SAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,iBAAiB,OAAwC;AAChE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,eAAe,OAAiC;AACvD,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAC3D;AAEA,SAAS,kBAAkB,OAA6C;AACtE,SACE,SAAS,KAAK,KACd,SAAS,MAAM,EAAE,KACjB,SAAS,MAAM,aAAa,KAC5B,SAAS,MAAM,UAAU,KACzB,SAAS,MAAM,YAAY,KAC3B,SAAS,MAAM,UAAU,KACzB,SAAS,MAAM,UAAU;AAE7B;AAEA,SAAS,4BACP,OACuC;AACvC,SACE,SAAS,KAAK,KACd,SAAS,MAAM,EAAE,KACjB,SAAS,MAAM,UAAU,KACzB,iBAAiB,MAAM,YAAY,KACnC,SAAS,MAAM,YAAY,KAC3B,iBAAiB,MAAM,OAAO;AAElC;AAEA,SAAS,cAAc,OAAyC;AAC9D,SACE,SAAS,KAAK,KACd,SAAS,MAAM,EAAE,KACjB,SAAS,MAAM,kBAAkB,KACjC,SAAS,MAAM,MAAM,KACrB,SAAS,MAAM,UAAU,KACzB,eAAe,MAAM,kBAAkB,KACvC,eAAe,MAAM,gBAAgB,KACrC,SAAS,MAAM,mBAAmB;AAEtC;AAEA,SAAS,cAAc,OAAyC;AAC9D,SACE,SAAS,KAAK,KACd,kBAAkB,MAAM,QAAQ,KAChC,4BAA4B,MAAM,mBAAmB,KACrD,MAAM,QAAQ,MAAM,KAAK,KACzB,MAAM,MAAM,MAAM,aAAa;AAEnC;AAEO,SAAS,0BAA0B,OAAmC;AAC3E,MACE,CAAC,SAAS,KAAK,KACf,CAAC,MAAM,QAAQ,MAAM,IAAI,KACzB,CAAC,eAAe,MAAM,KAAK,KAC3B,CAAC,MAAM,KAAK,MAAM,aAAa,GAC/B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,MACA,EAAE,SAAS,MAAM;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,yBAAyB,OAAkC;AACzE,MAAI,CAAC,SAAS,KAAK,KAAK,CAAC,cAAc,MAAM,IAAI,GAAG;AAClD,UAAM,IAAI;AAAA,MACR;AAAA,MACA,EAAE,SAAS,MAAM;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;;;ACrFO,SAAS,aAAa,QAAsC;AACjE,QAAM,WAAW,oBAAoB,MAAM;AAE3C,SAAO;AAAA,IACL,YAAwC;AACtC,aAAO,YAAY,UAAU,eAAe,yBAAyB;AAAA,IACvE;AAAA,IAEA,uBAAuB,cAAiD;AACtE,YAAM,sBAAsB,aAAa,KAAK;AAC9C,UAAI,CAAC,qBAAqB;AACxB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL;AAAA,QACA,eAAe,mBAAmB,mBAAmB,CAAC;AAAA,QACtD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+type SereeEnvironment = "devnet" | "testnet" | "mainnet";
+interface ClientConfig {
+    environment: SereeEnvironment;
+    apiKey: string;
+    timeoutMs?: number;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+interface SdkSecuritySummary {
+    id: string;
+    token_address: string;
+    token_name: string;
+    token_symbol: string;
+    network_id: string;
+    token_type: string;
+}
+interface SdkSellerOrganizationSummary {
+    id: string;
+    legal_name: string;
+    display_name: string | null;
+    jurisdiction: string;
+    website: string | null;
+}
+interface SdkBookSummary {
+    id: string;
+    order_book_address: string;
+    status: string;
+    network_id: string;
+    subscription_start: number;
+    subscription_end: number;
+    prospectus_file_url: string;
+}
+interface SdkAssetRecord {
+    security: SdkSecuritySummary;
+    seller_organization: SdkSellerOrganizationSummary;
+    books: SdkBookSummary[];
+}
+interface SdkAssetsResponse {
+    data: SdkAssetRecord[];
+    count: number;
+}
+interface SdkAssetResponse {
+    data: SdkAssetRecord;
+}
+interface SereeSdkClient {
+    getAssets(): Promise<SdkAssetsResponse>;
+    getAssetByTokenAddress(tokenAddress: string): Promise<SdkAssetResponse>;
+}
+
+declare function createClient(config: ClientConfig): SereeSdkClient;
+
+declare const ENVIRONMENT_BASE_URLS: Record<SereeEnvironment, string>;
+declare function resolveBaseUrl(environment: SereeEnvironment, baseUrl?: string): string;
+
+interface SereeSdkErrorOptions {
+    status?: number;
+    code?: string;
+    cause?: unknown;
+    details?: unknown;
+}
+declare class SereeSdkError extends Error {
+    readonly status: number | undefined;
+    readonly code: string | undefined;
+    readonly details?: unknown;
+    constructor(message: string, options?: SereeSdkErrorOptions);
+}
+declare class InvalidConfigurationError extends SereeSdkError {
+}
+declare class HttpError extends SereeSdkError {
+}
+declare class UnauthorizedError extends HttpError {
+}
+declare class NotFoundError extends HttpError {
+}
+declare class ServerError extends HttpError {
+}
+declare class TimeoutError extends SereeSdkError {
+}
+declare class MalformedResponseError extends SereeSdkError {
+}
+
+export { type ClientConfig, ENVIRONMENT_BASE_URLS, HttpError, InvalidConfigurationError, MalformedResponseError, NotFoundError, type SdkAssetRecord, type SdkAssetResponse, type SdkAssetsResponse, type SdkBookSummary, type SdkSecuritySummary, type SdkSellerOrganizationSummary, type SereeEnvironment, type SereeSdkClient, SereeSdkError, ServerError, TimeoutError, UnauthorizedError, createClient, resolveBaseUrl };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+type SereeEnvironment = "devnet" | "testnet" | "mainnet";
+interface ClientConfig {
+    environment: SereeEnvironment;
+    apiKey: string;
+    timeoutMs?: number;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+interface SdkSecuritySummary {
+    id: string;
+    token_address: string;
+    token_name: string;
+    token_symbol: string;
+    network_id: string;
+    token_type: string;
+}
+interface SdkSellerOrganizationSummary {
+    id: string;
+    legal_name: string;
+    display_name: string | null;
+    jurisdiction: string;
+    website: string | null;
+}
+interface SdkBookSummary {
+    id: string;
+    order_book_address: string;
+    status: string;
+    network_id: string;
+    subscription_start: number;
+    subscription_end: number;
+    prospectus_file_url: string;
+}
+interface SdkAssetRecord {
+    security: SdkSecuritySummary;
+    seller_organization: SdkSellerOrganizationSummary;
+    books: SdkBookSummary[];
+}
+interface SdkAssetsResponse {
+    data: SdkAssetRecord[];
+    count: number;
+}
+interface SdkAssetResponse {
+    data: SdkAssetRecord;
+}
+interface SereeSdkClient {
+    getAssets(): Promise<SdkAssetsResponse>;
+    getAssetByTokenAddress(tokenAddress: string): Promise<SdkAssetResponse>;
+}
+
+declare function createClient(config: ClientConfig): SereeSdkClient;
+
+declare const ENVIRONMENT_BASE_URLS: Record<SereeEnvironment, string>;
+declare function resolveBaseUrl(environment: SereeEnvironment, baseUrl?: string): string;
+
+interface SereeSdkErrorOptions {
+    status?: number;
+    code?: string;
+    cause?: unknown;
+    details?: unknown;
+}
+declare class SereeSdkError extends Error {
+    readonly status: number | undefined;
+    readonly code: string | undefined;
+    readonly details?: unknown;
+    constructor(message: string, options?: SereeSdkErrorOptions);
+}
+declare class InvalidConfigurationError extends SereeSdkError {
+}
+declare class HttpError extends SereeSdkError {
+}
+declare class UnauthorizedError extends HttpError {
+}
+declare class NotFoundError extends HttpError {
+}
+declare class ServerError extends HttpError {
+}
+declare class TimeoutError extends SereeSdkError {
+}
+declare class MalformedResponseError extends SereeSdkError {
+}
+
+export { type ClientConfig, ENVIRONMENT_BASE_URLS, HttpError, InvalidConfigurationError, MalformedResponseError, NotFoundError, type SdkAssetRecord, type SdkAssetResponse, type SdkAssetsResponse, type SdkBookSummary, type SdkSecuritySummary, type SdkSellerOrganizationSummary, type SereeEnvironment, type SereeSdkClient, SereeSdkError, ServerError, TimeoutError, UnauthorizedError, createClient, resolveBaseUrl };

package/dist/index.js

@@ -0,0 +1,245 @@
+// src/errors.ts
+var SereeSdkError = class extends Error {
+  status;
+  code;
+  details;
+  constructor(message, options = {}) {
+    super(message, options.cause ? { cause: options.cause } : void 0);
+    this.name = new.target.name;
+    this.status = options.status;
+    this.code = options.code;
+    this.details = options.details;
+  }
+};
+var InvalidConfigurationError = class extends SereeSdkError {
+};
+var HttpError = class extends SereeSdkError {
+};
+var UnauthorizedError = class extends HttpError {
+};
+var NotFoundError = class extends HttpError {
+};
+var ServerError = class extends HttpError {
+};
+var TimeoutError = class extends SereeSdkError {
+};
+var MalformedResponseError = class extends SereeSdkError {
+};
+
+// src/config.ts
+var ENVIRONMENT_BASE_URLS = {
+  devnet: "https://api-lazer.sereel.com",
+  testnet: "https://api-lazer-v2.sereel.com",
+  mainnet: "https://cahokia.sereel.com"
+};
+var DEFAULT_TIMEOUT_MS = 1e4;
+function getFetchImplementation(providedFetch) {
+  if (providedFetch) {
+    return providedFetch;
+  }
+  if (typeof globalThis.fetch === "function") {
+    return globalThis.fetch.bind(globalThis);
+  }
+  throw new InvalidConfigurationError(
+    "No fetch implementation is available. Provide config.fetch in this runtime."
+  );
+}
+function normalizeBaseUrl(baseUrl) {
+  const trimmed = baseUrl.trim();
+  if (!trimmed) {
+    throw new InvalidConfigurationError("baseUrl must not be empty when provided.");
+  }
+  try {
+    return new URL(trimmed).toString().replace(/\/+$/, "");
+  } catch (cause) {
+    throw new InvalidConfigurationError("baseUrl must be a valid absolute URL.", {
+      cause
+    });
+  }
+}
+function resolveBaseUrl(environment, baseUrl) {
+  if (baseUrl) {
+    return normalizeBaseUrl(baseUrl);
+  }
+  return ENVIRONMENT_BASE_URLS[environment];
+}
+function resolveClientConfig(config) {
+  const apiKey = config.apiKey.trim();
+  if (!apiKey) {
+    throw new InvalidConfigurationError("apiKey must not be empty.");
+  }
+  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new InvalidConfigurationError("timeoutMs must be a positive number.");
+  }
+  return {
+    environment: config.environment,
+    apiKey,
+    timeoutMs,
+    baseUrl: resolveBaseUrl(config.environment, config.baseUrl),
+    fetch: getFetchImplementation(config.fetch)
+  };
+}
+
+// src/transport.ts
+function createTimeoutSignal(timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  return {
+    signal: controller.signal,
+    cleanup: () => clearTimeout(timeout)
+  };
+}
+async function parseBody(response) {
+  const text = await response.text();
+  if (!text) {
+    return null;
+  }
+  try {
+    return JSON.parse(text);
+  } catch (cause) {
+    throw new MalformedResponseError("Received a non-JSON response body.", {
+      cause,
+      status: response.status,
+      details: text
+    });
+  }
+}
+function getErrorMessage(status, body) {
+  if (body && typeof body === "object") {
+    const apiError = body;
+    if (typeof apiError.error === "string" && apiError.error.trim()) {
+      return apiError.error;
+    }
+    if (typeof apiError.message === "string" && apiError.message.trim()) {
+      return apiError.message;
+    }
+  }
+  return `Request failed with status ${status}.`;
+}
+function toHttpError(status, body) {
+  const message = getErrorMessage(status, body);
+  const options = { status, details: body };
+  if (status === 401) {
+    return new UnauthorizedError(message, options);
+  }
+  if (status === 404) {
+    return new NotFoundError(message, options);
+  }
+  if (status >= 500) {
+    return new ServerError(message, options);
+  }
+  return new HttpError(message, options);
+}
+async function requestJson(config, path, validate) {
+  const { signal, cleanup } = createTimeoutSignal(config.timeoutMs);
+  try {
+    const response = await config.fetch(`${config.baseUrl}${path}`, {
+      method: "GET",
+      signal,
+      headers: {
+        accept: "application/json",
+        "x-api-key": config.apiKey
+      }
+    });
+    const body = await parseBody(response);
+    if (!response.ok) {
+      throw toHttpError(response.status, body);
+    }
+    return validate(body);
+  } catch (error) {
+    if (error instanceof HttpError || error instanceof MalformedResponseError) {
+      throw error;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new TimeoutError(
+        `Request timed out after ${config.timeoutMs}ms.`,
+        { cause: error }
+      );
+    }
+    throw error;
+  } finally {
+    cleanup();
+  }
+}
+
+// src/validation.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isNullableString(value) {
+  return typeof value === "string" || value === null;
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function isSecuritySummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.token_address) && isString(value.token_name) && isString(value.token_symbol) && isString(value.network_id) && isString(value.token_type);
+}
+function isSellerOrganizationSummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.legal_name) && isNullableString(value.display_name) && isString(value.jurisdiction) && isNullableString(value.website);
+}
+function isBookSummary(value) {
+  return isRecord(value) && isString(value.id) && isString(value.order_book_address) && isString(value.status) && isString(value.network_id) && isFiniteNumber(value.subscription_start) && isFiniteNumber(value.subscription_end) && isString(value.prospectus_file_url);
+}
+function isAssetRecord(value) {
+  return isRecord(value) && isSecuritySummary(value.security) && isSellerOrganizationSummary(value.seller_organization) && Array.isArray(value.books) && value.books.every(isBookSummary);
+}
+function validateSdkAssetsResponse(value) {
+  if (!isRecord(value) || !Array.isArray(value.data) || !isFiniteNumber(value.count) || !value.data.every(isAssetRecord)) {
+    throw new MalformedResponseError(
+      "Received an invalid SDK assets response shape.",
+      { details: value }
+    );
+  }
+  return value;
+}
+function validateSdkAssetResponse(value) {
+  if (!isRecord(value) || !isAssetRecord(value.data)) {
+    throw new MalformedResponseError(
+      "Received an invalid SDK asset response shape.",
+      { details: value }
+    );
+  }
+  return value;
+}
+
+// src/client.ts
+function createClient(config) {
+  const resolved = resolveClientConfig(config);
+  return {
+    getAssets() {
+      return requestJson(resolved, "/sdk/assets", validateSdkAssetsResponse);
+    },
+    getAssetByTokenAddress(tokenAddress) {
+      const trimmedTokenAddress = tokenAddress.trim();
+      if (!trimmedTokenAddress) {
+        throw new InvalidConfigurationError(
+          "tokenAddress must not be empty."
+        );
+      }
+      return requestJson(
+        resolved,
+        `/sdk/assets/${encodeURIComponent(trimmedTokenAddress)}`,
+        validateSdkAssetResponse
+      );
+    }
+  };
+}
+export {
+  ENVIRONMENT_BASE_URLS,
+  HttpError,
+  InvalidConfigurationError,
+  MalformedResponseError,
+  NotFoundError,
+  SereeSdkError,
+  ServerError,
+  TimeoutError,
+  UnauthorizedError,
+  createClient,
+  resolveBaseUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/transport.ts","../src/validation.ts","../src/client.ts"],"sourcesContent":["export interface SereeSdkErrorOptions {\n  status?: number;\n  code?: string;\n  cause?: unknown;\n  details?: unknown;\n}\n\nexport class SereeSdkError extends Error {\n  readonly status: number | undefined;\n  readonly code: string | undefined;\n  readonly details?: unknown;\n\n  constructor(message: string, options: SereeSdkErrorOptions = {}) {\n    super(message, options.cause ? { cause: options.cause } : undefined);\n    this.name = new.target.name;\n    this.status = options.status;\n    this.code = options.code;\n    this.details = options.details;\n  }\n}\n\nexport class InvalidConfigurationError extends SereeSdkError {}\n\nexport class HttpError extends SereeSdkError {}\n\nexport class UnauthorizedError extends HttpError {}\n\nexport class NotFoundError extends HttpError {}\n\nexport class ServerError extends HttpError {}\n\nexport class TimeoutError extends SereeSdkError {}\n\nexport class MalformedResponseError extends SereeSdkError {}\n","import { InvalidConfigurationError } from \"./errors\";\nimport type { ClientConfig, SereeEnvironment } from \"./types\";\n\nexport const ENVIRONMENT_BASE_URLS: Record<SereeEnvironment, string> = {\n  devnet: \"https://api-lazer.sereel.com\",\n  testnet: \"https://api-lazer-v2.sereel.com\",\n  mainnet: \"https://cahokia.sereel.com\",\n};\n\nexport interface ResolvedClientConfig {\n  environment: SereeEnvironment;\n  apiKey: string;\n  timeoutMs: number;\n  baseUrl: string;\n  fetch: typeof fetch;\n}\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\nfunction getFetchImplementation(\n  providedFetch: ClientConfig[\"fetch\"],\n): typeof fetch {\n  if (providedFetch) {\n    return providedFetch;\n  }\n\n  if (typeof globalThis.fetch === \"function\") {\n    return globalThis.fetch.bind(globalThis);\n  }\n\n  throw new InvalidConfigurationError(\n    \"No fetch implementation is available. Provide config.fetch in this runtime.\",\n  );\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  const trimmed = baseUrl.trim();\n\n  if (!trimmed) {\n    throw new InvalidConfigurationError(\"baseUrl must not be empty when provided.\");\n  }\n\n  try {\n    return new URL(trimmed).toString().replace(/\\/+$/, \"\");\n  } catch (cause) {\n    throw new InvalidConfigurationError(\"baseUrl must be a valid absolute URL.\", {\n      cause,\n    });\n  }\n}\n\nexport function resolveBaseUrl(\n  environment: SereeEnvironment,\n  baseUrl?: string,\n): string {\n  if (baseUrl) {\n    return normalizeBaseUrl(baseUrl);\n  }\n\n  return ENVIRONMENT_BASE_URLS[environment];\n}\n\nexport function resolveClientConfig(config: ClientConfig): ResolvedClientConfig {\n  const apiKey = config.apiKey.trim();\n\n  if (!apiKey) {\n    throw new InvalidConfigurationError(\"apiKey must not be empty.\");\n  }\n\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new InvalidConfigurationError(\"timeoutMs must be a positive number.\");\n  }\n\n  return {\n    environment: config.environment,\n    apiKey,\n    timeoutMs,\n    baseUrl: resolveBaseUrl(config.environment, config.baseUrl),\n    fetch: getFetchImplementation(config.fetch),\n  };\n}\n","import {\n  HttpError,\n  MalformedResponseError,\n  NotFoundError,\n  ServerError,\n  TimeoutError,\n  UnauthorizedError,\n} from \"./errors\";\nimport type { ResolvedClientConfig } from \"./config\";\n\ninterface ApiErrorBody {\n  error?: string;\n  message?: string;\n}\n\nfunction createTimeoutSignal(timeoutMs: number): {\n  signal: AbortSignal;\n  cleanup: () => void;\n} {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  return {\n    signal: controller.signal,\n    cleanup: () => clearTimeout(timeout),\n  };\n}\n\nasync function parseBody(response: Response): Promise<unknown> {\n  const text = await response.text();\n  if (!text) {\n    return null;\n  }\n\n  try {\n    return JSON.parse(text) as unknown;\n  } catch (cause) {\n    throw new MalformedResponseError(\"Received a non-JSON response body.\", {\n      cause,\n      status: response.status,\n      details: text,\n    });\n  }\n}\n\nfunction getErrorMessage(status: number, body: unknown): string {\n  if (body && typeof body === \"object\") {\n    const apiError = body as ApiErrorBody;\n    if (typeof apiError.error === \"string\" && apiError.error.trim()) {\n      return apiError.error;\n    }\n    if (typeof apiError.message === \"string\" && apiError.message.trim()) {\n      return apiError.message;\n    }\n  }\n\n  return `Request failed with status ${status}.`;\n}\n\nfunction toHttpError(status: number, body: unknown): HttpError {\n  const message = getErrorMessage(status, body);\n  const options = { status, details: body };\n\n  if (status === 401) {\n    return new UnauthorizedError(message, options);\n  }\n  if (status === 404) {\n    return new NotFoundError(message, options);\n  }\n  if (status >= 500) {\n    return new ServerError(message, options);\n  }\n\n  return new HttpError(message, options);\n}\n\nexport async function requestJson<T>(\n  config: ResolvedClientConfig,\n  path: string,\n  validate: (value: unknown) => T,\n): Promise<T> {\n  const { signal, cleanup } = createTimeoutSignal(config.timeoutMs);\n\n  try {\n    const response = await config.fetch(`${config.baseUrl}${path}`, {\n      method: \"GET\",\n      signal,\n      headers: {\n        accept: \"application/json\",\n        \"x-api-key\": config.apiKey,\n      },\n    });\n\n    const body = await parseBody(response);\n    if (!response.ok) {\n      throw toHttpError(response.status, body);\n    }\n\n    return validate(body);\n  } catch (error) {\n    if (error instanceof HttpError || error instanceof MalformedResponseError) {\n      throw error;\n    }\n\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw new TimeoutError(\n        `Request timed out after ${config.timeoutMs}ms.`,\n        { cause: error },\n      );\n    }\n\n    throw error;\n  } finally {\n    cleanup();\n  }\n}\n","import { MalformedResponseError } from \"./errors\";\nimport type {\n  SdkAssetRecord,\n  SdkAssetResponse,\n  SdkAssetsResponse,\n  SdkBookSummary,\n  SdkSecuritySummary,\n  SdkSellerOrganizationSummary,\n} from \"./types\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\nfunction isNullableString(value: unknown): value is string | null {\n  return typeof value === \"string\" || value === null;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isSecuritySummary(value: unknown): value is SdkSecuritySummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.token_address) &&\n    isString(value.token_name) &&\n    isString(value.token_symbol) &&\n    isString(value.network_id) &&\n    isString(value.token_type)\n  );\n}\n\nfunction isSellerOrganizationSummary(\n  value: unknown,\n): value is SdkSellerOrganizationSummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.legal_name) &&\n    isNullableString(value.display_name) &&\n    isString(value.jurisdiction) &&\n    isNullableString(value.website)\n  );\n}\n\nfunction isBookSummary(value: unknown): value is SdkBookSummary {\n  return (\n    isRecord(value) &&\n    isString(value.id) &&\n    isString(value.order_book_address) &&\n    isString(value.status) &&\n    isString(value.network_id) &&\n    isFiniteNumber(value.subscription_start) &&\n    isFiniteNumber(value.subscription_end) &&\n    isString(value.prospectus_file_url)\n  );\n}\n\nfunction isAssetRecord(value: unknown): value is SdkAssetRecord {\n  return (\n    isRecord(value) &&\n    isSecuritySummary(value.security) &&\n    isSellerOrganizationSummary(value.seller_organization) &&\n    Array.isArray(value.books) &&\n    value.books.every(isBookSummary)\n  );\n}\n\nexport function validateSdkAssetsResponse(value: unknown): SdkAssetsResponse {\n  if (\n    !isRecord(value) ||\n    !Array.isArray(value.data) ||\n    !isFiniteNumber(value.count) ||\n    !value.data.every(isAssetRecord)\n  ) {\n    throw new MalformedResponseError(\n      \"Received an invalid SDK assets response shape.\",\n      { details: value },\n    );\n  }\n\n  return value as unknown as SdkAssetsResponse;\n}\n\nexport function validateSdkAssetResponse(value: unknown): SdkAssetResponse {\n  if (!isRecord(value) || !isAssetRecord(value.data)) {\n    throw new MalformedResponseError(\n      \"Received an invalid SDK asset response shape.\",\n      { details: value },\n    );\n  }\n\n  return value as unknown as SdkAssetResponse;\n}\n","import { resolveClientConfig } from \"./config\";\nimport { InvalidConfigurationError } from \"./errors\";\nimport { requestJson } from \"./transport\";\nimport type {\n  ClientConfig,\n  SdkAssetResponse,\n  SdkAssetsResponse,\n  SereeSdkClient,\n} from \"./types\";\nimport {\n  validateSdkAssetResponse,\n  validateSdkAssetsResponse,\n} from \"./validation\";\n\nexport function createClient(config: ClientConfig): SereeSdkClient {\n  const resolved = resolveClientConfig(config);\n\n  return {\n    getAssets(): Promise<SdkAssetsResponse> {\n      return requestJson(resolved, \"/sdk/assets\", validateSdkAssetsResponse);\n    },\n\n    getAssetByTokenAddress(tokenAddress: string): Promise<SdkAssetResponse> {\n      const trimmedTokenAddress = tokenAddress.trim();\n      if (!trimmedTokenAddress) {\n        throw new InvalidConfigurationError(\n          \"tokenAddress must not be empty.\",\n        );\n      }\n\n      return requestJson(\n        resolved,\n        `/sdk/assets/${encodeURIComponent(trimmedTokenAddress)}`,\n        validateSdkAssetResponse,\n      );\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@sereel/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Seree asset read endpoints",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}