feat(vercel): add Storage resource for managing Vercel storage #737

oieduardorabelo · 2025-07-23T23:19:27Z

Thanks for the support via Discord!

Support for Vercel's blob storage only

Happy to contribute more if there is demand

final API:

const acme_project = await Project("acme_project", {
  name: "acme_project",
  framework: "nextjs",
  gitRepository: {
    type: "github",
    repo: "acme_project",
  },
  rootDirectory: "acme_project",
  serverlessFunctionRegion: "syd1",
  environmentVariables: [],
});

const acme_storage = await Storage("acme_storage", {
  name: "acme_storage",
  region: "syd1",
  team: "acme_team",
  type: "blob",
  projects: [
    {
      projectId: acme_project.id,
      envVarEnvironments: ["production"],
      envVarPrefix: "ACME",
    },
    {
      projectId: "prj_acme_second_project",
      envVarEnvironments: ["development"],
      // by default `envVarPrefix` is BLOB
    },
  ],
});

sam-goodwin · 2025-07-24T00:16:58Z

alchemy/src/vercel/storage.ts

+  /**
+   * The storage store information
+   */
+  store: {


Good to pull this out into its own interface since it's a nested object

Or should we just flatten these properties into the Storage interface?

i ended up merging them in the Storage interface, however, it does feel "messy", because we are merging the API response to it and some properties can overlap... but looking at other resources, they are all doing that (aka merging back to the main interface), so i'm just following it too

sam-goodwin · 2025-07-24T00:18:26Z

alchemy/src/vercel/storage.ts

+  /**
+   * The team ID that the storage belongs to
+   */
+  teamId: string;


Do you think we'll eventually have a Team resource? If yes, then this should be team: string so that it can be later team: string | Team which is our convention for supporting both identifiers and references to alchemy resources.

there's a Team entity on Vercel, not sure if we'll ended up using (depends on which resources are migrated to alchemy)

i added a basic type for VercelTeam in vercel.types.ts

sam-goodwin · 2025-07-24T00:19:57Z

alchemy/src/vercel/storage.ts

+  /**
+   * The region where the storage will be deployed
+   */
+  region: string;


Is there a union type of allowed regions we can add to make this easier?

I see: https://vercel.com/docs/edge-network/regions

type VercelRegion = | "cpt1" // Cape Town, South Africa | "cle1" // Cleveland, USA | "dxb1" // Dubai, UAE | "dub1" // Dublin, Ireland | "fra1" // Frankfurt, Germany | "hkg1" // Hong Kong | "lhr1" // London, UK | "bom1" // Mumbai, India | "kix1" // Osaka, Japan | "cdg1" // Paris, France | "pdx1" // Portland, USA | "sfo1" // San Francisco, USA | "gru1" // São Paulo, Brazil | "icn1" // Seoul, South Korea | "sin1" // Singapore | "arn1" // Stockholm, Sweden | "syd1" // Sydney, Australia | "hnd1" // Tokyo, Japan | "iad1"; // Washington, D.C., USA | (string & {}) // special rune to maintain auto-suggestions without closing the type to new regions or ones we missed

great point, i was looking from a local experiment only. fixed it.

sam-goodwin · 2025-07-24T00:20:21Z

alchemy/src/vercel/storage.ts

+  /**
+   * The desired name for the storage
+   */
+  name: string;


Another convention we have is to leave this as optional name?: string and "@default id`

i checked upstash and vercel/project.... what you suggested is not happening! so i just followed their examples...

anyway, i added the case as you suggested (fallback to id) in the Storage class

sam-goodwin · 2025-07-24T00:21:14Z

alchemy/src/vercel/storage.ts

+async function createStorage(api: VercelApi, props: StorageProps) {
+  const response = await api.post(`/storage/stores/${props.type}?teamId=${props.teamId}`, {
+    name: props.name,
+    region: props.region,
+  });
+  return response.json() as Promise<{ store: Storage["store"] }>;
+}
+
+/**
+ * Delete a storage instance
+ */
+async function deleteStorage(api: VercelApi, output: Storage) {
+  await api.delete(`/storage/stores/${output.id}/connections?teamId=${output.teamId}`);
+  await api.delete(`/storage/stores/${output.type}/${output.id}?teamId=${output.teamId}`);
+}


Should be checking status code and throwing errors

the api.* client is returning a custom error if fetch is not response.ok

i ended up adding neverthrow on these functions, but there's no custom error, just bubbling up the returned error

sam-goodwin · 2025-07-27T05:27:47Z

This is looking great. Should add some tests in alchemy/test/vercel/storage.test.ts and follow the same practices as the project.test.ts test suite.

sam-goodwin · 2025-08-07T21:48:14Z

Hi @oieduardorabelo I tried pushing some changes to your Pr bur I don't have permission to push to your fork. Usually I do, not sure if you disabled that permission.

I opened this PR with the changes: #822. I'd prefer to continue with your PR, but LMK if you'd prefer I took over and got this merged.

oieduardorabelo · 2025-09-05T08:05:04Z

@sam-goodwin man, i have no idea why you don't have permission 😂

i'm back today + i'll try to fix this permission issue + rebase your branch into this pr

…lities

…re and functionality

oieduardorabelo · 2025-09-05T08:08:53Z

the checkbox is ticked to allow edits by maintainers

sam-goodwin reviewed Jul 24, 2025

View reviewed changes

sam-goodwin force-pushed the main branch from 0ea76ec to 4566fd8 Compare July 28, 2025 03:42

sam-goodwin mentioned this pull request Aug 7, 2025

feat(vercel): add Storage resource for managing Vercel storage #822

Closed

sam-goodwin force-pushed the main branch 2 times, most recently from f1acd44 to 195ee2e Compare August 13, 2025 22:27

oieduardorabelo added 3 commits September 5, 2025 20:08

feat(vercel): add Storage resource for managing Vercel storage

6157875

feat(vercel): enhance Storage resource with project management capabi…

31c484f

…lities

feat(vercel): refactor Storage and Project types for improved structu…

dc13514

…re and functionality

oieduardorabelo force-pushed the main branch from e3dcdf6 to dc13514 Compare September 5, 2025 08:08

oieduardorabelo added 3 commits September 5, 2025 20:21

chore: cherry-pick sam commits

ce4fa72

chore: recursive unique tuples utility

8101c93

chore: sort alpha

b78bb28

sam-goodwin force-pushed the main branch 2 times, most recently from a3a4abd to 1eeb802 Compare September 29, 2025 04:55

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(vercel): add Storage resource for managing Vercel storage #737

feat(vercel): add Storage resource for managing Vercel storage #737

oieduardorabelo commented Jul 23, 2025 •

edited

Loading

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

oieduardorabelo Jul 24, 2025

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

oieduardorabelo Jul 24, 2025 •

edited

Loading

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

oieduardorabelo Jul 24, 2025

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

oieduardorabelo Jul 24, 2025 •

edited

Loading

Uh oh!

sam-goodwin Jul 24, 2025

Uh oh!

oieduardorabelo Jul 24, 2025 •

edited

Loading

Uh oh!

sam-goodwin commented Jul 27, 2025

Uh oh!

sam-goodwin commented Aug 7, 2025

Uh oh!

oieduardorabelo commented Sep 5, 2025

Uh oh!

oieduardorabelo commented Sep 5, 2025

Uh oh!

Uh oh!

feat(vercel): add Storage resource for managing Vercel storage #737

Are you sure you want to change the base?

feat(vercel): add Storage resource for managing Vercel storage #737

Conversation

oieduardorabelo commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oieduardorabelo Jul 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oieduardorabelo Jul 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

oieduardorabelo Jul 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sam-goodwin commented Jul 27, 2025

Uh oh!

sam-goodwin commented Aug 7, 2025

Uh oh!

oieduardorabelo commented Sep 5, 2025

Uh oh!

oieduardorabelo commented Sep 5, 2025

Uh oh!

Uh oh!

oieduardorabelo commented Jul 23, 2025 •

edited

Loading

oieduardorabelo Jul 24, 2025 •

edited

Loading

oieduardorabelo Jul 24, 2025 •

edited

Loading

oieduardorabelo Jul 24, 2025 •

edited

Loading