initial commit of typescript beta

Author: Ian-Montgomery-Klaviyo

.gitignore

@@ -0,0 +1,7 @@
+wwwroot/*.js
+node_modules
+typings
+dist
+.idea/
+.openapi-generator
+sample/dist

.npmignore

@@ -0,0 +1 @@
+# empty npmignore to ensure all required files (e.g., in the dist folder) are published by npm

CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+## [5.0.0-beta.1] - revision 2023-07-15
+### Added
+ - Types - This is a complete rework of our node sdk to add native type support in package
+ - ConfigWrapper is now optional
+   - Pass your api key and optional retry data directly into API objects `new campaignsApi("<YOUR API KEY HERE>")`
+ - Optional `Klaviyo` scope 
+   - Instead of accessing items apis like `new campaignsApi()` you can also use `new Klaviyo.campaignsApi()` to keep your application organized.

CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Contributing 
+
+### SDK creation process
+
+This repo is created by a two-step process: first, an OpenAPI Specification (OAS) is generated from the Klaviyo API source code. 
+You can check out the raw OAS on [GitHub](https://github.com/klaviyo/openapi/blob/main/openapi/stable.json).
+Then a modified version of the OpenAPI-Generator typescript node generator is used to create the SDK itself.
+This process allows us to have an SDK release ready the same day as new endpoints are added.
+
+### What this means for contributing
+
+Due to the SDK being generated, we won't merge new code without updating the generator.
+However, feel free to make a pr against our code, while we won't merge your pull request as is, it's still very helpful for correcting the generator, as we can merge your changes upstream into our private generator. 
+Some changes will take longer than others to fix, depending on whether the issues are caused by a bug in the SDK generator or in the generated OAS itself.
+
+You can also report bugs by opening an issue in this GitHub repo.
+
+Lastly, if you have any feedback that you would like to share outside of a public forum, feel free to use our [feedback form](https://docs.google.com/forms/d/e/1FAIpQLSckdxPXezeY6SludpOGpJ2nNZU280tEnSwuRnEyx0XNS02zdA/viewform). 
+
+### Testing
+
+Our unit tests are set up to hit a specific test account and are not included in this repo,
+but if you want to test anything without a consuming app there is an included `sample.ts` file.
+You can build the project and then execute the contents of the file with `npm run sample --pk=<your private key here>`

MIGRATION.md

@@ -0,0 +1,15 @@
+# Migration
+
+### Steps
+- Swap to the new version:
+  - updating your `package.json` manually to the current beta version
+  - currently, there are no known breaking changes from moving from the node sdk to the TypeScript Beta sdk
+
+
+### Work done to make migration easier
+ - Most current imports should still work. 
+   - ConfigWrapper has been recreated, is now optional, and it now works differently under the hood. However, you can still use it to set a global api key, or pass it into an API constructor
+ - Optional params should all have the same names, but now they have type support, letting you know which optional params are used on which endpoints
+
+### Known manual migration issues
+ - We will update this list with any know difference between the current node repo and this beta one.