Nekomata API
Nekomata API is a simple Node.js and TypeScript-based API server. This project is structured to provide a solid foundation for building scalable APIs using modern JavaScript/TypeScript practices.
Features
- TypeScript: Strongly typed JavaScript, providing better tooling and readability.
- Node.js: Fast and scalable server-side runtime.
- Modular Structure: Easily extendable with well-defined modules and services.
Prerequisites
Make sure you have the following installed on your machine:
Installation
Clone the repository:
git clone https://github.com/your-username/nekomata-api.git
cd nekomata-api
Install the dependencies:
yarn install
Useful Commands
- Enter Docker Mysql:
sudo docker exec -it mysql bash
- Create new Sequelize Model (and migration for it):
npx sequelize-cli model:generate --name User --attributes firstName:string,lastName:string,email:string
Available Scripts
1. Development Mode
To run the project in development mode with hot-reloading:
yarn dev
2. Build for Production
To compile the project into JavaScript (production build):
yarn build
The compiled files will be located in the dist/
folder.
3. Serve Production Build
After building the project, you can serve it in production mode:
yarn serve
Project Structure
bb b src/ # Source code
b bb b controllers/ # API controllers
b bb b services/ # Business logic
b bb b routes/ # API routes
b bb b models/ # Data models (if using a database)
b bb b utils/ # Utility functions
b bb b index.ts # Application entry point
bb b dist/ # Compiled production code
bb b package.json # Project dependencies and scripts
bb b tsconfig.json # TypeScript configuration
bb b README.md # Project documentation
License
All rights reserved. This project and its content may not be used, copied, modified, or distributed without prior permission from the owner.
nekomata-api neon
This project was bootstrapped by create-neon.
Building nekomata-api neon
Building nekomata-api neon requires a supported version of Node and Rust.
To run the build, run:
$ npm run build
This command uses the @neon-rs/cli utility to assemble the binary Node addon from the output of cargo
.
Exploring nekomata-api neon
After building nekomata-api neon, you can explore its exports at the Node console:
$ npm i
$ npm run build
$ node
> require('.').hello()
'hello node'
Available Scripts
In the project directory, you can run:
npm install
Installs the project, including running npm run build
.
npm run build
Builds the Node addon (index.node
) from source, generating a release build with cargo --release
.
Additional cargo build
arguments may be passed to npm run build
and similar commands. For example, to enable a cargo feature:
npm run build -- --feature=beetle
npm run debug
Similar to npm run build
but generates a debug build with cargo
.
npm run cross
Similar to npm run build
but uses cross-rs to cross-compile for another platform. Use the CARGO_BUILD_TARGET
environment variable to select the build target.
npm test
Runs the unit tests by calling cargo test
. You can learn more about adding tests to your Rust code from the Rust book.
Project Layout
The directory structure of this project is:
nekomata-api neon/
bb b Cargo.toml
bb b README.md
bb b src/
| bb b lib.rs
bb b index.node
bb b package.json
bb b target/
Entry | Purpose |
---|---|
Cargo.toml |
The Cargo manifest file, which informs the cargo command. |
README.md |
This file. |
src/ |
The directory tree containing the Rust source code for the project. |
lib.rs |
Entry point for the Rust source code. |
index.node |
The main module, a Node addon generated by the build and pointed to by "main" in package.json . |
package.json |
The npm manifest file, which informs the npm command. |
target/ |
Binary artifacts generated by the Rust build. |
Learn More
Learn more about:
https://blog.metlo.com/writing-a-node-library-in-rust/
https://assets.razerzone.com/dev_portal/REST/html/md__r_e_s_t_external_11_heartbeat.html https://developers.home.google.com/codelabs/smarthome-washer?hl=en&continue=https%3A%2F%2Fcodelabs.developers.google.com%2F%3Fcat%3Dassistant#2 https://github.com/google-home/smarthome-washer https://github.com/google-home/smart-home-local
https://console.actions.google.com/u/0/ https://www.home-assistant.io/integrations/google_assistant_sdk https://medium.com/@silvano.luciani/actions-on-google-client-library-for-node-js-v2-0-0-alpha-c92361167f15 https://medium.com/@silvano.luciani/deploy-your-assistant-app-fulfillment-webhook-using-cloud-functions-for-firebase-da83275ee715
https://dev.to/obniz_io/google-home-integration-3e8c https://dev.to/davidnadejdin/build-your-for-google-home-2b2a
https://console.cloud.google.com/apis/credentials?authuser=2&project=pcsmart https://codeculturepro.medium.com/implementing-authentication-in-nodejs-app-using-oauth2-0-59fee8f63798 https://dev.to/davidnadejdin/build-your-for-google-home-2b2a