{"id":26433658,"url":"https://github.com/rackspace/sailplane","last_synced_at":"2025-04-13T03:09:20.735Z","repository":{"id":37547692,"uuid":"166314155","full_name":"rackspace/sailplane","owner":"rackspace","description":"Utilities for AWS Serverless development in Javascript and Typescript","archived":false,"fork":false,"pushed_at":"2025-02-08T01:00:41.000Z","size":1027,"stargazers_count":27,"open_issues_count":4,"forks_count":3,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-13T03:08:58.550Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rackspace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-17T23:53:44.000Z","updated_at":"2025-02-08T00:34:20.000Z","dependencies_parsed_at":"2024-06-18T21:26:34.106Z","dependency_job_id":"e7d998ff-1a09-482f-950f-6bc8008250b5","html_url":"https://github.com/rackspace/sailplane","commit_stats":{"total_commits":95,"total_committers":6,"mean_commits":"15.833333333333334","dds":0.368421052631579,"last_synced_commit":"d9db60589d6e7b8b70c239eb639610e739a2b92d"},"previous_names":["onicagroup/sailplane"],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rackspace%2Fsailplane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rackspace%2Fsailplane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rackspace%2Fsailplane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rackspace%2Fsailplane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rackspace","download_url":"https://codeload.github.com/rackspace/sailplane/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657918,"owners_count":21140846,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-18T07:17:58.663Z","updated_at":"2025-04-13T03:09:20.705Z","avatar_url":"https://github.com/rackspace.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sailplane - AWS Serverless Node.js Utilities in Javascript and Typescript\n\n![](docs/sailplane.png)\n\n## What is this?\n\nWhile developing serverless applications at Onica (now part of [Rackspace Technology](https://www.rackspace.com)),\nwe found certain patterns being used repeatedly, and code being copied from one project to the next.\nThese commonalities have been extracted, matured, and gathered into a reusable collection.\n\nSailplane is the result: a collection of useful packages for use in developing code that runs in AWS.\nThey are primarily designed for use in Lambda functions, but most are useful in other environments\nthat use the Node.js 20+ runtime as well. `ExpiringValue` is even useful in web browsers.\n\nThe Typescript source is compiled to ES2020 Javascript and distributed with both ESModule and CommonJS\nmodules for portability, along with Typescript type definition files and map files.\nWhile the typing provides the expected benefit, these utilities may be used in plain\nJavascript as well.\n\nEvery tool is the genesis of real world needs, and they continue to evolve.\nThis collection is part of Rackspace Technology's commitment to give back to the open source community.\nFind this and other Rackspace open source repositories on [GitHub](https://github.com/rackspace).\n\n## Content\n\nEach utility is described on its own page:\n\n- [AwsHttps - HTTPS client with AWS Signature v4](docs/aws_https.md)\n- [ElasticsearchClient - Communicate with AWS Elasticsearch](docs/elasticsearch_client.md)\n- [ExpiringValue - Value that is instantiated on-demand and cached for a limited time](docs/expiring_value.md)\n- [Injector - Light-weight and type-safe Dependency Injection](docs/injector.md)\n- [LambdaUtils - AWS Lambda handler middleware](docs/lambda_utils.md)\n- [Logger - CloudWatch and serverless-offline friendly logger](docs/logger.md)\n- [StateStorage - Serverless state and configuration storage](docs/state_storage.md)\n- [More Examples](docs/examples.md)\n- [License](docs/license.md)\n\n## Why \"Sailplane\"?\n\nOnica's early OSS releases have had aviation themed names;\nthis may or may not have something to do with the CTO being a pilot. Nobody really knows.\n\nSailplane was selected for this _serverless_ toolset by considering that\nserverless is to computing without the complexities of a server,\nas a sailplane is to flight without the complexities of an airplane.\n\nAnd that's it. Also, the NPM scope was available.\n\n## Development\n\nThis is a monorepo with shared development tools at the root level. Each subdirectory is a\nproject. Use the `npm run` scripts in each package, or from the root workspace to run the\nscript on all packages.\n\n### Making Changes\n\n1. Create an [issue in Github](https://github.com/rackspace/sailplane/issues). Get approval from the community.\n2. Create a branch off of `main`. The branch name should be like `issue/\u003cnum\u003e-brief-summary`\n3. Make your change and test it thoroughly with unit tests and a project using it.\n4. Run `npm run analyze` from the root workspace and resolve all errors.\n5. Commit to your git branch and open a [pull request](https://github.com/rackspace/sailplane/pulls).\n   - Do not change the version in `package.json`.\n\n### Publish a Release\n\nThis is managed from each library package, as they are individually released to NPM.\n\n1. Run `npm run clean \u0026\u0026 npm run analyze` to confirm that all code builds and tests pass.\n2. Use `npm version \u003cmajor | minor | patch\u003e` to bump the version and tag it in git. ([docs](https://docs.npmjs.com/cli/v10/commands/npm-version))\n3. Use `npm publish` to publish the change to NPM. You must have credentials. ([docs](https://docs.npmjs.com/cli/v10/commands/npm-publish))\n4. Commit \u0026 Push updates to git.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frackspace%2Fsailplane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frackspace%2Fsailplane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frackspace%2Fsailplane/lists"}