New Case Study:See how Anthropic automated 95% of dependency reviews with Socket.Learn More →
@dizzzmas/sst-url-shortener
Advanced tools
@dizzzmas/sst-url-shortener - npm Package Compare versions
Comparing version 0.0.0-1729955753309 to 0.0.0-1730077680418
49
index.ts
@@ -1,7 +0,7 @@ | ||
| // FIXME: figure out absolute imports; currently committed imports are relative to the node_modules folder | ||
| import { type CdnArgs } from "./.sst/platform/src/components/aws"; | ||
| import type { FunctionArgs } from "./.sst/platform/src/components/aws/function"; | ||
| import type { ApiGatewayV2Args } from "./.sst/platform/src/components/aws/apigatewayv2"; | ||
| import type { DynamoArgs } from "./.sst/platform/src/components/aws/dynamo"; | ||
| import type { RouterArgs } from "./.sst/platform/src/components/aws/router"; | ||
| // TODO: figure out absolute imports; currently committed imports are relative to the node_modules folder | ||
| import { type CdnArgs } from "../../../.sst/platform/src/components/aws"; | ||
| import type { FunctionArgs } from "../../../.sst/platform/src/components/aws/function"; | ||
| import type { ApiGatewayV2Args } from "../../../.sst/platform/src/components/aws/apigatewayv2"; | ||
| import type { DynamoArgs } from "../../../.sst/platform/src/components/aws/dynamo"; | ||
| import type { RouterArgs } from "../../../.sst/platform/src/components/aws/router"; | ||
| import { type Input } from "@pulumi/pulumi"; | ||
@@ -17,2 +17,4 @@ | ||
| * | ||
| * When `true`, the auth token value is inferred from the `UrlShortenerApiAuthKey` [Secret](https://sst.dev/docs/component/secret/) | ||
| * To change the token run `sst secret set UrlShortenerApiAuthKey "YOUR_TOKEN"` | ||
| * @default false | ||
@@ -23,3 +25,3 @@ */ | ||
| /** | ||
| * Have swagger UI under /ui and openapi.json under /doc | ||
| * Have Swagger UI under /ui and openapi.json under /doc | ||
| * | ||
@@ -31,5 +33,7 @@ * @default true | ||
| /** | ||
| * desired length of the short id: short.com/{shortId} | ||
| * between 4 and 24 | ||
| * Desired length of the id in shortened urls e.g. my-shortener.com/{shortId} | ||
| * Allowed values between 4 and 24 | ||
| * | ||
| * Inferred from the `UrlShortenerShortIdLength` [Secret](https://sst.dev/docs/component/secret/) | ||
| * To change, run `sst secret set UrlShortenerShortIdLength "YOUR_TOKEN"` | ||
| * @default 8 | ||
@@ -40,4 +44,16 @@ */ | ||
| /** | ||
| * Set a custom domain for your short URLs. | ||
| * Set a custom domain for your short URLs and the API | ||
| * | ||
| * ```typescript | ||
| * const shortener = new UrlShortener({ | ||
| * domain: { | ||
| * name: "share.acme.com", | ||
| * dns: sst.aws.dns() | ||
| * } | ||
| * }) | ||
| * ``` | ||
| * The above example will results in short URLs looking like `https://share.acme.com/etogiyeu`, | ||
| * and the API looking like `https://api.share.acme.com/ui` | ||
| * | ||
| * | ||
| * Automatically manages domains hosted on AWS Route 53, Cloudflare, and Vercel. For other | ||
@@ -109,3 +125,3 @@ * providers, you'll need to pass in a `cert` that validates domain ownership and add the | ||
| router?: RouterArgs['transform'] | ||
| dynamo?: DynamoArgs['transform'] | ||
| table?: DynamoArgs['transform'] | ||
| }; | ||
@@ -120,3 +136,3 @@ } | ||
| /** | ||
| * used to link URLShortener to your other resources | ||
| * used to link URLShortener to other components | ||
| */ | ||
@@ -152,3 +168,3 @@ link: Input<any[]> | ||
| }, | ||
| transform: args?.transform?.dynamo, | ||
| transform: args?.transform?.table, | ||
| }); | ||
@@ -186,9 +202,4 @@ | ||
| this.redirectHandler = redirectHandler | ||
| this.link = [table, api, redirectHandler, redirectRouter, shortIdLength] | ||
| this.link = [table, api, redirectHandler, redirectRouter, shortIdLength, isAuthEnabled, areOpenApiDocsEnabled, authKey] | ||
| } | ||
| } | ||
| const __pulumiType = "sst:dizzzmas:aws:UrlShortener"; | ||
| // @ts-expect-error | ||
| UrlShortener.__pulumiType = __pulumiType; |
| { | ||
| "name": "@dizzzmas/sst-url-shortener", | ||
| "module": "index.ts", | ||
| "version": "0.0.0-1729955753309", | ||
| "version": "0.0.0-1730077680418", | ||
| "type": "module", | ||
@@ -10,6 +10,7 @@ "scripts": { | ||
| "devDependencies": { | ||
| "@changesets/cli": "^2.27.9", | ||
| "@pulumi/aws": "^6.56.1", | ||
| "@pulumi/pulumi": "^3.137.0", | ||
| "@types/aws-lambda": "8.10.145", | ||
| "@types/bun": "latest", | ||
| "@pulumi/aws": "^6.56.1", | ||
| "@pulumi/pulumi": "^3.137.0" | ||
| "@types/bun": "latest" | ||
| }, | ||
@@ -16,0 +17,0 @@ "peerDependencies": { |
209
README.md
@@ -1,20 +0,209 @@ | ||
| # sst-url-shortener | ||
| # :hocho: sst-url-shortener | ||
| Host your own URL shortener on AWS with SST and chop up those beefy URLs in a breeze. | ||
| Host your own URL shortener on AWS with [SST](https://github.com/sst/sst) and chop up those beefy links in a breeze! | ||
| - API comes with easily toggleable auth, swagger docs, URL search and expiration support | ||
| - Deploy as part of your existing SST app or standalone(using sdk to integrate with your other services) | ||
| - Lambda, DynamoDB, CloudFront, fully within AWS Free Tier with 0 upfront cost | ||
| - Bring your custom domain | ||
| - :twisted_rightwards_arrows: Add as a component to your existing SST app or deploy standalone and integrate with your JS/Python/Go backend via the OpenAPI sdk | ||
| - :lock: Opt-in API bearer auth and Swagger docs UI | ||
| - :sparkles: URL search and expiration support | ||
| - :house: Bring your custom domain | ||
| - :moneybag: Serverless and fully within AWS Free Tier, 0 upfront cost | ||
|  | ||
| # Pre-requisites | ||
| If this is your first time using SST or deploying to AWS, make sure you have the [AWS credentials](https://sst.dev/docs/iam-credentials/) properly setup | ||
| # Quickstart | ||
| ## Standalone SST app | ||
| This is for cases when you can't or don't want to integrate the `URLShortener` component into your existing SST app. | ||
| Here we will create a new SST app and use an OpenAPI SDK to integrate with our backend deployed elsewhere. | ||
| - Create a new project: | ||
| ```bash | ||
| bun install | ||
| mkdir my-shortener-app && cd my-shortener-app | ||
| npm init -y | ||
| ``` | ||
| To run: | ||
| - Init SST and install the `URLShortener` component: | ||
| ```bash | ||
| npx sst@latest init | ||
| npm install @dizzzmas/sst-url-shortener | ||
| ``` | ||
| - Declare the URL shortener component in `sst.config.ts`: | ||
| ```typescript | ||
| /// <reference path="./.sst/platform/config.d.ts" /> | ||
| import { UrlShortener } from "@dizzzmas/sst-url-shortener"; | ||
| export default $config({ | ||
| app(input) { | ||
| return { | ||
| name: "url-shortener", | ||
| removal: input?.stage === "production" ? "retain" : "remove", | ||
| home: "aws", | ||
| }; | ||
| }, | ||
| async run() { | ||
| const urlShortener = new UrlShortener({}) | ||
| return { | ||
| api: urlShortener.api.url, | ||
| } | ||
| }, | ||
| }); | ||
| ``` | ||
| - Deploy the app to your personal stage via SST dev mode: | ||
| ```bash | ||
| bun run index.ts | ||
| npx sst dev | ||
| ``` | ||
| This project was created using `bun init` in bun v1.1.31. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime. | ||
| Notice that our app once deployed returns a URL of an API endpoint. | ||
| By default the API doesn't require authentication and has Swagger UI enabled. | ||
| We can visit `{api}/ui` to access the swagger UI and test our API. | ||
| ### Backend integration via OpenAPI SDK | ||
| JS/Python/Go SDKs are available. | ||
| Below is an example of using the JS SDK to shorten a URL: | ||
| Install the SDK in your backend project | ||
| ```bash | ||
| npm install @dizzzmas/sst-url-shortener-sdk | ||
| ``` | ||
| Use it: | ||
| ```typescript | ||
| import SstURLShortener from '@dizzzmas/sst-url-shortener-sdk'; | ||
| const client = new SstURLShortener({ | ||
| baseURL: "YOUR_API_URL", | ||
| bearerToken: undefined // auth disabled in this example | ||
| }); | ||
| async function main() { | ||
| const newUrl = await client.urls.create({ | ||
| originalUrl: "https://sst.dev/docs" | ||
| }); | ||
| const shortUrl = newUrl.result.shortUrl; | ||
| console.log(shortUrl); // the shortened URL | ||
| const urls = await client.urls.search({}); | ||
| console.log(urls.result); | ||
| } | ||
| main(); | ||
| ``` | ||
| ## Add as a component to an existing SST app | ||
| Install the component: | ||
| ```bash | ||
| npm install @dizzzmas/sst-url-shortener | ||
| ``` | ||
| Modify `sst.config.ts` to include the component: | ||
| ```typescript | ||
| import { UrlShortener } from "@dizzzmas/sst-url-shortener"; | ||
| async run() { | ||
| // ...your existing components | ||
| const urlShortener = new UrlShortener({}); | ||
| // link URL shortener to another component e.g. a lambda function | ||
| const example = new sst.aws.Function("Example", { | ||
| link: [...urlShortener.link], | ||
| handler: "example.handler", | ||
| url: true, | ||
| }) | ||
| } | ||
| ``` | ||
| Inside the `example.ts` Lambda handler: | ||
| ```typescript | ||
| import { ShortUrl } from "@dizzzmas/sst-url-shortener" | ||
| export const handler = async () => { | ||
| const { shortUrl } = await ShortUrl.create({ | ||
| originalUrl: "https://sst.dev/docs" | ||
| }) | ||
| console.log("new short url", shortUrl) | ||
| const searchResult = await ShortUrl.search({}) | ||
| console.log("search results", searchResult) | ||
| return shortUrl | ||
| } | ||
| ``` | ||
| ## Component configuration | ||
| ### Authentication | ||
| API bearer authentication is disabled by default and can be enabled via setting `enableApiAuth` to `true` on the component. | ||
| ```typescript | ||
| const shortener = new UrlShortener({ | ||
| enableApiAuth: true, | ||
| }) | ||
| ``` | ||
| Make sure you specify the Bearer token expected by the API for authentication. | ||
| The Bearer token can be set via `UrlShortenerApiAuthKey` SST [Secret](https://sst.dev/docs/component/secret/) and defaults to `your_secret` | ||
| ```bash | ||
| npx sst secret set UrlShortenerApiAuthKey "YOUR_TOKEN" | ||
| ``` | ||
| ### Swagger UI | ||
| Swagger UI is enabled by default and can be disabled via settings `enableOpenApiDocs` to `false` on the component. | ||
| ```typescript | ||
| const shortener = new UrlShortener({ | ||
| enableOpenApiDocs: false, | ||
| }) | ||
| ``` | ||
| ### Custom domain | ||
| You can specify a custom domain for the URL shortener and its API. | ||
| ```typescript | ||
| const shortener = new UrlShortener({ | ||
| domain: { | ||
| name: "share.acme.com", | ||
| dns: sst.aws.dns() | ||
| } | ||
| }) | ||
| ``` | ||
| The above example will results in short URLs looking like `https://share.acme.com/etogiyeu`, and the API looking like `https://api.share.acme.com/ui` | ||
| Custom domains work out of the box if you use AWS Route53, Cloudflare or Vercel as your DNS provider, but will require [manual setup](https://sst.dev/docs/custom-domains#manual-setup) for other providers. | ||
| Please check out SST [Custom Domains](https://sst.dev/docs/custom-domains) docs for more info. | ||
| ### Short id length | ||
| Short id is the alphanumeric identifier for your URLs generated using [cuid2](https://github.com/paralleldrive/cuid2) | ||
| e.g. in `https://share.acme.com/etogiyeu` the short id is `etogiyeu` | ||
| Its length can be anywhere from 4 to 24 characters and defaults to 8. | ||
| ```typescript | ||
| const shortener = new UrlShortener({ | ||
| shortIdLength: 12 | ||
| }) | ||
| ``` | ||
| ### Transform underlying resources | ||
| You can fully customize the underlying resources thanks to the SST [Transform](https://sst.dev/docs/components/#transform) feature. | ||
| ```typescript | ||
| const shortener = new UrlShortener({ | ||
| transform: { | ||
| redirectHandler: { | ||
| function: { | ||
| timeout: 30 | ||
| } | ||
| } | ||
| } | ||
| }) | ||
| ``` | ||
No alert changes
Improved metrics
- Total package byte prevSize
- increased by23.64%
31197
- Lines of code
- increased by1.52%
869
- Number of lines in readme file
- increased by900%
210
Worsened metrics
- Dev dependency count
- increased by25%
5
No dependency changes