@skyramp/skyramp 0.4.32 → 0.4.35

package/README.md

@@ -1,17 +1,17 @@
 # skyramp
 
-`skyramp` is an npm module that provides utility functions for leveraging [skyramp CLI](https://skyramp.dev/docs/commands/skyramp/) commands. The `skyramp` module provides functionalities to create and apply mock configurations for both gRPC and REST APIs. It also offers features for testing and asserting scenarios in various test environments. The module exports the following classes: `RestEndpoint`, `GrpcEndpoint`, `Scenario`, and `SkyrampClient`.
+`skyramp` is an npm module that provides utility functions for leveraging [skyramp CLI](https://skyramp.dev/docs/reference/cli-commands/) commands. The `skyramp` module provides functionalities to create and apply mock configurations for both gRPC and REST APIs. It also offers features for testing and asserting scenarios in various test environments. The module exports the following classes: `RestEndpoint`, `GrpcEndpoint`, `Scenario`, and `SkyrampClient`.
 
 ## Installation
 To install Skyramp, simply run the following command in your terminal:
 ```bash
-npm install skyramp
+npm install @skyramp/skyramp
 ```
 
 ## Usage
 Once you've installed Skyramp, you can import it into your project like this:
 
-```bash
+```javascript
 const { GrpcEndpoint, RestEndpoint, SkyrampClient, Scenario } = require('skyramp');
 ```
 
@@ -19,7 +19,7 @@ const { GrpcEndpoint, RestEndpoint, SkyrampClient, Scenario } = require('skyramp
 The `SkyrampClient` class is the main entry point to interact with the skyramp module. It allows you to apply configurations, start test scenarios, and deploy and delete workers. First, you must set up the `SkyrampClient` with a kubernetes cluster.
 
 **Example: Provision Local Cluster with Skyramp**
-```bash
+```javascript
 const skyrampClient = new SkyrampClient();
 skyrampClient.applyLocal().then(function() {
   // Local cluster provisioned
@@ -28,8 +28,9 @@ skyrampClient.applyLocal().then(function() {
 });
 ```
 Once you have a `SkyrampClient` instance configured with a kubernetes cluster, you can deploy the Skyramp Worker in-cluster, for applying mocks and running tests.
+
 **Example: Deploy Skyramp Worker**
-```bash
+```javascript
 skyrampClient.deployWorker('my-namespace').then(function() {
   // Worker deployed successfully
 }).catch(function(error) {
@@ -41,10 +42,10 @@ skyrampClient.deployWorker('my-namespace').then(function() {
 The `RestEndpoint` class represents a REST API endpoint and provides methods to configure mock responses to apply them to the `SkyrampClient`.
 
 **Example: Create REST Mock Configuration**
-```bash
+```javascript
 restEndpoint = new RestEndpoint('artists', 'artists-GET', 50050, 'api/openapi/artists.yaml');
 restEndpoint.mockMethodFromFile('artists-GET', 'files/rest-values.yaml');
-skyrampClient.mockerApply('my-namespace', restEndpoint).then(function() {
+skyrampClient.mockerApply('my-namespace', '', restEndpoint).then(function() {
   // Mock applied successfully
 }).catch(function(error) {
   // Error occurred during mock application
@@ -55,10 +56,10 @@ skyrampClient.mockerApply('my-namespace', restEndpoint).then(function() {
 The `GrpcEndpoint` class represents a gRPC API endpoint and provides methods to configure mock responses to apply them to the `SkyrampClient`.
 
 **Example: Create gRPC Mock Configuration**
-```bash
+```javascript
 grpcEndpoint = new GrpcEndpoint('routeguide', 'RouteGuide', 50051, 'api/pb/routeguide.proto');
 grpcEndpoint.mockMethodFromFile('GetFeature', 'files/grpc-response.yaml');
-skyrampClient.mockerApply('my-namespace', grpcEndpoint).then(function() {
+skyrampClient.mockerApply('my-namespace', '', grpcEndpoint).then(function() {
   // Mock applied successfully
 }).catch(function(error) {
   // Error occurred during mock application
@@ -69,11 +70,11 @@ skyrampClient.mockerApply('my-namespace', grpcEndpoint).then(function() {
 The `Scenario` class allows you to define test scenarios by specifying a series of API requests and assertions to be made. Once a `Scenario` is created, you can start it using the `SkyrampClient` instance.
 
 **Example: Test Assert Scenario (REST)**
-```bash
+```javascript
 scenario = new Scenario('rest-test')
 step1 = scenario.addRequest(restEndpoint, 'artists-GET');
 step2 = scenario.addAssertEqual(`${step1}.res.items[0].artist_name`, 'abc');
-skyrampClient.testerStart('test-worker', scenario).then(function() {
+skyrampClient.testerStart('test-worker', '', scenario).then(function() {
   // Test scenario started
 }).catch(function(error) {
   // Error occurred during the test scenario
@@ -81,13 +82,13 @@ skyrampClient.testerStart('test-worker', scenario).then(function() {
 ```
 
 **Example: Test Assert Scenario (gRPC)**
-```bash
+```javascript
 scenario = new Scenario('routeguide-assert-test')
 step1 = scenario.addRequestFromFile(grpcEndpoint, 'GetFeature', 'files/grpc-request.yaml');
 step2 = scenario.addAssertEqual(`${step1}.res.name`, 'test-feature');
-skyrampClient.testerStart('test-worker', scenario).then(function() {
+skyrampClient.testerStart('test-worker', '', scenario).then(function() {
   // Test scenario started
 }).catch(function(error) {
   // Error occurred during the test scenario
 });
-```
+```

package/lib/dev-darwin-amd64.h

@@ -0,0 +1,118 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package github.com/letsramp/dev/cmd/libs */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 7 "client.go"
+
+struct oauthresponse {
+    char *emails[10];    // for the time being, it is a bit tricky to deal with dynamic array with koffi
+    int   num_emails;
+    char *token;
+    char *error;
+};
+
+struct credential_response {
+    char *email;
+    char *user_token;
+    char *provider;
+    char *error;
+};
+
+#line 1 "cgo-generated-wrapper"
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* removeLocalWrapper();
+extern char* removeClusterFromConfigWrapper(char* clusterName);
+extern char* getKubeConfigPath();
+extern char* applyLocalWrapper(char* token);
+extern char* addKubeconfigWrapper(char* context, char* clusterName, char* kubeconfigPath);
+extern char* deploySkyrampWorkerWrapper(char* namespace, char* workerImage, GoUint8 localImage);
+extern char* deleteSkyrampWorkerWrapper(char* namespace);
+extern struct credential_response readCredentialWrapper();
+extern char* getOAuthURLWrapper(char* provider, GoInt port);
+extern char* registerUserWrapper(char* provider, char* email, char* code);
+extern struct oauthresponse runOAuthLoopback(char* provider, GoInt port);
+extern char* validateTokenWrapper(char* userToken);
+extern char* generateUserTokenWrapper(char* provider, char* email, char* oauthToken);
+extern char* newGrpcEndpointWrapper(char* name, char* serviceName, GoInt port, char* inputFile);
+extern char* newRestEndpointWrapper(char* name, char* openApiTag, GoInt port, char* inputFile);
+extern char* writeMockDescriptionWrapper(char* mockDescription, char* kubernetesService);
+extern char* writeTestDescriptionWrapper(char* testDescription, char* testName);
+extern char* applyMockDescriptionWrapper(char* namespace, char* address, char* mockDescription);
+extern char* buildRequestsWrapper(char* mockDescription);
+extern char* runTesterStartWrapper(char* namespace, char* address, char* testDescription, GoUint8 generateResult);
+
+#ifdef __cplusplus
+}
+#endif

package/lib/dev-darwin-arm64.h

@@ -0,0 +1,118 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package github.com/letsramp/dev/cmd/libs */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 7 "client.go"
+
+struct oauthresponse {
+    char *emails[10];    // for the time being, it is a bit tricky to deal with dynamic array with koffi
+    int   num_emails;
+    char *token;
+    char *error;
+};
+
+struct credential_response {
+    char *email;
+    char *user_token;
+    char *provider;
+    char *error;
+};
+
+#line 1 "cgo-generated-wrapper"
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* removeLocalWrapper();
+extern char* removeClusterFromConfigWrapper(char* clusterName);
+extern char* getKubeConfigPath();
+extern char* applyLocalWrapper(char* token);
+extern char* addKubeconfigWrapper(char* context, char* clusterName, char* kubeconfigPath);
+extern char* deploySkyrampWorkerWrapper(char* namespace, char* workerImage, GoUint8 localImage);
+extern char* deleteSkyrampWorkerWrapper(char* namespace);
+extern struct credential_response readCredentialWrapper();
+extern char* getOAuthURLWrapper(char* provider, GoInt port);
+extern char* registerUserWrapper(char* provider, char* email, char* code);
+extern struct oauthresponse runOAuthLoopback(char* provider, GoInt port);
+extern char* validateTokenWrapper(char* userToken);
+extern char* generateUserTokenWrapper(char* provider, char* email, char* oauthToken);
+extern char* newGrpcEndpointWrapper(char* name, char* serviceName, GoInt port, char* inputFile);
+extern char* newRestEndpointWrapper(char* name, char* openApiTag, GoInt port, char* inputFile);
+extern char* writeMockDescriptionWrapper(char* mockDescription, char* kubernetesService);
+extern char* writeTestDescriptionWrapper(char* testDescription, char* testName);
+extern char* applyMockDescriptionWrapper(char* namespace, char* address, char* mockDescription);
+extern char* buildRequestsWrapper(char* mockDescription);
+extern char* runTesterStartWrapper(char* namespace, char* address, char* testDescription, GoUint8 generateResult);
+
+#ifdef __cplusplus
+}
+#endif

package/lib/dev-linux-386.h

@@ -0,0 +1,118 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package github.com/letsramp/dev/cmd/libs */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 7 "client.go"
+
+struct oauthresponse {
+    char *emails[10];    // for the time being, it is a bit tricky to deal with dynamic array with koffi
+    int   num_emails;
+    char *token;
+    char *error;
+};
+
+struct credential_response {
+    char *email;
+    char *user_token;
+    char *provider;
+    char *error;
+};
+
+#line 1 "cgo-generated-wrapper"
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt32 GoInt;
+typedef GoUint32 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_32_bit_pointer_matching_GoInt[sizeof(void*)==32/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* removeLocalWrapper();
+extern char* removeClusterFromConfigWrapper(char* clusterName);
+extern char* getKubeConfigPath();
+extern char* applyLocalWrapper(char* token);
+extern char* addKubeconfigWrapper(char* context, char* clusterName, char* kubeconfigPath);
+extern char* deploySkyrampWorkerWrapper(char* namespace, char* workerImage, GoUint8 localImage);
+extern char* deleteSkyrampWorkerWrapper(char* namespace);
+extern struct credential_response readCredentialWrapper();
+extern char* getOAuthURLWrapper(char* provider, GoInt port);
+extern char* registerUserWrapper(char* provider, char* email, char* code);
+extern struct oauthresponse runOAuthLoopback(char* provider, GoInt port);
+extern char* validateTokenWrapper(char* userToken);
+extern char* generateUserTokenWrapper(char* provider, char* email, char* oauthToken);
+extern char* newGrpcEndpointWrapper(char* name, char* serviceName, GoInt port, char* inputFile);
+extern char* newRestEndpointWrapper(char* name, char* openApiTag, GoInt port, char* inputFile);
+extern char* writeMockDescriptionWrapper(char* mockDescription, char* kubernetesService);
+extern char* writeTestDescriptionWrapper(char* testDescription, char* testName);
+extern char* applyMockDescriptionWrapper(char* namespace, char* address, char* mockDescription);
+extern char* buildRequestsWrapper(char* mockDescription);
+extern char* runTesterStartWrapper(char* namespace, char* address, char* testDescription, GoUint8 generateResult);
+
+#ifdef __cplusplus
+}
+#endif

package/lib/dev-linux-amd64.h

@@ -0,0 +1,118 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package github.com/letsramp/dev/cmd/libs */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 7 "client.go"
+
+struct oauthresponse {
+    char *emails[10];    // for the time being, it is a bit tricky to deal with dynamic array with koffi
+    int   num_emails;
+    char *token;
+    char *error;
+};
+
+struct credential_response {
+    char *email;
+    char *user_token;
+    char *provider;
+    char *error;
+};
+
+#line 1 "cgo-generated-wrapper"
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* removeLocalWrapper();
+extern char* removeClusterFromConfigWrapper(char* clusterName);
+extern char* getKubeConfigPath();
+extern char* applyLocalWrapper(char* token);
+extern char* addKubeconfigWrapper(char* context, char* clusterName, char* kubeconfigPath);
+extern char* deploySkyrampWorkerWrapper(char* namespace, char* workerImage, GoUint8 localImage);
+extern char* deleteSkyrampWorkerWrapper(char* namespace);
+extern struct credential_response readCredentialWrapper();
+extern char* getOAuthURLWrapper(char* provider, GoInt port);
+extern char* registerUserWrapper(char* provider, char* email, char* code);
+extern struct oauthresponse runOAuthLoopback(char* provider, GoInt port);
+extern char* validateTokenWrapper(char* userToken);
+extern char* generateUserTokenWrapper(char* provider, char* email, char* oauthToken);
+extern char* newGrpcEndpointWrapper(char* name, char* serviceName, GoInt port, char* inputFile);
+extern char* newRestEndpointWrapper(char* name, char* openApiTag, GoInt port, char* inputFile);
+extern char* writeMockDescriptionWrapper(char* mockDescription, char* kubernetesService);
+extern char* writeTestDescriptionWrapper(char* testDescription, char* testName);
+extern char* applyMockDescriptionWrapper(char* namespace, char* address, char* mockDescription);
+extern char* buildRequestsWrapper(char* mockDescription);
+extern char* runTesterStartWrapper(char* namespace, char* address, char* testDescription, GoUint8 generateResult);
+
+#ifdef __cplusplus
+}
+#endif

package/lib/dev-windows-amd64.h

@@ -0,0 +1,118 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package github.com/letsramp/dev/cmd/libs */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+#line 7 "client.go"
+
+struct oauthresponse {
+    char *emails[10];    // for the time being, it is a bit tricky to deal with dynamic array with koffi
+    int   num_emails;
+    char *token;
+    char *error;
+};
+
+struct credential_response {
+    char *email;
+    char *user_token;
+    char *provider;
+    char *error;
+};
+
+#line 1 "cgo-generated-wrapper"
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern __declspec(dllexport) char* removeLocalWrapper();
+extern __declspec(dllexport) char* removeClusterFromConfigWrapper(char* clusterName);
+extern __declspec(dllexport) char* getKubeConfigPath();
+extern __declspec(dllexport) char* applyLocalWrapper(char* token);
+extern __declspec(dllexport) char* addKubeconfigWrapper(char* context, char* clusterName, char* kubeconfigPath);
+extern __declspec(dllexport) char* deploySkyrampWorkerWrapper(char* namespace, char* workerImage, GoUint8 localImage);
+extern __declspec(dllexport) char* deleteSkyrampWorkerWrapper(char* namespace);
+extern __declspec(dllexport) struct credential_response readCredentialWrapper();
+extern __declspec(dllexport) char* getOAuthURLWrapper(char* provider, GoInt port);
+extern __declspec(dllexport) char* registerUserWrapper(char* provider, char* email, char* code);
+extern __declspec(dllexport) struct oauthresponse runOAuthLoopback(char* provider, GoInt port);
+extern __declspec(dllexport) char* validateTokenWrapper(char* userToken);
+extern __declspec(dllexport) char* generateUserTokenWrapper(char* provider, char* email, char* oauthToken);
+extern __declspec(dllexport) char* newGrpcEndpointWrapper(char* name, char* serviceName, GoInt port, char* inputFile);
+extern __declspec(dllexport) char* newRestEndpointWrapper(char* name, char* openApiTag, GoInt port, char* inputFile);
+extern __declspec(dllexport) char* writeMockDescriptionWrapper(char* mockDescription, char* kubernetesService);
+extern __declspec(dllexport) char* writeTestDescriptionWrapper(char* testDescription, char* testName);
+extern __declspec(dllexport) char* applyMockDescriptionWrapper(char* namespace, char* address, char* mockDescription);
+extern __declspec(dllexport) char* buildRequestsWrapper(char* mockDescription);
+extern __declspec(dllexport) char* runTesterStartWrapper(char* namespace, char* address, char* testDescription, GoUint8 generateResult);
+
+#ifdef __cplusplus
+}
+#endif

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyramp/skyramp",
-  "version": "0.4.32",
+  "version": "0.4.35",
   "description": "module for leveraging skyramp cli functionality",
   "scripts": {
     "pack": "npm pack"

package/src/classes/SkyrampClient.d.ts

@@ -1,12 +1,11 @@
 import { Endpoint } from './Endpoint';
 import { Scenario } from './Scenario';
 export declare class SkyrampClient {
-  constructor(kubeconfigPath?: string, clusterName?: string, context?: string);
+  constructor(kubeconfigPath?: string, clusterName?: string, context?: string, userToken?: string);
   applyLocal(): Promise<void>;
   addKubeconfig(context: string, clusterName: string, kubeconfigPath: string): Promise<void>;
-  removeCluster(clusterName?: string): Promise<void>;
   removeLocal(): Promise<void>;
-  removeClusterFromConfig(clusterName: string): Promise<void>;
+  removeCluster(clusterName?: string): Promise<void>;
   mockerApply(namespace: string, address: string, endpoint: Endpoint): Promise<void>;
 
   mockerApplyFromFile(namespace: string, address: string, filePath: string): Promise<void>;
@@ -14,4 +13,19 @@ export declare class SkyrampClient {
   testerStart(namespace: string, address: string, scenario: Scenario): Promise<void>;
   testerStartFromFile(namespace: string, address: string, filePath: string): Promise<void>;
   runTesterStart(namespace: string, address: string, testYamlContent: string, generateReport: boolean): Promise<void>;
+
+  // login / oauth related
+  userEmail: string;
+  userToken: string;
+  userProvider: string;
+  getUserToken(): string;
+  getUserEmail(): string;
+  getUserProvider(): string;
+
+  setUserToken(userToken: string): void;
+  validateToken(userToken: string): Promise<any>;
+  readCredential(): Promise<any>;
+  getOAuthURL(provider: string, port: number): string;
+  runOAuthLoopback(provider: string, port: number): Promise<any>;
+  registerUser(provider: string, email: string, oauthToken: string): Promise<string>;
 }

package/src/classes/SkyrampClient.js

@@ -1,6 +1,22 @@
 const lib = require('../lib');
+const koffi = require('koffi');
+
+const oauthResponseType = koffi.struct({
+    emails:     koffi.array('char*', 10),
+    num_emails: 'int',
+    token:      'char*',
+    error:      'char*'
+});
+
+const credResponseType = koffi.struct({
+    email:      'char*',
+    user_token: 'char*',
+    provider:   'char*',
+    error:      'char*',
+});
+
 const { createTestDescriptionFromScenario, getYamlBytes, readDataFromFile } = require('../utils');
-const applyLocalWrapper = lib.func('applyLocalWrapper', 'string', []);
+const applyLocalWrapper = lib.func('applyLocalWrapper', 'string', ['string']);
 const addKubeconfigWrapper = lib.func('addKubeconfigWrapper', 'string', ['string', 'bool', 'string', 'string']);
 const deleteSkyrampWorkerWrapper = lib.func('deleteSkyrampWorkerWrapper', 'string', ['string'])
 const deploySkyrampWorkerWrapper = lib.func('deploySkyrampWorkerWrapper', 'string', ['string', 'string', 'bool']);
@@ -10,17 +26,108 @@ const removeClusterFromConfigWrapper = lib.func('removeClusterFromConfigWrapper'
 const runTesterStartWrapper = lib.func('runTesterStartWrapper', 'string', ['string', 'string', 'string', 'bool']);
 const applyMockDescriptionWrapper = lib.func('applyMockDescriptionWrapper', 'string', ['string', 'string', 'string']);
 
+// credential / oauth related
+const readCredentialWrapper = lib.func('readCredentialWrapper', credResponseType, []);
+const validateTokenWrapper = lib.func('validateTokenWrapper', 'string', ['string']);
+const registerUserWrapper = lib.func('registerUserWrapper', 'string', ['string', 'string', 'string']);
+const getOAuthURL = lib.func('getOAuthURLWrapper', 'string', ['string', 'int']);
+const runOAuthLoopback = lib.func('runOAuthLoopback', oauthResponseType, ['string', 'int']);
+
 class SkyrampClient {
-  constructor(kubeconfigPath, clusterName, context) {
-    this.workerNamespaces = [];
+  constructor(kubeconfigPath, clusterName, context, userToken) {
     if (kubeconfigPath || clusterName || context) {
       this.addKubeconfig(clusterName, context, kubeconfigPath);
     }
+    this.workerNamespaces = [];
+    this.userToken = userToken;
+  }
+
+  setUserToken(userToken) {
+    this.userToken = userToken;
+  }
+
+  getOAuthURL(provider, port) {
+    return getOAuthURL(provider, port);
+  }
+
+  getUserEmail() {
+    return this.userEmail;
+  }
+
+  getUserToken() {
+    return this.userToken;
+  }
+
+  getUserProvider() {
+    return this.userProvider;
+  }
+
+  async readCredential() {
+    return new Promise((resolve, reject) => {
+      readCredentialWrapper.async((err, res) => {
+        if (err) {
+          reject(err);
+        } else if (res) {
+          if (res.error != null) {
+            reject(res.error);
+          } else {
+            this.userToken = res.user_token;
+            this.userEmail = res.email;
+            this.userProvider = res.provider;
+            resolve(res);
+          }
+        } else {
+          reject(new Error('failed to read credential'));
+        }
+      });
+    });
+  }
+
+  async runOAuthLoopback(provider, port) {
+    return new Promise((resolve, reject) => {
+      runOAuthLoopback.async(provider, port, (err, res) => {
+        if (err) {
+          reject(err);
+        } else if (res) {
+          resolve(res);
+        } else {
+          reject(new Error("failed to get oauth token"));
+        }
+      });
+    });
+  }
+
+  async validateToken(userToken) {
+    return new Promise((resolve, reject) => {
+      validateTokenWrapper.async(userToken, (err, res) => {
+        if (err) {
+          reject(err);
+        } else if (res) {
+          resolve(new Error(res));
+        } else {
+          resolve();
+        }
+      });
+    });
+  }
+
+  async registerUser(provider, email, oauthToken) {
+    return new Promise((resolve, reject) => {
+      registerUserWrapper.async(provider, email, oauthToken, (err, res) => {
+        if (err) {
+          reject(err);
+        } else if (res) {
+          reject(new Error(res));
+        } else {
+          resolve();
+        }
+      });
+    });
   }
 
   async applyLocal() {
     return new Promise((resolve, reject) => {
-      applyLocalWrapper.async((err, res) => {
+      applyLocalWrapper.async(this.userToken, (err, res) => {
         if (err) {
           reject(err);
         } else if (res) {
@@ -28,9 +135,9 @@ class SkyrampClient {
         } else {
           this.kubeConfigPath = getKubeConfigPath();
           if (this.kubeConfigPath == "") {
-              reject(new Error("no kubeconfig found"));
+            reject(new Error("no kubeconfig found"));
           } else {
-              resolve();
+            resolve();
           }
         }
       });
@@ -52,14 +159,6 @@ class SkyrampClient {
     });
   }
 
-  async removeCluster(clusterName) {
-    if (clusterName) {
-      return this.removeClusterFromConfig(clusterName);
-    } else {
-      return this.removeLocal();
-    }
-  }
-
   async removeLocal() {
     return new Promise((resolve, reject) => {
       removeLocalWrapper.async((err, res) => {
@@ -74,7 +173,7 @@ class SkyrampClient {
     });
   }
 
-  async removeClusterFromConfig(clusterName) {
+  async removeCluster(clusterName) {
     return new Promise((resolve, reject) => {
       removeClusterFromConfigWrapper.async(clusterName, (err, res) => {
         if (err) {

package/src/lib.js

@@ -27,4 +27,4 @@ if (!libPath) {
 const libFullPath = path.join(__dirname, '..', 'lib', libPath);
 const lib = koffi.load(libFullPath);
 
-module.exports = lib;
+module.exports = lib;