serverless-cloud-data-utils

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #golang #go #rust #macos #cli #awesome-list #vue #ios #openai

serverless-cloud-data-utils

(★ 11)

Utilities for working with serverless cloud data APIs.

serverless-cloud-data-utils 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="./serverless-data.svg" width="64px"/>
 
# Utilities for [Serverless Data](https://www.serverless.com/cloud/docs/apps/data)

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/loreanvictor/serverless-cloud-data-utils/test-and-report-coverage.yml?label=tests)](https://github.com/loreanvictor/serverless-cloud-data-utils/actions/workflows/test-and-report-coverage.yml)
[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/e40ed7b97c1c4e6982f64e6644aabf0f)](https://www.codacy.com/gh/loreanvictor/serverless-cloud-data-utils/dashboard?utm_source=github.com&utm_medium=referral&utm_content=loreanvictor/serverless-cloud-data-utils&utm_campaign=Badge_Coverage)
[![version](https://img.shields.io/npm/v/serverless-cloud-data-utils?logo=npm)](https://www.npmjs.com/package/serverless-cloud-data-utils)

</div>

Utilities for working with [serverless cloud](https://www.serverless.com/cloud) [data APIs](https://www.serverless.com/cloud/docs/apps/data). By default, accessing and modifying data via `@serverless/cloud` API revolves around namespaces and key expressions, tracking which can be a headache (imagine a typo in a namespace or a key expression). With `serverless-cloud-data-utils`, you can define your models and their indexes (access paths) programmatically, and then access and modify your data in a consistent and type-safe manner.

## How to Install

Install via [NPM](https://www.npmjs.com/package/serverless-cloud-data-utils). Note that this library is a wrapper on top of [serverless cloud](https://www.serverless.com/cloud), so it would only work in an environment
where `@serverless/cloud` package is installed (and is not a mock), i.e. on serverless cloud apps and instances.
  
```bash
npm i serverless-cloud-data-utils
```

## How to Use

📐 First you need to define your model and its indexes:

```ts
// order.model.ts

import { Model, buildIndex, indexBy, timekey } from 'serverless-cloud-data-utils'

//
// Indexes are ways you want to be able to access
// your records.
//

//
// 👉 this is for accessing orders by their id
//
export const OrderId = buildIndex({ namespace: 'orders' })

//
// 👉 this is for accessing orders by their time.
//    this is a secondary index, so it needs an explicit label
//    (which can be label1-label5)
//
export const OrderTime = buildIndex({
  namespace: 'orders',
  label: 'label1',
  converter: timekey,    // --> timestamp strings are illegal by default, this converter takes care of that.
})

// 
// 👉 this parametric index allows accessing
//    orders of a specific user.
//
export const OrderOwner = owner => buildIndex({
  namespace: `orders_${owner.id}`,
  label: 'label2',
  converter: timekey,
})

export class Order extends Model<Order> {
 id: string
 owner: User
 amount: number
 date: string
 
 //
 // 👉 this method indicates the indexes of each record
 // and how they are mapped to its properties.
 // note that you should have only one primary index,
 // and the secondary indexes should have distinct
 // labels.
 //
 keys() {
 return [
 indexBy(OrderTime).exact(this.date),
 indexBy(OrderId).exact(this.id),
 indexBy(OrderOwner(this.owner)).exact(this.date),
 ]
 }
}
```

✨ Now you can create and store new objects:

```ts
import { Order } from './order.model'

const newOrder = new Order()
newOrder.amount = 42
newOrder.user = someUser
newOrder.date = new Date().toISOString()
newOrder.id = uuid.v4()

await newOrder.save()
```

✏️ Modify objects:

```ts
myOrder.amount += 10
await myOrder.save()
```

🗑️ Delete objects:

```ts
await someOrder.delete()
```

🎯 Get a specific object:

```ts
import { indexBy } from 'serverless-cloud-data-utils'
import { Order, OrderId } from './order.model'

const order = await indexBy(OrderId).exact('some_id').get(Order)
```

🔍 Or query objects with specific indexes:

```ts
import { indexBy } from 'serverless-cloud-data-utils'
import { Order, OrderTime } from './order.model'

//
// fetch last 10 orders
//

const latestOrders = await indexBy(OrderTime)
  .limit(10)
  .reverse()
  .get(Order)
```
```ts
import { indexBy } from 'serverless-cloud-data-utils'
import { Order, OrderOwner } from './order.model'

//
// get orders of a user
// which where issued last month
//

const lastMonth = new Date()
lastMonth.setMonth(lastMonth.getMonth() - 1)

const userOrders = await indexBy(OrderOwner(someUser))
  .after(lastMonth)
  .reverse()
  .get(Order)
```

📦 Use `.clean()` method for sending model data over network:

```ts
import { api } from '@serverless/cloud'
import { indexBy } from 'serverless-cloud-data-utils'
import { Order, OrderId } from './order.model'

api.get('/:id', async (req, res) => {
  const order = await indexBy(OrderId).exact(req.params.id).get(Order)

if (order) {
    res.send(order.clean())
  } else {
    res.status(404).send()
  }
})
```

🧹 You can also use `.clean()` to exclude some fields you don't want to
send to the client:
```ts
order.clean(['id', 'owner'])
```

## Formatting

Fields of your models **MUST** always be camel case, since any data retreived from the database
will be converted into camel case. Conversely, when you call `.clean()`, the data is also converted to snake case for transfer over the network.
These rules also apply to nested objects.

## Contribution

Feedback and pull requests are more than welcome! Currently the main pressing issues are:

- [ ] Full API documentation
- [ ] Support for metadata

Here are some useful commands for contributing:

```bash
npm test          # runs all the tests
```
```bash
npm run cov:view  # checks the coverage status, try to avoid coverage regression!
```

serverless-cloud-data-utils

serverless-cloud-data-utils 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

serverless-cloud-data-utils

serverless-cloud-data-utils 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README