Compare commits

...

72 Commits

Author SHA1 Message Date
82edd4b457 3.0.19 2024-05-05 16:39:42 +02:00
dd23719646 fix(core): update 2024-05-05 16:39:42 +02:00
53aece818a update documentation 2024-04-14 18:59:49 +02:00
fba724741b 3.0.18 2024-02-29 19:41:34 +01:00
854cc93644 fix(core): update 2024-02-29 19:41:34 +01:00
ec7fa07855 3.0.17 2024-02-24 14:51:09 +01:00
b34e88123d fix(core): update 2024-02-24 14:51:08 +01:00
b680ab8c23 3.0.16 2024-02-24 14:45:32 +01:00
f0547b33d3 fix(core): update 2024-02-24 14:45:31 +01:00
20c5b115d8 3.0.15 2024-02-24 14:45:18 +01:00
c3801ecd53 fix(core): update 2024-02-24 14:45:17 +01:00
51f03a45b6 3.0.14 2024-02-24 11:10:04 +01:00
ed8879a4c8 fix(core): update 2024-02-24 11:10:03 +01:00
806970c701 3.0.13 2024-02-23 20:18:20 +01:00
9638f74440 fix(core): update 2024-02-23 20:18:19 +01:00
b538c4fbdb 3.0.12 2024-02-23 17:02:13 +01:00
1d3dc08e39 fix(core): update 2024-02-23 17:02:12 +01:00
56f59bf640 3.0.11 2024-02-23 16:00:37 +01:00
268df991c4 fix(core): update 2024-02-23 16:00:36 +01:00
b3d8dd1573 3.0.10 2024-02-23 15:48:32 +01:00
0fb36ea928 fix(core): update 2024-02-23 15:48:31 +01:00
10148f7c50 3.0.9 2024-02-22 15:15:45 +01:00
274bf30973 fix(core): update 2024-02-22 15:15:44 +01:00
e3ff1c3c4b 3.0.8 2024-02-22 13:28:47 +01:00
446a9d1723 fix(core): update 2024-02-22 13:28:47 +01:00
a749f91a8f 3.0.7 2024-02-21 21:01:35 +01:00
8ea6db7b7f fix(core): update 2024-02-21 21:01:35 +01:00
715ee43bcc 3.0.6 2024-02-21 14:54:45 +01:00
c314b4e86f fix(core): update 2024-02-21 14:54:45 +01:00
5824d34764 3.0.5 2024-02-21 01:57:19 +01:00
5eb9035dfe fix(core): update 2024-02-21 01:57:19 +01:00
a49b1813fb 3.0.4 2024-02-21 01:55:50 +01:00
e33ae24f17 fix(core): update 2024-02-21 01:55:49 +01:00
2e13632fec 3.0.3 2024-02-21 00:34:24 +01:00
9175af027b fix(core): update 2024-02-21 00:34:24 +01:00
f9524a62d7 3.0.2 2024-02-20 20:47:12 +01:00
7889e04915 fix(core): update 2024-02-20 20:47:12 +01:00
a81b9eced6 3.0.1 2023-08-04 13:19:24 +02:00
4aa06fe830 fix(core): update 2023-08-04 13:19:23 +02:00
adeab3e7b7 3.0.0 2023-08-03 21:18:39 +02:00
5a356b66f6 BREAKING CHANGE(core): update 2023-08-03 21:18:38 +02:00
4525d2b564 2.0.2 2023-08-03 21:18:26 +02:00
32c181685c fix(core): update 2023-08-03 21:18:25 +02:00
bf2601ec5e 2.0.1 2022-10-26 14:33:55 +02:00
63dabb35c1 fix(core): update 2022-10-26 14:33:55 +02:00
299e34d8d9 2.0.0 2022-10-26 14:09:51 +02:00
706d428323 BREAKING CHANGE(core): switch to esm 2022-10-26 14:09:50 +02:00
267652b7f5 1.0.18 2022-10-26 11:36:08 +02:00
8e269d9929 fix(core): update 2022-10-26 11:36:08 +02:00
fa95ab4704 1.0.17 2022-10-26 11:35:20 +02:00
686ff9e6f2 fix(core): update 2022-10-26 11:35:19 +02:00
708c5d8a5b 1.0.16 2022-10-26 11:24:41 +02:00
d63621fe82 fix(core): update 2022-10-26 11:24:41 +02:00
8e1459bc86 1.0.15 2020-07-13 01:13:30 +00:00
4161c8f8b0 fix(core): update 2020-07-13 01:13:29 +00:00
38df866c05 1.0.14 2020-07-04 16:57:07 +00:00
d3fc1d3256 fix(core): update 2020-07-04 16:57:05 +00:00
ca0c191a8d 1.0.13 2020-02-20 22:01:59 +00:00
6b1791e578 fix(core): update 2020-02-20 22:01:58 +00:00
61a672f81d 1.0.12 2020-02-10 21:08:53 +00:00
e515f91088 fix(core): update 2020-02-10 21:08:52 +00:00
bd7349ab37 1.0.11 2020-02-10 21:06:52 +00:00
62f3b02812 fix(core): update 2020-02-10 21:06:51 +00:00
8316de8d82 1.0.10 2019-11-10 16:35:43 +01:00
f2c953f0e8 fix(core): update 2019-11-10 16:35:43 +01:00
5696b3cb19 1.0.9 2019-11-10 16:05:15 +01:00
3e3b955f04 1.0.8 2019-09-24 18:40:38 +02:00
d9326300b0 fix(core): update 2019-09-24 18:40:37 +02:00
b9b80d1078 1.0.7 2019-08-23 17:01:36 +02:00
bfc8541a03 1.0.6 2019-08-23 16:59:34 +02:00
5c5b59b510 update 2019-08-23 16:59:31 +02:00
f8a06daee7 new version 2019-08-23 16:57:45 +02:00
18 changed files with 5887 additions and 1814 deletions

View File

@ -0,0 +1,66 @@
name: Default (not tags)
on:
push:
tags-ignore:
- '**'
env:
IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
NPMCI_URL_CLOUDLY: ${{secrets.NPMCI_URL_CLOUDLY}}
jobs:
security:
runs-on: ubuntu-latest
continue-on-error: true
container:
image: ${{ env.IMAGE }}
steps:
- uses: actions/checkout@v3
- name: Install pnpm and npmci
run: |
pnpm install -g pnpm
pnpm install -g @shipzone/npmci
- name: Run npm prepare
run: npmci npm prepare
- name: Audit production dependencies
run: |
npmci command npm config set registry https://registry.npmjs.org
npmci command pnpm audit --audit-level=high --prod
continue-on-error: true
- name: Audit development dependencies
run: |
npmci command npm config set registry https://registry.npmjs.org
npmci command pnpm audit --audit-level=high --dev
continue-on-error: true
test:
if: ${{ always() }}
needs: security
runs-on: ubuntu-latest
container:
image: ${{ env.IMAGE }}
steps:
- uses: actions/checkout@v3
- name: Test stable
run: |
npmci node install stable
npmci npm install
npmci npm test
- name: Test build
run: |
npmci node install stable
npmci npm install
npmci npm build

View File

@ -0,0 +1,124 @@
name: Default (tags)
on:
push:
tags:
- '*'
env:
IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
NPMCI_URL_CLOUDLY: ${{secrets.NPMCI_URL_CLOUDLY}}
jobs:
security:
runs-on: ubuntu-latest
continue-on-error: true
container:
image: ${{ env.IMAGE }}
steps:
- uses: actions/checkout@v3
- name: Prepare
run: |
pnpm install -g pnpm
pnpm install -g @shipzone/npmci
npmci npm prepare
- name: Audit production dependencies
run: |
npmci command npm config set registry https://registry.npmjs.org
npmci command pnpm audit --audit-level=high --prod
continue-on-error: true
- name: Audit development dependencies
run: |
npmci command npm config set registry https://registry.npmjs.org
npmci command pnpm audit --audit-level=high --dev
continue-on-error: true
test:
if: ${{ always() }}
needs: security
runs-on: ubuntu-latest
container:
image: ${{ env.IMAGE }}
steps:
- uses: actions/checkout@v3
- name: Prepare
run: |
pnpm install -g pnpm
pnpm install -g @shipzone/npmci
npmci npm prepare
- name: Test stable
run: |
npmci node install stable
npmci npm install
npmci npm test
- name: Test build
run: |
npmci node install stable
npmci npm install
npmci npm build
release:
needs: test
if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
runs-on: ubuntu-latest
container:
image: ${{ env.IMAGE }}
steps:
- uses: actions/checkout@v3
- name: Prepare
run: |
pnpm install -g pnpm
pnpm install -g @shipzone/npmci
npmci npm prepare
- name: Release
run: |
npmci node install stable
npmci npm publish
metadata:
needs: test
if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
runs-on: ubuntu-latest
container:
image: ${{ env.IMAGE }}
continue-on-error: true
steps:
- uses: actions/checkout@v3
- name: Prepare
run: |
pnpm install -g pnpm
pnpm install -g @shipzone/npmci
npmci npm prepare
- name: Code quality
run: |
npmci command npm install -g typescript
npmci npm install
- name: Trigger
run: npmci trigger
- name: Build docs and upload artifacts
run: |
npmci node install stable
npmci npm install
pnpm install -g @gitzone/tsdoc
npmci command tsdoc
continue-on-error: true

4
.gitignore vendored
View File

@ -15,8 +15,6 @@ node_modules/
# builds
dist/
dist_web/
dist_serve/
dist_ts_web/
dist_*/
# custom

View File

@ -1,79 +1,85 @@
# gitzone ci_default
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
variables:
GIT_STRATEGY: clone
cache:
paths:
- .npmci_cache/
key: "$CI_BUILD_STAGE"
- .npmci_cache/
key: '$CI_BUILD_STAGE'
stages:
- security
- test
- release
- metadata
- security
- test
- release
- metadata
before_script:
- pnpm install -g pnpm
- pnpm install -g @shipzone/npmci
- npmci npm prepare
# ====================
# security stage
# ====================
mirror:
# ====================
# security stage
# ====================
auditProductionDependencies:
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
stage: security
script:
- npmci git mirror
- npmci command npm config set registry https://registry.npmjs.org
- npmci command pnpm audit --audit-level=high --prod
tags:
- docker
- notpriv
- lossless
- docker
allow_failure: true
snyk:
auditDevDependencies:
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
stage: security
script:
- npmci npm prepare
- npmci command npm install -g snyk
- npmci command npm install --ignore-scripts
- npmci command snyk test
- npmci command npm config set registry https://registry.npmjs.org
- npmci command pnpm audit --audit-level=high --dev
tags:
- docker
- notpriv
- lossless
- docker
allow_failure: true
# ====================
# test stage
# ====================
testLTS:
testStable:
stage: test
script:
- npmci npm prepare
- npmci node install lts
- npmci npm install
- npmci npm test
- npmci node install stable
- npmci npm install
- npmci npm test
coverage: /\d+.?\d+?\%\s*coverage/
tags:
- docker
- priv
- docker
testBuild:
stage: test
script:
- npmci npm prepare
- npmci node install lts
- npmci npm install
- npmci command npm run build
- npmci node install stable
- npmci npm install
- npmci command npm run build
coverage: /\d+.?\d+?\%\s*coverage/
tags:
- docker
- notpriv
- docker
release:
stage: release
script:
- npmci node install lts
- npmci npm publish
- npmci node install stable
- npmci npm publish
only:
- tags
- tags
tags:
- docker
- notpriv
- lossless
- docker
- notpriv
# ====================
# metadata stage
@ -81,35 +87,36 @@ release:
codequality:
stage: metadata
allow_failure: true
only:
- tags
script:
- npmci command npm install -g tslint typescript
- npmci command npm install -g typescript
- npmci npm prepare
- npmci npm install
- npmci command "tslint -c tslint.json ./ts/**/*.ts"
tags:
- docker
- priv
- lossless
- docker
- priv
trigger:
stage: metadata
script:
- npmci trigger
- npmci trigger
only:
- tags
- tags
tags:
- docker
- notpriv
- lossless
- docker
- notpriv
pages:
image: hosttoday/ht-docker-dbase:npmci
services:
- docker:18-dind
stage: metadata
script:
- npmci command npm install -g @gitzone/tsdoc
- npmci npm prepare
- npmci node install stable
- npmci npm install
- npmci command tsdoc
- npmci command npm run buildDocs
tags:
- lossless
- docker
- notpriv
only:
@ -117,5 +124,5 @@ pages:
artifacts:
expire_in: 1 week
paths:
- public
- public
allow_failure: true

24
.vscode/launch.json vendored
View File

@ -2,28 +2,10 @@
"version": "0.2.0",
"configurations": [
{
"name": "current file",
"type": "node",
"command": "npm test",
"name": "Run npm test",
"request": "launch",
"args": [
"${relativeFile}"
],
"runtimeArgs": ["-r", "@gitzone/tsrun"],
"cwd": "${workspaceRoot}",
"protocol": "inspector",
"internalConsoleOptions": "openOnSessionStart"
},
{
"name": "test.ts",
"type": "node",
"request": "launch",
"args": [
"test/test.ts"
],
"runtimeArgs": ["-r", "@gitzone/tsrun"],
"cwd": "${workspaceRoot}",
"protocol": "inspector",
"internalConsoleOptions": "openOnSessionStart"
"type": "node-terminal"
}
]
}

26
.vscode/settings.json vendored Normal file
View File

@ -0,0 +1,26 @@
{
"json.schemas": [
{
"fileMatch": ["/npmextra.json"],
"schema": {
"type": "object",
"properties": {
"npmci": {
"type": "object",
"description": "settings for npmci"
},
"gitzone": {
"type": "object",
"description": "settings for gitzone",
"properties": {
"projectType": {
"type": "string",
"enum": ["website", "element", "service", "npm", "wcc"]
}
}
}
}
}
}
]
}

View File

@ -1,17 +1,30 @@
{
"gitzone": {
"projectType": "npm",
"module": {
"githost": "gitlab.com",
"gitscope": "apiglobal",
"githost": "code.foss.global",
"gitscope": "api.global",
"gitrepo": "typedrequest-interfaces",
"shortDescription": "interfaces for making typed requests",
"npmPackagename": "@apiglobal/typedrequest-interfaces",
"description": "A library providing interfaces for making typed HTTP requests.",
"npmPackagename": "@api.global/typedrequest-interfaces",
"license": "MIT",
"projectDomain": "api.global"
"projectDomain": "api.global",
"keywords": [
"HTTP",
"requests",
"interfaces",
"TypeScript",
"streaming",
"API",
"virtual streams"
]
}
},
"npmci": {
"npmGlobalTools": [],
"npmAccessLevel": "public"
},
"tsdoc": {
"legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
}
}
}

1692
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@ -1,24 +1,48 @@
{
"name": "@apiglobal/typedrequest-interfaces",
"version": "1.0.5",
"name": "@api.global/typedrequest-interfaces",
"version": "3.0.19",
"private": false,
"description": "interfaces for making typed requests",
"main": "dist/index.js",
"typings": "dist/index.d.ts",
"description": "A library providing interfaces for making typed HTTP requests.",
"main": "dist_ts/index.js",
"typings": "dist_ts/index.d.ts",
"author": "Lossless GmbH",
"license": "MIT",
"scripts": {
"test": "(tstest test/)",
"build": "(tsbuild)",
"format": "(gitzone format)"
"format": "(gitzone format)",
"buildDocs": "tsdoc"
},
"devDependencies": {
"@gitzone/tsbuild": "^2.0.22",
"@gitzone/tstest": "^1.0.15",
"@pushrocks/tapbundle": "^3.0.7",
"@types/node": "^12.7.2",
"tslint": "^5.11.0",
"tslint-config-prettier": "^1.15.0"
"@gitzone/tsbuild": "^2.1.66",
"@gitzone/tsrun": "^1.2.44",
"@gitzone/tstest": "^1.0.77",
"@push.rocks/tapbundle": "^5.0.23",
"@types/node": "^20.12.8"
},
"dependencies": {}
"files": [
"ts/**/*",
"ts_web/**/*",
"dist/**/*",
"dist_*/**/*",
"dist_ts/**/*",
"dist_ts_web/**/*",
"assets/**/*",
"cli.js",
"npmextra.json",
"readme.md"
],
"type": "module",
"browserslist": [
"last 1 chrome versions"
],
"keywords": [
"HTTP",
"requests",
"interfaces",
"TypeScript",
"streaming",
"API",
"virtual streams"
]
}

5216
pnpm-lock.yaml generated Normal file

File diff suppressed because it is too large Load Diff

1
readme.hints.md Normal file
View File

@ -0,0 +1 @@

151
readme.md Normal file
View File

@ -0,0 +1,151 @@
# @api.global/typedrequest-interfaces
interfaces for making typed requests
## Install
To install `@api.global/typedrequest-interfaces`, you need to have Node.js installed on your system. You can then add this package to your project by running the following command in your terminal:
```bash
npm install @api.global/typedrequest-interfaces --save
```
This will add the package to your project's dependencies. Ensure you are in your project's directory or specify the path where your project is located.
## Usage
To use the `@api.global/typedrequest-interfaces` package in your TypeScript project, follow the steps below. This package provides interfaces for making typed requests, which can help enforce a structured request and response pattern in your applications.
### Setting Up Your Project
First, ensure your project is set up to use TypeScript and ESM (ECMAScript Modules). You will need a `tsconfig.json` file in your project root with at least the following settings:
```json
{
"compilerOptions": {
"target": "ESNext",
"module": "ESNext",
"moduleResolution": "node",
"outDir": "./dist",
"declaration": true,
"esModuleInterop": true,
"experimentalDecorators": true,
"forceConsistentCasingInFileNames": true
},
"include": ["src/**/*"]
}
```
Adjust the settings according to your project requirements. This configuration supports modern JavaScript features and TypeScript.
### Basic Implementation
To use the interfaces provided by the package, start by importing them into your TypeScript file. Below is an example demonstrating how to define a typed request using the interfaces:
```typescript
import { ITypedRequest, ITypedEvent, ITag, IVirtualStream, IStreamRequest } from '@api.global/typedrequest-interfaces';
// Example: Defining a typed request
interface MyCustomRequest extends ITypedRequest {
method: 'MyCustomMethod';
authInfo?: {
jwt: string;
};
request: {
someData: string;
};
response: {
resultData: number;
};
}
```
This snippet shows how to create a custom interface `MyCustomRequest` that implements the `ITypedRequest` interface from the package. You can specify the types for the request and response data to match your application's needs.
### Handling Typed Events
You can also define and use typed events similar to the following example:
```typescript
// Example: Defining a typed event
interface MyCustomEvent extends ITypedEvent<{ message: string }> {
name: 'MyCustomEvent';
uniqueEventId: 'Event123';
payload: {
message: 'Hello World';
};
}
```
### Utilizing Tags
Tags can be useful for attaching metadata or categorization information to your requests or events. Implementing a tag looks like this:
```typescript
// Example: Defining a tag
interface UserActionTag extends ITag {
name: 'UserAction';
payload: {
userId: number;
action: string;
};
}
```
### Virtual Streams
For more advanced use cases, like handling data streams, the `IVirtualStream` interface can be implemented as follows:
```typescript
// Example: Implementing a virtual stream
class MyStream implements IVirtualStream<Uint8Array> {
side = 'requesting';
streamId = 'myStream123';
sendMethod = async (data: Uint8Array) => { /* Implementation here */ };
// Implement other required methods...
}
```
### Working with Stream Requests
Stream requests allow for handling requests that involve streaming data. Here is how you can use the `IStreamRequest` interface:
```typescript
// Example: Using an IStreamRequest
const myStreamRequest: IStreamRequest = {
method: '##VirtualStream##',
request: {
streamId: 'myStream123',
cycleId: 'cycle456',
cycle: 'request',
mainPurpose: 'start'
// More properties here...
},
response: {
// Response structure here...
}
};
```
This setup demonstrates creating a request for initializing a virtual stream. Other `mainPurpose` values like 'chunk', 'read', 'end', and 'feedback' can also be used depending on the interaction with the stream.
The examples shown demonstrate the versatility of the `@api.global/typedrequest-interfaces` package in structuring your application's request-response mechanisms, event handling, tagging, and stream management. By following TypeScript and ESM conventions, you can leverage these interfaces to architect robust, typed APIs and services.
## License and Legal Information
This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.
**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
### Trademarks
This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
### Company Information
Task Venture Capital GmbH
Registered at District court Bremen HRB 35230 HB, Germany
For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

View File

@ -1,8 +1,18 @@
import { expect, tap } from '@pushrocks/tapbundle';
import * as typedrequestInterfaces from '../ts/index';
import { expect, tap } from '@push.rocks/tapbundle';
import * as typedrequestInterfaces from '../ts/index.js';
interface IRequestSample
extends typedrequestInterfaces.implementsTR<
typedrequestInterfaces.ITypedRequest,
IRequestSample
> {
method: 'hey';
request: {};
response: {};
}
tap.test('first test', async () => {
typedrequestInterfaces;
});
tap.start();

8
ts/00_commitinfo_data.ts Normal file
View File

@ -0,0 +1,8 @@
/**
* autocreated commitinfo by @pushrocks/commitinfo
*/
export const commitinfo = {
name: '@api.global/typedrequest-interfaces',
version: '3.0.19',
description: 'A library providing interfaces for making typed HTTP requests.'
}

View File

@ -1,7 +1,153 @@
import * as plugins from './typedrequest-interfaces.plugins';
export interface ITypedRequest {
/**
* the method that the request response data is meant for
*/
method: string;
/**
* any needed auth data
*/
authInfo?: {
jwt: string;
};
/**
* localData tracks things within typedrequest.
* needed for VirtualStreams
*/
localData?: {
firstTypedrouter?: any;
};
/**
* server data that is added for dealing with the request server side. Will be omitted when sending the response
*/
serverData?: {
jwtData: any;
jwtValid: boolean;
};
/**
* the request data
*/
request: object;
/**
* the response data
*/
response: object;
}
/**
* any error information that might be encountered while dealing with a request
*/
error?: { text: string; data: any };
/**
* retry information for smartly advising the client to retry at a later point in time
*/
retry?: {
waitForMs: number;
reason: string;
};
/**
* a correlation id that
* used for matching request and response
* !important. Don't remove.
*/
correlation?: {
id: string;
phase: 'request' | 'response';
};
}
export type implementsTR<T, U extends T> = {};
export interface ITypedEvent<T> {
name: string;
uniqueEventId: string;
payload: T;
}
export interface ITag {
name: string;
payload: any;
}
export type implementsTag<T, U extends T> = {};
// stream stuff
export interface IVirtualStream<T = Uint8Array> {
// Properties
side: 'requesting' | 'responding';
streamId: string;
sendMethod: any;
typedrouter: any;
// Methods
handleStreamTr(streamTrArg: IStreamRequest): Promise<IStreamRequest>;
cleanup(): Promise<void>;
sendData(dataArg: T): Promise<void>;
fetchData(): Promise<T>;
readFromWebstream(readableStreamArg: ReadableStream<T>): Promise<void>;
writeToWebstream(wwritableStreamArg: WritableStream<T>): Promise<void>; // Consider defining a more specific type for webStream if possible
}
export interface IUnifiedStreamDataPackage {
/**
* the stream id, so Virtual Streams can talk to each other
*/
streamId: string;
/**
* stream data is sent in cycles. This id is used to match the request and response
*/
cycleId: string;
cycle: 'request' | 'response';
/**
* the main purpose of the data package
* start: indicates the start of a stream
* chunk: indicates a binary chunk of data
* read: indicates the introduction to send data
* end: indicates the end of a stream
* feedback: indicates a feedback message
*/
mainPurpose: 'start' | 'chunk' | 'read' | 'end' | 'feedback' | 'keepAlive';
/**
* the data package
*/
chunkData?: any;
/**
* feedback message
*/
feedback?: {
message?: string;
data?: any;
sha265?: string;
};
/**
* keepAlive boolean
*/
keepAlive?: boolean;
/**
* is backpressure detected on the readable side?
*/
backpressure?: boolean;
/**
* does the writable side have more data scheduled to be sent?
*/
next?: boolean;
}
export interface IStreamRequest extends implementsTR<ITypedRequest, IStreamRequest> {
method: '##VirtualStream##';
request: IUnifiedStreamDataPackage;
response: IUnifiedStreamDataPackage;
}

View File

@ -1,4 +0,0 @@
const removeme = {};
export {
removeme
}

14
tsconfig.json Normal file
View File

@ -0,0 +1,14 @@
{
"compilerOptions": {
"experimentalDecorators": true,
"useDefineForClassFields": false,
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"esModuleInterop": true,
"verbatimModuleSyntax": true
},
"exclude": [
"dist_*/**/*.d.ts"
]
}

View File

@ -1,17 +0,0 @@
{
"extends": ["tslint:latest", "tslint-config-prettier"],
"rules": {
"semicolon": [true, "always"],
"no-console": false,
"ordered-imports": false,
"object-literal-sort-keys": false,
"member-ordering": {
"options":{
"order": [
"static-method"
]
}
}
},
"defaultSeverity": "warning"
}