@rundit-sdk/embed 0.0.1

package/dist/index.js

@@ -0,0 +1,326 @@
+const routeManifest = {
+  "companies": {
+    "getOne": {
+      "method": "GET",
+      "path": "/companies/:id",
+      "summary": "Get one company available to the SDK consumer",
+      "description": null,
+      "exampleCall": "client.companies.getOne('123')",
+      "responseType": "CompaniesGetOneResponse",
+      "pathParams": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Company identifier"
+        }
+      ],
+      "queryParams": []
+    },
+    "getAll": {
+      "method": "GET",
+      "path": "/companies",
+      "summary": "List companies available to the SDK consumer",
+      "description": null,
+      "exampleCall": "client.companies.getAll()",
+      "responseType": "CompaniesGetAllResponse",
+      "pathParams": [],
+      "queryParams": []
+    }
+  },
+  "companyGroups": {
+    "getAll": {
+      "method": "GET",
+      "path": "/company-groups",
+      "summary": "List company groups available to the SDK consumer",
+      "description": null,
+      "exampleCall": "client.companyGroups.getAll()",
+      "responseType": "CompanyGroupsGetAllResponse",
+      "pathParams": [],
+      "queryParams": []
+    },
+    "getOne": {
+      "method": "GET",
+      "path": "/company-groups/:id",
+      "summary": "Get one company group available to the SDK consumer",
+      "description": null,
+      "exampleCall": "client.companyGroups.getOne('123')",
+      "responseType": "CompanyGroupsGetOneResponse",
+      "pathParams": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Company group identifier"
+        }
+      ],
+      "queryParams": []
+    }
+  },
+  "positions": {
+    "getCompanyPositions": {
+      "method": "GET",
+      "path": "/positions/companies/:id",
+      "summary": "Get positions for one company",
+      "description": null,
+      "exampleCall": "client.positions.getCompanyPositions('123', { currency: 'USD' })",
+      "responseType": "PositionsGetCompanyPositionsResponse",
+      "pathParams": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Company identifier"
+        }
+      ],
+      "queryParams": [
+        {
+          "name": "companyGroupId",
+          "required": false,
+          "type": "number",
+          "description": "Optional company group identifier to filter by"
+        },
+        {
+          "name": "currency",
+          "required": true,
+          "type": "string",
+          "description": "Reporting currency code"
+        },
+        {
+          "name": "date",
+          "required": false,
+          "type": "string",
+          "description": "Optional summary date in ISO format"
+        }
+      ]
+    },
+    "getPortfolioPositions": {
+      "method": "GET",
+      "path": "/positions/portfolio",
+      "summary": "Get portfolio positions",
+      "description": null,
+      "exampleCall": "client.positions.getPortfolioPositions({ currency: 'USD' })",
+      "responseType": "PositionsGetPortfolioPositionsResponse",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "companyGroupIds",
+          "required": false,
+          "type": "number[]",
+          "description": "Optional list of company group identifiers to filter the portfolio positions"
+        },
+        {
+          "name": "currency",
+          "required": true,
+          "type": "string",
+          "description": "Reporting currency code"
+        },
+        {
+          "name": "date",
+          "required": false,
+          "type": "string",
+          "description": "Optional summary date in ISO format"
+        }
+      ]
+    }
+  },
+  "transactions": {
+    "getCompanyTransactions": {
+      "method": "GET",
+      "path": "/transactions/companies/:id",
+      "summary": "Get transactions for one company",
+      "description": null,
+      "exampleCall": "client.transactions.getCompanyTransactions('123', { companyGroupIds: [123] })",
+      "responseType": "TransactionsGetCompanyTransactionsResponse",
+      "pathParams": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Company identifier"
+        }
+      ],
+      "queryParams": [
+        {
+          "name": "companyGroupIds",
+          "required": false,
+          "type": "number[]",
+          "description": "Optional company group identifiers to filter transactions by"
+        }
+      ]
+    },
+    "getTransactions": {
+      "method": "GET",
+      "path": "/transactions",
+      "summary": "Get transactions for multiple companies",
+      "description": null,
+      "exampleCall": "client.transactions.getTransactions({ companyGroupIds: [123] })",
+      "responseType": "TransactionsGetTransactionsResponse",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "companyGroupIds",
+          "required": false,
+          "type": "number[]",
+          "description": "Optional company group identifiers to filter transactions by"
+        },
+        {
+          "name": "companyIds",
+          "required": false,
+          "type": "number[]",
+          "description": "Optional company identifiers to filter transactions by"
+        }
+      ]
+    }
+  }
+}
+
+export class RunditSdkError extends Error {
+  constructor(message, details) {
+    super(message)
+    this.name = 'RunditSdkError'
+    this.status = details.status
+    this.body = details.body
+  }
+}
+
+function resolveFetch(customFetch) {
+  if (customFetch) {
+    return customFetch
+  }
+
+  if (typeof globalThis.fetch === 'function') {
+    return globalThis.fetch.bind(globalThis)
+  }
+
+  throw new Error('No fetch implementation available. Pass options.fetch when initializing the client.')
+}
+
+function normalizeBaseUrl(baseUrl) {
+  return baseUrl.replace(/\/+$/, '')
+}
+
+function interpolatePath(pathTemplate, pathParams = {}) {
+  return pathTemplate.replace(/:([A-Za-z0-9_]+)/g, (_, key) => {
+    const value = pathParams[key]
+
+    if (value === undefined || value === null) {
+      throw new Error(`Missing required path parameter: ${key}`)
+    }
+
+    return encodeURIComponent(String(value))
+  })
+}
+
+function appendQueryString(url, query = {}) {
+  const searchParams = new URLSearchParams()
+
+  Object.entries(query).forEach(([key, value]) => {
+    if (value === undefined || value === null) {
+      return
+    }
+
+    if (Array.isArray(value)) {
+      value.forEach((item) => {
+        if (item !== undefined && item !== null) {
+          searchParams.append(key, String(item))
+        }
+      })
+      return
+    }
+
+    searchParams.append(key, String(value))
+  })
+
+  const queryString = searchParams.toString()
+  return queryString.length > 0 ? `${url}?${queryString}` : url
+}
+
+async function parseResponse(response) {
+  if (response.status === 204) {
+    return undefined
+  }
+
+  const contentType = response.headers.get('content-type') || ''
+
+  if (contentType.includes('application/json')) {
+    return response.json()
+  }
+
+  return response.text()
+}
+
+function createRequester(options) {
+  const fetchImplementation = resolveFetch(options.fetch)
+  const baseUrl = normalizeBaseUrl(options.baseUrl)
+  const defaultHeaders = {
+    Accept: 'application/json',
+    ...options.headers,
+    "Authorization": `Bearer ${options.token}`,
+  }
+
+  return async ({ method, path, pathParams, query, signal }) => {
+    const url = appendQueryString(baseUrl + interpolatePath(path, pathParams), query)
+    const response = await fetchImplementation(url, {
+      method,
+      headers: defaultHeaders,
+      signal,
+    })
+
+    const body = await parseResponse(response)
+
+    if (!response.ok) {
+      throw new RunditSdkError(`Rundit request failed with status ${response.status}`, {
+        status: response.status,
+        body,
+      })
+    }
+
+    return body
+  }
+}
+
+function createCompaniesNamespace(request) {
+  return {
+    getOne: (id, init = {}) => request({ method: "GET", path: "/companies/:id", pathParams: { id }, query: undefined, signal: init.signal }),
+    getAll: (init = {}) => request({ method: "GET", path: "/companies", pathParams: undefined, query: undefined, signal: init.signal }),
+  }
+}
+
+function createCompanyGroupsNamespace(request) {
+  return {
+    getAll: (init = {}) => request({ method: "GET", path: "/company-groups", pathParams: undefined, query: undefined, signal: init.signal }),
+    getOne: (id, init = {}) => request({ method: "GET", path: "/company-groups/:id", pathParams: { id }, query: undefined, signal: init.signal }),
+  }
+}
+
+function createPositionsNamespace(request) {
+  return {
+    getCompanyPositions: (id, query = {}, init = {}) => request({ method: "GET", path: "/positions/companies/:id", pathParams: { id }, query: query, signal: init.signal }),
+    getPortfolioPositions: (query = {}, init = {}) => request({ method: "GET", path: "/positions/portfolio", pathParams: undefined, query: query, signal: init.signal }),
+  }
+}
+
+function createTransactionsNamespace(request) {
+  return {
+    getCompanyTransactions: (id, query = {}, init = {}) => request({ method: "GET", path: "/transactions/companies/:id", pathParams: { id }, query: query, signal: init.signal }),
+    getTransactions: (query = {}, init = {}) => request({ method: "GET", path: "/transactions", pathParams: undefined, query: query, signal: init.signal }),
+  }
+}
+
+export function createEmbedClient(options) {
+  if (!options || typeof options.baseUrl !== 'string' || options.baseUrl.length === 0) {
+    throw new Error('options.baseUrl is required')
+  }
+
+  if (!options.token) {
+    throw new Error('options.token is required')
+  }
+
+  const request = createRequester(options)
+
+  return {
+    companies: createCompaniesNamespace(request),
+    companyGroups: createCompanyGroupsNamespace(request),
+    positions: createPositionsNamespace(request),
+    transactions: createTransactionsNamespace(request),
+  }
+}
+
+export { routeManifest }