DO NOT MERGE

.github/ISSUE_TEMPLATE/1.support_request.yml

@@ -0,0 +1,27 @@
+name: Support Request
+description: Report a bug, feature request or other issue with the AI SDK.
+labels: ['support']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is ask for help regarding an issue that could be a bug or a feature request.
+  - type: textarea
+    attributes:
+      label: Description
+      description: A detailed description. Please include relevant information such as reproduction steps, code examples, and any other information that might help us understand the issue.
+      placeholder: |
+        Reproduction steps, code examples, background, etc...
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: AI SDK Version
+      description: Which version of the AI SDK are you using?
+      placeholder: |
+        Examples:
+        - ai: 4.1.2
+        - @ai-sdk/react: 2.1.0
+        - @ai-sdk/openai: 0.5.2
+    validations:
+      required: false

.github/pull_request_template.md

@@ -0,0 +1,51 @@
+<!--
+Welcome to contributing to AI SDK! We're excited to see your changes.
+
+We suggest you read the following contributing guide we've created before submitting:
+
+https://github.com/vercel/ai/blob/main/CONTRIBUTING.md
+-->
+
+## Background
+
+<!-- Why was this change necessary? -->
+
+## Summary
+
+<!-- What did you change? -->
+
+## Verification
+
+<!--
+For features & bugfixes.
+Please explain how you *manually* verified that the change works end-to-end as expected (independent of automated tests).
+Remove the section if it's not needed (e.g. for docs).
+-->
+
+## Tasks
+
+<!--
+This task list is intended to help you keep track of what you need to do.
+Feel free to add tasks and remove unnecessary tasks as needed.
+
+Please check if the PR fulfills the following requirements:
+-->
+
+- [ ] Tests have been added / updated (for bug fixes / features)
+- [ ] Documentation has been added / updated (for bug fixes / features)
+- [ ] A _patch_ changeset for relevant packages has been added (for bug fixes / features - run `pnpm changeset` in the project root)
+- [ ] Formatting issues have been fixed (run `pnpm prettier-fix` in the project root)
+
+## Future Work
+
+<!--
+Feel free to mention things not covered by this PR that can be done in future PRs.
+Remove the section if it's not needed.
+ -->
+
+## Related Issues
+
+<!--
+List related issues here, e.g. "Fixes #1234".
+Remove the section if it's not needed.
+-->

.github/workflows/actions/verify-changesets/index.js

@@ -0,0 +1,137 @@
+import fs from 'node:fs/promises';
+
+const BYPASS_LABELS = ['minor', 'major'];
+
+// check if current file is the entry point
+if (import.meta.url.endsWith(process.argv[1])) {
+  // https://docs.github.com/en/webhooks/webhook-events-and-payloads#pull_request
+  const pullRequestEvent = JSON.parse(
+    await fs.readFile(process.env.GITHUB_EVENT_PATH, 'utf-8'),
+  );
+
+  try {
+    const message = await verifyChangesets(
+      pullRequestEvent,
+      process.env,
+      fs.readFile,
+    );
+    await fs.writeFile(
+      process.env.GITHUB_STEP_SUMMARY,
+      `## Changeset verification passed ✅\n\n${message || ''}`,
+    );
+  } catch (error) {
+    // write error to summary
+    console.error(error.message);
+    await fs.writeFile(
+      process.env.GITHUB_STEP_SUMMARY,
+      `## Changeset verification failed ❌
+
+${error.message}`,
+    );
+
+    if (error.path) {
+      await fs.appendFile(
+        process.env.GITHUB_STEP_SUMMARY,
+        `\n\nFile: \`${error.path}\``,
+      );
+    }
+
+    if (error.content) {
+      await fs.appendFile(
+        process.env.GITHUB_STEP_SUMMARY,
+        `\n\n\`\`\`yaml\n${error.content}\n\`\`\``,
+      );
+    }
+
+    process.exit(1);
+  }
+}
+
+export async function verifyChangesets(
+  event,
+  env = process.env,
+  readFile = fs.readFile,
+) {
+  // Skip check if pull request has "minor-release" label
+  const byPassLabel = event.pull_request.labels.find(label =>
+    BYPASS_LABELS.includes(label.name),
+  );
+  if (byPassLabel) {
+    return `Skipping changeset verification - "${byPassLabel.name}" label found`;
+  }
+
+  // Iterate through all changed .changeset/*.md files
+  for (const path of env.CHANGED_FILES.trim().split(' ')) {
+    // ignore README.md file
+    if (path === '.changeset/README.md') continue;
+
+    // Check if the file is a .changeset file
+    if (!/^\.changeset\/[a-z-]+\.md/.test(path)) {
+      throw Object.assign(new Error(`Invalid file - not a .changeset file`), {
+        path,
+      });
+    }
+
+    // find frontmatter
+    const content = await readFile(`../../../../${path}`, 'utf-8');
+    const result = content.match(/---\n([\s\S]+?)\n---/);
+    if (!result) {
+      throw Object.assign(
+        new Error(`Invalid .changeset file - no frontmatter found`),
+        {
+          path,
+          content,
+        },
+      );
+    }
+
+    const [frontmatter] = result;
+
+    // Find version bump by package. `frontmatter` looks like this:
+    //
+    // ```yaml
+    // 'ai': patch
+    // '@ai-sdk/provider': patch
+    // ```
+    const lines = frontmatter.split('\n').slice(1, -1);
+    const versionBumps = {};
+    for (const line of lines) {
+      const [packageName, versionBump] = line.split(':').map(s => s.trim());
+      if (!packageName || !versionBump) {
+        throw Object.assign(
+          new Error(`Invalid .changeset file - invalid frontmatter`, {
+            path,
+            content,
+          }),
+        );
+      }
+
+      // Check if packageName is already set
+      if (versionBumps[packageName]) {
+        throw Object.assign(
+          new Error(
+            `Invalid .changeset file - duplicate package name "${packageName}"`,
+          ),
+          { path, content },
+        );
+      }
+
+      versionBumps[packageName] = versionBump;
+    }
+
+    // check if any of the version bumps are not "patch"
+    const invalidVersionBumps = Object.entries(versionBumps).filter(
+      ([, versionBump]) => versionBump !== 'patch',
+    );
+
+    if (invalidVersionBumps.length > 0) {
+      throw Object.assign(
+        new Error(
+          `Invalid .changeset file - invalid version bump (only "patch" is allowed, see https://ai-sdk.dev/docs/migration-guides/versioning). To bypass, add one of the following labels: ${BYPASS_LABELS.join(', ')}`,
+        ),
+
+        { path, content },
+      );
+    }
+  }
+}

.github/workflows/actions/verify-changesets/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "verify-changesets-action",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node --test test.js"
+  }
+}