oPoint realtime news feed API client

• (TODO: Not implemented) Search
• Stored search
• (TODO: Not implemented) Safefeed

Installation

$ npm install --save @opoint/storedsearch
$ npm install --save-dev @opoint/types

Using stored search

See tests/stored-search.test.ts and @opoint/types for more options.

import { StoredSearch } from '@opoint/storedsearch'
// Pass your API key to the constructor
const api = new StoredSearch({ api_key: process.env.OPOINT_API_KEY })

// ...
// Add a new stored search
const props: StoredSearchAddProps = { search: "Anthropic"}
const res = await api.add(props)

// List current stored searches
const res = await api.list()
const body = res.data as StoredSearchListResponse

// Retrieve a stored search
const params: StoredSearchRetrieveProps = {
  id: 0, // some stored search id
}
const res = await api.retrieve(params)
const body = res.data as StoredSearchRetrieveResponse

// Retrieve data from all stored searchs
const params: StoredSearchFeedProps = {
  from: 0,      // A Unix timestamp (in seconds since epoc)
  format: 'json' as FormatEnum, // or `xml`
  num_art: 50,  // Number of articles to return
}

const res = await api.feed(params)
const body = res.data as StoredSearchFeedResponse
// A list of documents since `from`
const documents: Array<DocumentProps> = body.searchresult.document

// (Not implemented) Retrieve data from all stored searchs filted by group

// Update a stored search
const params: StoredSearchUpdateProps = {
  id: 0, // some stored search id
  search: "Anthropic Claude"
}
const res = await api.update(params)
const body = res.data as StoredSearchUpdateResponse

// Delete a stored search
const props: StoredSearchDeleteProps = {
  id: searches[0]?.id
}
const res = await api.delete(props)
// Returns res.response.status = 204 no content

Contributing

Tests

$ npm install --dev
$ npm run tests

Add a new package

Following this pattern: https://www.yieldcode.blog/post/npm-workspaces/ https://stackoverflow.com/questions/72055371/npm-workspaces-typescript-unable-to-find-local-modules

$ npm init --workspace packages/types --scope @opoint -y
$ ls -la node_modules/@opoint/

Require a new package

$ npm install @opoint/types --workspace ./packages/storedsearch
$ cat packages/storedsearch/package.json | grep -C1 opoint
$ npm ls