@audc/rtpengine-client 0.5.2 → 0.5.4

package/README.md

@@ -51,7 +51,9 @@ client.on('listening', () => {
 ```
 
 ## Making requests
-The ng request verbs (`ping`, `offer`, `answer`, `delete`, `query`, `start recording`, `stop recording`, `block DTMF`, `unblock DTMF`, `block media`, `unblock media`) are available as methods on the `client` object.  The sytax for each is the same:
+The ng request verbs (`ping`, `offer`, `answer`, `delete`, `query`, `start recording`, `stop recording`,
+`pause recording`, `block DTMF`, `unblock DTMF`, `block media`, `unblock media`)
+are available as methods on the `client` object.  The sytax for each is the same:
 + the destination of the request comes first, either as `port, host` or `{port, host}`
 + following that, if any options are required for the request, those come next in an object.
 
@@ -68,6 +70,7 @@ Function names are as follows:
 |query             | query            |
 |start recording   | startRecording   |
 |stop recording    | stopRecording    |
+|pause recording   | pauseRecording   |
 |block DTMF        | blockDTMF        |
 |unblock DTMF      | unblockDTMF      |
 |play DTMF         | playDTMF         |
@@ -105,4 +108,4 @@ client.offer({port: 22222, host: '35.195.250.243}, {
   'call-id': ..
   'from-tag': ..
 }) // ...etc
-```
+```

package/index.d.ts

@@ -31,34 +31,326 @@ export interface InternalMessage {
   };
 }
 
-declare class CommandHandler extends EventEmitter {
-  answer(opts?: Record<string, unknown>): Promise<any>;
-  delete(opts?: Record<string, unknown>): Promise<any>;
-  list(opts?: Record<string, unknown>): Promise<any>;
-  offer(opts?: Record<string, unknown>): Promise<any>;
-  ping(opts?: Record<string, unknown>): Promise<any>;
-  query(opts?: Record<string, unknown>): Promise<any>;
-  startRecording(opts?: Record<string, unknown>): Promise<any>;
-  stopRecording(opts?: Record<string, unknown>): Promise<any>;
-  blockDTMF(opts?: Record<string, unknown>): Promise<any>;
-  unblockDTMF(opts?: Record<string, unknown>): Promise<any>;
-  playDTMF(opts?: Record<string, unknown>): Promise<any>;
-  blockMedia(opts?: Record<string, unknown>): Promise<any>;
-  unblockMedia(opts?: Record<string, unknown>): Promise<any>;
-  silenceMedia(opts?: Record<string, unknown>): Promise<any>;
-  unsilenceMedia(opts?: Record<string, unknown>): Promise<any>;
-  startForwarding(opts?: Record<string, unknown>): Promise<any>;
-  stopForwarding(opts?: Record<string, unknown>): Promise<any>;
-  playMedia(opts?: Record<string, unknown>): Promise<any>;
-  stopMedia(opts?: Record<string, unknown>): Promise<any>;
-  statistics(opts?: Record<string, unknown>): Promise<any>;
-  publish(opts?: Record<string, unknown>): Promise<any>;
-  subscribeRequest(opts?: Record<string, unknown>): Promise<any>;
-  subscribeAnswer(opts?: Record<string, unknown>): Promise<any>;
-  unsubscribe(opts?: Record<string, unknown>): Promise<any>;
-}
-
-declare class BaseClient extends CommandHandler {
+export interface HostAndPort {
+  host: string;
+  port: number;
+}
+
+// Basic common types that are reused across messages
+type NgBoolean = 'yes' | 'no' | 'on' | 'off';
+type StringList = string | string[];
+
+type MediaFlags = 'initialized' |
+  'asymmetric' |
+  'send' |
+  'recv' |
+  'rtcp-mux' |
+  'DTLS-SRTP' |
+  'DTLS role active' |
+  'DTLS role passive' |
+  'SDES' |
+  'passthrough' |
+  'ICE' |
+  'trickle ICE' |
+  'ICE controlling' |
+  'ICE-lite peer' |
+  'ICE-lite self' |
+  'unidirectional' |
+  'loop check' |
+  'generator/sink' |
+  'ptime-override' |
+  'RTCP feedback' |
+  'RTCP generator' |
+  'echo' |
+  'blackhole' |
+  'SDES reordered' |
+  'audio player' |
+  'legacy OSRTP' |
+  'reverse legacy OSRTP' |
+  'transcoding' |
+  'block egress';
+
+interface PingResult {
+  result: 'pong'
+}
+
+interface BaseArgs {
+  flags?: StringList;
+}
+
+export interface OfferArgs extends BaseArgs {
+  sdp: string;
+  'call-id': string;
+  'from-tag': string;
+  all?: 'none' | 'all' | 'offer-answer' | 'except-offer-answer' | 'flows';
+  'address family'?: 'IP4' | 'IP6';
+  'audio player'?: 'default' | 'transcoding' | 'off' | 'always';
+  'delay-buffer'?: number;
+  'direction'?: StringList;
+  digit?: 'string';
+  'drop-traffic'?: 'start' | 'stop';
+  DTLS?: 'off' | 'no' | 'disable' | 'passive' | 'active';
+  'DTLS-reverse'?: 'passive' | 'active';
+  'DTLS-fingerprint'?: 'SHA-1' | 'SHA-224' | 'SHA-256' | 'SHA-384' | 'SHA-512';
+  'DTMF-security'?: 'drop' | 'silence' | 'tone' | 'random' | 'zero' | 'off';
+  'DTMF-security-trigger'?: string;
+  'DTMF-security-trigger-end'?: string;
+  'DTMF-delay'?: number;
+  'DTMF-log-dest'?: string;
+  'endpoint-learning'?: 'off' | 'immediate' | 'delayed' | 'heuristic';
+  'from-interface'?: string;
+  'frequencies'?: number | number[];
+  'frequency'?: number | number[];
+  'from-tags'?: StringList;
+  'generate RTCP'?: 'on' | 'off';
+  'ICE'?: 'remove' | 'force' | 'default' | 'force-relay' | 'optional';
+  'ICE-lite'?: 'forward' | 'backward' | 'both' | 'off';
+  'interface'?: string;
+  'label'?: string;
+  'from-label'?: string;
+  'media address'?: string;
+  'media echo'?: 'blackhole' | 'sinkhole' | 'forward' | 'backwards' | 'both';
+  'media-echo'?: 'blackhole' | 'sinkhole' | 'forward' | 'backwards' | 'both';
+  'metadata'?: string;
+  'OSRTP'?: 'offer' | 'offer-RFC' | 'offer-legacy' | 'accept-RFC' | 'accept-legacy' | 'accept';
+  'output-destination'?: string;
+  'ptime'?: number;
+  'ptime-reverse'?: number;
+  'received from'?: ['IP4' | 'IP6', string];
+  'record call'?: 'yes' | 'no' | 'on' | 'off';
+  'rtcp-mux'?: ('offer' | 'require' | 'demux' | 'accept' | 'reject')[];
+  'SIP message type'?: 'SIP request' | 'SIP response';
+  'SIP code'?: number;
+  'template'?: string;
+  'via-branch'?: string;
+  'set-label'?: string;
+  'SDES'?: StringList;
+  'supports'?: StringList;
+  'to-interface'?: string;
+  'to-label'?: string;
+  'TOS'?: number;
+  'transport protocol'?: 'RTP/AVP' | 'RTP/AVPF' | 'RTP/SAVP' | 'RTP/SAVPF' | 'accept';
+  'trigger'?: string;
+  'trigger-end'?: string;
+  'end trigger'?: string;
+  'trigger-end-time'?: number;
+  'trigger-end-digits'?: number;
+  'T.38'?: ('decode' | 'force' | 'stop' | 'no-ECM' | 'no-V.17' | 'no-V.27ter' | 'no-V.29' | 'no-V.34' | 'no-IAF' | 'FEC')[];
+  volume?: number;
+  'xmlrpc-callback'?: string;
+  replace?: ('force-increment-sdp-ver' | 'origin' | 'origin-full' | 'session-name' | 'SDP-version' | 'username' | 'zero-address')[];
+  codec?: Record<string, unknown>;
+  'sdp-attr'?: Record<string, unknown>;
+  'sdp-media-remove'?: StringList;
+}
+
+// Answer specific parameters
+export interface AnswerArgs extends Omit<OfferArgs, 'direction'> {
+  'to-tag'?: string;
+}
+
+interface BaseResponse {
+  result: 'ok' | 'error' | 'load limit';
+}
+
+export interface OfferResponse extends BaseResponse {
+  sdp: string;
+}
+
+// Delete parameters (as you provided)
+export interface DeleteArgs extends BaseArgs {
+  'call-id': string;
+  'from-tag': string;
+  'to-tag'?: string;
+  'via-branch'?: string;
+  fatal?: boolean;
+  'delete-delay'?: number;
+}
+
+// Query parameters
+export interface QueryArgs extends BaseArgs {
+  'call-id': string;
+  'from-tag'?: string;
+  'to-tag'?: string;
+}
+
+interface StreamEndpoint {
+  family: 'IPv4' | 'IPv6';
+  address: string;
+  port: number;
+}
+
+type StreamFlag = 'RTP' |
+  'RTCP' |
+  'fallback RTCP' |
+  'filled' |
+  'confirmed' |
+  'kernelized' |
+  'no kernel support' |
+  'DTLS fingerprint verified' |
+  'strict source address' |
+  'media handover' |
+  'ICE';
+
+interface CallStats {
+  created: number;
+  tag: string;
+  label: string;
+  'in dialogue with': string;
+  medias: {
+    index: number;
+    type: string;
+    protocol?: string;
+    flags: MediaFlags[];
+    streams: {
+      'local port'?: number;
+      'local address'?: string;
+      family?: string;
+      endpoint?: StreamEndpoint;
+      'advertised endpoint'?: StreamEndpoint;
+      'crypto suite'?: 'string';
+      'last packet': number;
+      'last kernel packet': number;
+      'last user packet': number;
+      flags: StreamFlag[];
+      stats: {
+        bytes: number;
+        packets: number;
+        errors: number;
+      }
+    }[]
+  }[]
+}
+
+export interface QueryResponse extends BaseResponse {
+  created: number;
+  'last signal': number;
+  tags: Record<string, CallStats>;
+}
+
+// List parameters
+export interface ListArgs {
+  limit?: number;
+  'call-id'?: string;
+}
+
+export interface ListResponse extends BaseResponse {
+  calls: string[];
+}
+
+export interface StopRecordingArgs extends BaseArgs {
+  'call-id': string;
+  'from-tag'?: string;
+  'to-tag'?: string;
+  'via-branch'?: string;
+  metadata?: string;
+}
+
+// Start recording parameters
+export interface StartRecordingArgs extends StopRecordingArgs {
+  'recording-file'?: string;
+  'recording-dir'?: string;
+  'recording-pattern'?: string;
+}
+
+export interface MediaOpArgs extends BaseArgs {
+  'call-id': string;
+  'from-tag'?: string;
+  address?: string;
+  label?: string;
+}
+
+// Play Media parameters
+export interface PlayMediaArgs extends MediaOpArgs {
+  file?: string;
+  blob?: string;
+  'db-id'?: number;
+  'repeat-times'?: number;
+  'repeat-duration'?: number;
+  'start-pos'?: number;
+}
+
+export interface PlayMediaResponse extends BaseResponse {
+  duration?: number;
+}
+
+// Stop Media parameters
+export interface StopMediaResponse extends BaseResponse {
+  'last-frame-pos': number;
+}
+
+type DTMFDigit = number | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' |
+  '*' | '#' | 'A' | 'B' | 'C' | 'D';
+
+export interface PlayDTMFArgs extends MediaOpArgs {
+  code?: DTMFDigit;
+  digit?: DTMFDigit;
+  duration?: number;
+  volume?: number;
+  pause?: number;
+}
+
+export interface StatisticsResponse extends BaseResponse {
+  statistics: Record<string, unknown>;
+}
+
+type MediaMode = 'sendrecv' | 'sendonly' | 'recvonly' | 'inactive';
+
+interface TagLabel {
+  tag: string;
+  index: number;
+  type: string;
+  label?: string;
+  mode: MediaMode;
+}
+
+interface SubscribeRequest {
+  sdp: string;
+  'from-tag'?: string;
+  'to-tag': string;
+  'from-tags'?: string[];
+  'tag-medias'?: Record<string, unknown>[];
+  'tag-labels'?: Record<string, TagLabel>;
+}
+
+export type SubscribeRequestResponse = SubscribeRequest & BaseResponse;
+export type SubscribeAnswerArgs = SubscribeRequest & BaseArgs;
+
+export interface UnsubscribeArgs extends BaseArgs {
+  'call-id': string;
+  'to-tag': string;
+}
+
+// Generic base class with a fixed optional `opts` argument
+declare class CommandHandler<Args extends unknown[]> extends EventEmitter {
+  answer(...args: [...Args, opts: AnswerArgs]): Promise<OfferResponse>;
+  delete(...args: [...Args, opts: DeleteArgs]): Promise<QueryResponse>;
+  list(...args: [...Args, opts?: ListArgs]): Promise<ListResponse>;
+  offer(...args: [...Args, opts: OfferArgs]): Promise<OfferResponse>;
+  ping(...args: [...Args]): Promise<PingResult>;
+  query(...args: [...Args, opts: QueryArgs]): Promise<QueryResponse>;
+  startRecording(...args: [...Args, opts: StartRecordingArgs]): Promise<BaseResponse>;
+  stopRecording(...args: [...Args, opts: StopRecordingArgs]): Promise<BaseResponse>;
+  pauseRecording(...args: [...Args, opts: StopRecordingArgs]): Promise<BaseResponse>;
+  blockDTMF(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  unblockDTMF(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  blockMedia(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  unblockMedia(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  silenceMedia(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  unsilenceMedia(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  startForwarding(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  stopForwarding(...args: [...Args, opts: MediaOpArgs]): Promise<BaseResponse>;
+  playMedia(...args: [...Args, opts: PlayMediaArgs]): Promise<PlayMediaResponse>;
+  stopMedia(...args: [...Args, opts: MediaOpArgs]): Promise<StopMediaResponse>;
+  playDTMF(...args: [...Args, opts: PlayDTMFArgs]): Promise<BaseResponse>;
+  statistics(...args: [...Args]): Promise<StatisticsResponse>;
+  publish(...args: [...Args, opts: OfferArgs]): Promise<OfferResponse>;
+  subscribeRequest(...args: [...Args, opts: MediaOpArgs]): Promise<SubscribeRequestResponse>;
+  subscribeAnswer(...args: [...Args, opts: SubscribeAnswerArgs]): Promise<BaseResponse>;
+  unsubscribe(...args: [...Args, opts: UnsubscribeArgs]): Promise<BaseResponse>;
+}
+
+declare class BaseClient<Args extends unknown[] = []> extends CommandHandler<Args> {
   messages: Map<string, (err?: any) => void>;
 
   constructor(options: BaseClientOptions);
@@ -68,7 +360,7 @@ declare class BaseClient extends CommandHandler {
   static encodeMessage(id: string, data: any): string;
 }
 
-export class Client extends BaseClient {
+export class Client extends BaseClient<[remote: HostAndPort] | [port: number, host: string]> {
   constructor(options: ClientOptions);
   constructor(port?: number, host?: string);
   declare socket: UdpSocket;

package/lib/constants.js

@@ -7,6 +7,7 @@ const _commands = {
   'query': 'query',
   'startRecording': 'start recording',
   'stopRecording': 'stop recording',
+  'pauseRecording': 'pause recording',
   'blockDTMF': 'block DTMF',
   'unblockDTMF': 'unblock DTMF',
   'playDTMF': 'play DTMF',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audc/rtpengine-client",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "node client for rtpengine daemon",
   "main": "index.js",
   "scripts": {
@@ -16,28 +16,28 @@
     "lib/"
   ],
   "devDependencies": {
-    "@eslint/js": "^9.18.0",
+    "@eslint/js": "^9.39.2",
     "@types/bencode": "^2.0.4",
     "@types/tape": "^5.8.1",
-    "@types/ws": "^8.5.13",
+    "@types/ws": "^8.18.1",
     "c8": "^10.1.3",
-    "debug": "^4.4.0",
-    "eslint": "^9.18.0",
+    "debug": "^4.4.3",
+    "eslint": "^9.39.2",
     "eslint-plugin-promise": "^7.2.1",
-    "globals": "^15.14.0",
-    "sinon": "^19.0.2",
+    "globals": "^17.0.0",
+    "sinon": "^21.0.1",
     "tape": "^5.9.0"
   },
   "dependencies": {
     "bencode": "^2.0.3",
     "uuid-random": "^1.3.2",
-    "ws": "^8.18.0"
+    "ws": "^8.19.0"
   },
   "keywords": [
     "rtpengine"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/davehorton/rtpengine-client"
+    "url": "https://github.com/audiocodes/rtpengine-client"
   }
 }