Sync from opensea-devtools

Author: CodySearsOS

.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+      - run: npm install
+      - run: npm run build
+      - run: npm run lint
+      - run: npm test

.github/workflows/npm-publish-reusable.yml

@@ -0,0 +1,56 @@
+name: Publish npm package
+
+on:
+  workflow_call:
+    inputs:
+      build-before-publish:
+        description: Run build and test before publishing
+        type: boolean
+        default: true
+      stub-package-dir:
+        description: Path to stub package directory (e.g. packages/opensea-js-stub)
+        type: string
+        default: ""
+      node-version-file:
+        description: Path to node version file
+        type: string
+        default: .nvmrc
+    secrets:
+      OPENSEA_API_KEY:
+        required: false
+      ALCHEMY_API_KEY:
+        required: false
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: ${{ inputs.node-version-file }}
+          registry-url: https://registry.npmjs.org/
+
+      # Use npm install (not npm ci) because the package-lock.json may be
+      # out of sync after the sync-package workflow resolves workspace: protocols
+      # and updates dependencies. npm ci requires exact lockfile match.
+      - run: npm install
+
+      - if: ${{ inputs.build-before-publish }}
+        run: npm run build
+
+      - if: ${{ inputs.build-before-publish }}
+        run: npm test
+        env:
+          OPENSEA_API_KEY: ${{ secrets.OPENSEA_API_KEY }}
+          ALCHEMY_API_KEY: ${{ secrets.ALCHEMY_API_KEY }}
+
+      - run: npm publish --provenance --access public
+
+      - if: ${{ inputs.stub-package-dir != '' }}
+        run: npm publish --provenance --access public
+        working-directory: ${{ inputs.stub-package-dir }}
+        continue-on-error: true

.github/workflows/npm-publish.yml

@@ -5,19 +5,6 @@ on:
     types: [published]
 
 jobs:
-  publish-npm:
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: read
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: "22"
-          registry-url: https://registry.npmjs.org/
-      - run: npm install
-      - run: npm run build
-      - run: npm test
-      # Auth via OIDC trusted publishing (id-token: write + --provenance)
-      - run: npm publish --provenance --access public
+  publish:
+    uses: ./.github/workflows/npm-publish-reusable.yml
+    secrets: inherit

.gitignore

@@ -0,0 +1 @@
+24.14.1

.nvmrc

@@ -0,0 +1,63 @@
+{
+  "$schema": "node_modules/@biomejs/biome/configuration_schema.json",
+  "files": {
+    "includes": [
+      "**/*.ts",
+      "**/*.js",
+      "**/*.json",
+      "!**/node_modules/**",
+      "!**/dist/**",
+      "!**/lib/**",
+      "!**/coverage/**",
+      "!**/.nyc_output/**",
+      "!packages/sdk/src/typechain/**",
+      "!**/typechain/**",
+      "!packages/api-types/src/generated.ts",
+      "!**/pnpm-lock.yaml",
+      "!**/package-lock.json"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "asNeeded"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noConsole": "off",
+        "noExplicitAny": "off"
+      },
+      "correctness": {
+        "noUnusedImports": "warn"
+      },
+      "style": {
+        "noUnusedTemplateLiteral": "off"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.test.ts", "**/*.spec.ts", "**/test/**"],
+      "linter": {
+        "rules": {
+          "correctness": {
+            "noUnusedImports": "off"
+          }
+        }
+      }
+    }
+  ]
+}

biome.json

@@ -1,5 +1,5 @@
 {
-  "extends": "./tsconfig.base.json",
+  "extends": "./tsconfig.node-esm.json",
   "compilerOptions": {
     "outDir": "./dist",
     "rootDir": "./src"

tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["dom", "esnext"],
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "noImplicitReturns": true,
+    "noErrorTruncation": true,
+    "noImplicitThis": false,
+    "noUnusedParameters": true,
+    "preserveConstEnums": true,
+    "removeComments": false,
+    "sourceMap": true
+  }
+}

tsconfig.node-cjs.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "sourceMap": true
+  }
+}

tsconfig.node-esm.json

@@ -0,0 +1,10 @@
+import { defineConfig } from "tsup"
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm", "cjs"],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  target: "node18",
+})