Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

release: 0.0.1-alpha.1 #4

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions .github/workflows/publish-npm.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# This workflow is triggered when a GitHub release is created.
# It can also be run manually to re-publish to NPM in case it failed for some reason.
# You can run this workflow by navigating to https://www.github.com/maestro-org/maestro-arch-rpc-node-sdk/actions/workflows/publish-npm.yml
name: Publish NPM
on:
workflow_dispatch:

release:
types: [published]

jobs:
publish:
name: publish
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v4

- name: Set up Node
uses: actions/setup-node@v3
with:
node-version: '18'

- name: Install dependencies
run: |
yarn install

- name: Publish to NPM
run: |
bash ./bin/publish-npm
env:
NPM_TOKEN: ${{ secrets.MAESTRO_ARCH_RPC_NPM_TOKEN || secrets.NPM_TOKEN }}
22 changes: 22 additions & 0 deletions .github/workflows/release-doctor.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
name: Release Doctor
on:
pull_request:
branches:
- main
workflow_dispatch:

jobs:
release_doctor:
name: release doctor
runs-on: ubuntu-latest
if: github.repository == 'maestro-org/maestro-arch-rpc-node-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')

steps:
- uses: actions/checkout@v4

- name: Check release environment
run: |
bash ./bin/check-release-environment
env:
NPM_TOKEN: ${{ secrets.MAESTRO_ARCH_RPC_NPM_TOKEN || secrets.NPM_TOKEN }}

3 changes: 3 additions & 0 deletions .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
".": "0.0.1-alpha.1"
}
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Changelog

## 0.0.1-alpha.1 (2024-10-29)

Full Changelog: [v0.0.1-alpha.0...v0.0.1-alpha.1](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/compare/v0.0.1-alpha.0...v0.0.1-alpha.1)

### Chores

* go live ([#1](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/issues/1)) ([f767c9d](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/commit/f767c9d873d9651118d61b550915e702a9971509))
* update SDK settings ([#3](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/issues/3)) ([b89e669](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/commit/b89e669a2141d1455c72216e4c99bbcbb4d865e8))
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,25 +42,25 @@ If you’d like to use the repository from source, you can either install from g
To install via git:

```sh
$ npm install git+ssh://[email protected]:stainless-sdks/maestro-arch-rpc-node.git
$ npm install git+ssh://[email protected]:maestro-org/maestro-arch-rpc-node-sdk.git
```

Alternatively, to link a local copy of the repo:

```sh
# Clone
$ git clone https://www.github.com/stainless-sdks/maestro-arch-rpc-node
$ cd maestro-arch-rpc-node
$ git clone https://www.github.com/maestro-org/maestro-arch-rpc-node-sdk
$ cd maestro-arch-rpc-node-sdk

# With yarn
$ yarn link
$ cd ../my-package
$ yarn link maestro-arch-rpc
$ yarn link maestro-arch-rpc-sdk

# With pnpm
$ pnpm link --global
$ cd ../my-package
$ pnpm link -—global maestro-arch-rpc
$ pnpm link -—global maestro-arch-rpc-sdk
```

## Running tests
Expand Down Expand Up @@ -99,7 +99,7 @@ the changes aren't made through the automated pipeline, you may want to make rel

### Publish with a GitHub workflow

You can release to package managers by using [the `Publish NPM` GitHub action](https://www.github.com/stainless-sdks/maestro-arch-rpc-node/actions/workflows/publish-npm.yml). This requires a setup organization or repository secret to be set up.
You can release to package managers by using [the `Publish NPM` GitHub action](https://www.github.com/maestro-org/maestro-arch-rpc-node-sdk/actions/workflows/publish-npm.yml). This requires a setup organization or repository secret to be set up.

### Publish manually

Expand Down
23 changes: 10 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Maestro Arch Rpc Node API Library

[![NPM version](https://img.shields.io/npm/v/maestro-arch-rpc.svg)](https://npmjs.org/package/maestro-arch-rpc) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/maestro-arch-rpc)
[![NPM version](https://img.shields.io/npm/v/maestro-arch-rpc-sdk.svg)](https://npmjs.org/package/maestro-arch-rpc-sdk) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/maestro-arch-rpc-sdk)

This library provides convenient access to the Maestro Arch Rpc REST API from server-side TypeScript or JavaScript.

Expand All @@ -11,19 +11,16 @@ It is generated with [Stainless](https://www.stainlessapi.com/).
## Installation

```sh
npm install git+ssh://[email protected]:stainless-sdks/maestro-arch-rpc-node.git
npm install maestro-arch-rpc-sdk
```

> [!NOTE]
> Once this package is [published to npm](https://app.stainlessapi.com/docs/guides/publish), this will become: `npm install maestro-arch-rpc`

## Usage

The full API of this library can be found in [api.md](api.md).

<!-- prettier-ignore -->
```js
import MaestroArchRpc from 'maestro-arch-rpc';
import MaestroArchRpc from 'maestro-arch-rpc-sdk';

const client = new MaestroArchRpc();

Expand All @@ -42,7 +39,7 @@ This library includes TypeScript definitions for all request params and response

<!-- prettier-ignore -->
```ts
import MaestroArchRpc from 'maestro-arch-rpc';
import MaestroArchRpc from 'maestro-arch-rpc-sdk';

const client = new MaestroArchRpc();

Expand Down Expand Up @@ -210,12 +207,12 @@ add the following import before your first import `from "MaestroArchRpc"`:
```ts
// Tell TypeScript and the package to use the global web fetch instead of node-fetch.
// Note, despite the name, this does not add any polyfills, but expects them to be provided if needed.
import 'maestro-arch-rpc/shims/web';
import MaestroArchRpc from 'maestro-arch-rpc';
import 'maestro-arch-rpc-sdk/shims/web';
import MaestroArchRpc from 'maestro-arch-rpc-sdk';
```

To do the inverse, add `import "maestro-arch-rpc/shims/node"` (which does import polyfills).
This can also be useful if you are getting the wrong TypeScript types for `Response` ([more details](https://github.com/stainless-sdks/maestro-arch-rpc-node/tree/main/src/_shims#readme)).
To do the inverse, add `import "maestro-arch-rpc-sdk/shims/node"` (which does import polyfills).
This can also be useful if you are getting the wrong TypeScript types for `Response` ([more details](https://github.com/maestro-org/maestro-arch-rpc-node-sdk/tree/main/src/_shims#readme)).

### Logging and middleware

Expand All @@ -224,7 +221,7 @@ which can be used to inspect or alter the `Request` or `Response` before/after e

```ts
import { fetch } from 'undici'; // as one example
import MaestroArchRpc from 'maestro-arch-rpc';
import MaestroArchRpc from 'maestro-arch-rpc-sdk';

const client = new MaestroArchRpc({
fetch: async (url: RequestInfo, init?: RequestInit): Promise<Response> => {
Expand Down Expand Up @@ -271,7 +268,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con

We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.

We are keen for your feedback; please open an [issue](https://www.github.com/stainless-sdks/maestro-arch-rpc-node/issues) with questions, bugs, or suggestions.
We are keen for your feedback; please open an [issue](https://www.github.com/maestro-org/maestro-arch-rpc-node-sdk/issues) with questions, bugs, or suggestions.

## Requirements

Expand Down
22 changes: 22 additions & 0 deletions bin/check-release-environment
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
#!/usr/bin/env bash

errors=()

if [ -z "${NPM_TOKEN}" ]; then
errors+=("The MAESTRO_ARCH_RPC_NPM_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets")
fi

lenErrors=${#errors[@]}

if [[ lenErrors -gt 0 ]]; then
echo -e "Found the following errors in the release environment:\n"

for error in "${errors[@]}"; do
echo -e "- $error\n"
done

exit 1
fi

echo "The environment is ready to push releases!"

6 changes: 3 additions & 3 deletions jest.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ const config: JestConfigWithTsJest = {
'^.+\\.(t|j)sx?$': ['@swc/jest', { sourceMaps: 'inline' }],
},
moduleNameMapper: {
'^maestro-arch-rpc$': '<rootDir>/src/index.ts',
'^maestro-arch-rpc/_shims/auto/(.*)$': '<rootDir>/src/_shims/auto/$1-node',
'^maestro-arch-rpc/(.*)$': '<rootDir>/src/$1',
'^maestro-arch-rpc-sdk$': '<rootDir>/src/index.ts',
'^maestro-arch-rpc-sdk/_shims/auto/(.*)$': '<rootDir>/src/_shims/auto/$1-node',
'^maestro-arch-rpc-sdk/(.*)$': '<rootDir>/src/$1',
},
modulePathIgnorePatterns: [
'<rootDir>/ecosystem-tests/',
Expand Down
10 changes: 5 additions & 5 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
"name": "maestro-arch-rpc",
"version": "0.0.1-alpha.0",
"name": "maestro-arch-rpc-sdk",
"version": "0.0.1-alpha.1",
"description": "The official TypeScript library for the Maestro Arch Rpc API",
"author": "Maestro Arch Rpc <[email protected]>",
"types": "dist/index.d.ts",
"main": "dist/index.js",
"type": "commonjs",
"repository": "github:stainless-sdks/maestro-arch-rpc-node",
"repository": "github:maestro-org/maestro-arch-rpc-node-sdk",
"license": "Apache-2.0",
"packageManager": "[email protected]",
"files": [
Expand Down Expand Up @@ -60,8 +60,8 @@
"./shims/web.mjs"
],
"imports": {
"maestro-arch-rpc": ".",
"maestro-arch-rpc/*": "./src/*"
"maestro-arch-rpc-sdk": ".",
"maestro-arch-rpc-sdk/*": "./src/*"
},
"exports": {
"./_shims/auto/*": {
Expand Down
67 changes: 67 additions & 0 deletions release-please-config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
{
"packages": {
".": {}
},
"$schema": "https://raw.githubusercontent.com/stainless-api/release-please/main/schemas/config.json",
"include-v-in-tag": true,
"include-component-in-tag": false,
"versioning": "prerelease",
"prerelease": true,
"bump-minor-pre-major": true,
"bump-patch-for-minor-pre-major": false,
"pull-request-header": "Automated Release PR",
"pull-request-title-pattern": "release: ${version}",
"changelog-sections": [
{
"type": "feat",
"section": "Features"
},
{
"type": "fix",
"section": "Bug Fixes"
},
{
"type": "perf",
"section": "Performance Improvements"
},
{
"type": "revert",
"section": "Reverts"
},
{
"type": "chore",
"section": "Chores"
},
{
"type": "docs",
"section": "Documentation"
},
{
"type": "style",
"section": "Styles"
},
{
"type": "refactor",
"section": "Refactors"
},
{
"type": "test",
"section": "Tests",
"hidden": true
},
{
"type": "build",
"section": "Build System"
},
{
"type": "ci",
"section": "Continuous Integration",
"hidden": true
}
],
"release-type": "node",
"extra-files": [
"src/version.ts",
"README.md"
]
}
6 changes: 3 additions & 3 deletions scripts/build
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ node scripts/utils/check-version.cjs

# Build into dist and will publish the package from there,
# so that src/resources/foo.ts becomes <package root>/resources/foo.js
# This way importing from `"maestro-arch-rpc/resources/foo"` works
# This way importing from `"maestro-arch-rpc-sdk/resources/foo"` works
# even with `"moduleResolution": "node"`

rm -rf dist; mkdir dist
Expand Down Expand Up @@ -47,8 +47,8 @@ node scripts/utils/postprocess-files.cjs

# make sure that nothing crashes when we require the output CJS or
# import the output ESM
(cd dist && node -e 'require("maestro-arch-rpc")')
(cd dist && node -e 'import("maestro-arch-rpc")' --input-type=module)
(cd dist && node -e 'require("maestro-arch-rpc-sdk")')
(cd dist && node -e 'import("maestro-arch-rpc-sdk")' --input-type=module)

if command -v deno &> /dev/null && [ -e ./scripts/build-deno ]
then
Expand Down
4 changes: 2 additions & 2 deletions scripts/utils/postprocess-files.cjs
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ const fs = require('fs');
const path = require('path');
const { parse } = require('@typescript-eslint/parser');

const pkgImportPath = process.env['PKG_IMPORT_PATH'] ?? 'maestro-arch-rpc/';
const pkgImportPath = process.env['PKG_IMPORT_PATH'] ?? 'maestro-arch-rpc-sdk/';

const distDir =
process.env['DIST_PATH'] ?
Expand Down Expand Up @@ -142,7 +142,7 @@ async function postprocess() {

if (file.endsWith('.d.ts')) {
// work around bad tsc behavior
// if we have `import { type Readable } from 'maestro-arch-rpc/_shims/index'`,
// if we have `import { type Readable } from 'maestro-arch-rpc-sdk/_shims/index'`,
// tsc sometimes replaces `Readable` with `import("stream").Readable` inline
// in the output .d.ts
transformed = transformed.replace(/import\("stream"\).Readable/g, 'Readable');
Expand Down
Loading
Loading