@erinjs/core 1.0.0

package/core/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/core/.changeset/community-bootstrap-release.md

@@ -0,0 +1,17 @@
+---
+'@erinjs/builders': patch
+'@erinjs/collection': patch
+'@erinjs/core': patch
+'@erinjs/rest': patch
+'@erinjs/types': patch
+'@erinjs/util': patch
+'@erinjs/voice': patch
+'@erinjs/ws': patch
+---
+
+chore(release): bootstrap @erinjs prerelease packages
+
+Initial prerelease for the @erinjs package line.
+
+Publishes the current SDK packages under @erinjs with the community prerelease
+tag. Runtime APIs and package exports stay the same.

package/core/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "./no-changelog.js",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/core/.changeset/no-changelog.js

@@ -0,0 +1,16 @@
+/**
+ * No-op changelog. Changelog is maintained in apps/docs/src/data/changelog.ts
+ * as the single source of truth for the docs site.
+ */
+async function getReleaseLine() {
+  return '';
+}
+
+async function getDependencyReleaseLine() {
+  return '';
+}
+
+module.exports = {
+  getReleaseLine,
+  getDependencyReleaseLine,
+};

package/core/.changeset/pre.json

@@ -0,0 +1,17 @@
+{
+  "mode": "pre",
+  "tag": "community",
+  "initialVersions": {
+    "@erinjs/builders": "1.2.4",
+    "@erinjs/collection": "1.2.4",
+    "@erinjs/core": "1.2.4",
+    "@erinjs/docgen": "1.2.4",
+    "@erinjs/docs": "1.2.4",
+    "@erinjs/rest": "1.2.4",
+    "@erinjs/types": "1.2.4",
+    "@erinjs/util": "1.2.4",
+    "@erinjs/voice": "1.2.4",
+    "@erinjs/ws": "1.2.4"
+  },
+  "changesets": []
+}

package/core/.editorconfig

@@ -0,0 +1,13 @@
+# EditorConfig - https://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

package/core/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/core/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,23 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+- Be respectful and inclusive
+- Accept constructive criticism gracefully
+- Focus on what is best for the community
+- Show empathy toward other community members
+
+## Unacceptable Behavior
+
+- Trolling, insulting or derogatory comments
+- Public or private harassment
+- Publishing others' private information without permission
+- Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct.

package/core/.github/FUNDING.yml

@@ -0,0 +1,7 @@
+custom:
+  [
+    'https://paypal.me/vesaber',
+    'https://ko-fi.com/dogbonewish',
+    'https://ko-fi.com/forgetfulskybro',
+  ]
+ko_fi: jbcrn

package/core/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+1. ...
+2. ...
+3. ...
+
+## Expected behavior
+
+What you expected to happen.
+
+## Environment
+
+- @erinjs/core version:
+- Node.js version:
+- OS:
+
+## Additional context
+
+Add any other context about the problem here.

package/core/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+A clear and concise description of what the problem is.
+
+## Proposed solution
+
+A clear and concise description of what you want to happen.
+
+## Alternatives considered
+
+Any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context about the feature request here.

package/core/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## Description
+
+<!-- Describe your changes -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation update
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines (run `pnpm run lint`)
+- [ ] I have run `pnpm run build` successfully
+- [ ] I have run `pnpm run test` successfully

package/core/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    groups:
+      typescript-eslint:
+        patterns:
+          - '@typescript-eslint/*'
+      vitest:
+        patterns:
+          - 'vitest'
+          - '@vitest/*'

package/core/.github/workflows/autoapp.yml

@@ -0,0 +1,16 @@
+name: Auto Approve
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  auto-approve:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    if: ${{ github.event.pull_request.author_association == 'MEMBER' || github.event.pull_request.author_association == 'OWNER' }}
+
+    steps:
+      - uses: hmarr/auto-approve-action@v4
+        continue-on-error: true

package/core/.github/workflows/ci.yml

@@ -0,0 +1,187 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  format:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.ref }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Format
+        run: pnpm run format
+
+      - name: Check for format changes
+        id: format_check
+        run: |
+          git add -A
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit and push format fixes
+        if: ${{ steps.format_check.outputs.has_changes == 'true' && github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git commit -m "style: apply prettier"
+          git push origin HEAD:${{ github.event.pull_request.head.ref }}
+
+      - name: Comment on fork PR about format fixes
+        if: ${{ steps.format_check.outputs.has_changes == 'true' && github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name != github.repository }}
+        continue-on-error: true
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const body = '## Prettier format needed\n\nThis PR has formatting issues that CI cannot auto-fix (PRs from forks cannot be pushed to). Please run:\n\n```bash\npnpm run format\n```\n\nThen commit and push the changes.\n\n<!-- prettier-format-comment -->';
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+            const botComment = comments.find(c => c.body && c.body.includes('<!-- prettier-format-comment -->'));
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }
+
+  lint:
+    runs-on: ubuntu-latest
+    needs: format
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.ref }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Lint
+        run: pnpm run lint
+
+  build-test:
+    runs-on: ubuntu-latest
+    needs: format
+    permissions:
+      contents: read
+      checks: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.ref }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Test (all unit tests, load tests, smoke tests)
+        run: pnpm run test:all
+
+      - name: Publish test results
+        if: always() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
+        uses: dorny/test-reporter@v1
+        with:
+          name: Vitest
+          path: test-results/junit.xml
+          reporter: java-junit
+          fail-on-error: false
+
+  coverage:
+    runs-on: ubuntu-latest
+    needs: format
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.ref }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Build
+        run: pnpm run build --concurrency=10
+
+      - name: Test coverage
+        run: pnpm run test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage/lcov.info
+          fail_ci_if_error: false
+
+  audit:
+    runs-on: ubuntu-latest
+    needs: format
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Audit
+        run: pnpm audit --prod

package/core/.github/workflows/codeql.yml

@@ -0,0 +1,30 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 0 * * 1'
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: javascript-typescript
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v3
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3

package/core/.github/workflows/deploy-docs.yml

@@ -0,0 +1,54 @@
+name: Deploy docs to blstmo-abandoned-us-for-the-milk/docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'apps/docs-vitepress/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.DOCS_APP_ID }}
+          private-key: ${{ secrets.DOCS_APP_PRIVATE_KEY }}
+          owner: blstmo-abandoned-us-for-the-milk
+          repositories: docs
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Generate API docs
+        working-directory: apps/docs-vitepress
+        run: node --import tsx/esm scripts/generate-api.ts api-data/latest/main.json
+
+      - name: Build VitePress
+        working-directory: apps/docs-vitepress
+        run: npx vitepress build
+        env:
+          VITEPRESS_BASE: /
+
+      - name: Deploy to docs gh-pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          personal_token: ${{ steps.app-token.outputs.token }}
+          external_repository: blstmo-abandoned-us-for-the-milk/docs
+          publish_branch: gh-pages
+          publish_dir: apps/docs-vitepress/.vitepress/dist

package/core/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  release:
+    if: ${{ vars.ERINJS_RELEASE_ENABLED == 'true' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --ignore-scripts
+
+      - name: Test (all)
+        run: pnpm run test:all
+
+      - name: Create release PR or publish
+        uses: changesets/action@v1
+        with:
+          version: pnpm exec changeset version
+          publish: pnpm exec changeset publish
+          commit: 'chore: version packages'
+          title: 'chore: version packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/core/.lintstagedrc.json

@@ -0,0 +1,4 @@
+{
+  "*.{ts,tsx,js,vue}": ["eslint --fix", "prettier --write"],
+  "*.{json,md,yml,yaml}": ["prettier --write"]
+}

package/core/.nvmrc

@@ -0,0 +1 @@
+20

package/core/.prettierignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+coverage
+.turbo
+*.min.js
+pnpm-lock.yaml
+apps/docs/public/docs
+.gitignore

package/core/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "bracketSameLine": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/core/CONTRIBUTING.md

@@ -0,0 +1,70 @@
+# Contributing to erin.js SDK
+
+Thank you for your interest in contributing!
+
+## Development setup
+
+1. Clone the repository and install dependencies:
+
+   ```bash
+   git clone https://github.com/blstmo-abandoned-us-for-the-milk/core.git
+   cd core
+   pnpm install
+   ```
+
+2. Build the project:
+
+   ```bash
+   pnpm run build
+   ```
+
+3. Run tests:
+
+   ```bash
+   # Full test suite (unit tests + load tests + smoke tests)
+   pnpm run test:all
+
+   # Unit tests only (faster for iteration)
+   pnpm run test
+
+   # With coverage report (opens coverage/index.html)
+   pnpm run test:coverage
+
+   # JSON report (test-results/results.json)
+   pnpm run test:report
+   ```
+
+4. Run lint:
+
+   ```bash
+   pnpm run lint
+   ```
+
+## Commit conventions
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) with Changesets for versioning:
+
+- `fix:` - bug fixes
+- `feat:` - new features
+- `docs:` - documentation
+- `chore:` - maintenance
+
+When making changes that affect published packages, add a changeset:
+
+```bash
+pnpm exec changeset
+```
+
+## Pull request process
+
+1. Create a feature branch from `main`
+2. Make your changes
+3. Ensure lint and tests pass
+4. Add a changeset if your changes affect published packages
+5. Submit a pull request
+
+## Project structure
+
+- `packages/` - Monorepo packages
+- `apps/docs/` - Documentation site
+- `examples/` - Example bots