@erinjs/core 1.0.0

package/core/scripts/test-package-exports.mjs

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * Exercise actual code from each published erin.js community package.
+ * Verifies exports work and basic functionality runs (not just import).
+ *
+ * Run from repo root after build:
+ *   node scripts/test-package-exports.mjs
+ */
+
+const TESTS = [
+  {
+    pkg: '@erinjs/types',
+    exercise: async (m) => {
+      if (typeof m.Routes?.channel !== 'function') throw new Error('Routes.channel missing');
+      if (m.Routes.channel('123') !== '/channels/123') throw new Error('Routes.channel() wrong');
+    },
+  },
+  {
+    pkg: '@erinjs/util',
+    exercise: async (m) => {
+      if (!m.SnowflakeUtil?.isValid('0')) throw new Error('SnowflakeUtil.isValid failed');
+      const id = m.SnowflakeUtil?.snowflakeFromTimestamp?.(Date.now());
+      if (typeof id !== 'string') throw new Error('SnowflakeUtil.snowflakeFromTimestamp failed');
+    },
+  },
+  {
+    pkg: '@erinjs/collection',
+    exercise: async (m) => {
+      const coll = new m.Collection();
+      if (coll.size !== 0) throw new Error('Collection.size wrong');
+      coll.set('a', 1);
+      if (coll.get('a') !== 1) throw new Error('Collection set/get failed');
+    },
+  },
+  {
+    pkg: '@erinjs/rest',
+    exercise: async (m) => {
+      const rm = new m.RequestManager({ baseURL: 'https://example.com' });
+      if (typeof rm.request !== 'function') throw new Error('RequestManager.request missing');
+    },
+  },
+  {
+    pkg: '@erinjs/ws',
+    exercise: async (m) => {
+      if (typeof m.GatewayCloseCodes !== 'object') throw new Error('GatewayCloseCodes missing');
+      if (m.GatewayCloseCodes.Normal !== 1000) throw new Error('GatewayCloseCodes.Normal wrong');
+    },
+  },
+  {
+    pkg: '@erinjs/builders',
+    exercise: async (m) => {
+      const embed = new m.EmbedBuilder().setTitle('test').setDescription('desc');
+      const json = embed.toJSON();
+      if (json.title !== 'test' || json.description !== 'desc') {
+        throw new Error('EmbedBuilder toJSON failed');
+      }
+    },
+  },
+  {
+    pkg: '@erinjs/core',
+    exercise: async (m) => {
+      if (typeof m.Client !== 'function') throw new Error('Client missing');
+      if (typeof m.Events !== 'object') throw new Error('Events missing');
+      if (!m.Events.Ready) throw new Error('Events.Ready missing');
+    },
+  },
+  {
+    pkg: '@erinjs/voice',
+    exercise: async (m) => {
+      const mockClient = { on: () => {} };
+      const manager = m.getVoiceManager(mockClient);
+      if (!manager || typeof manager.join !== 'function') {
+        throw new Error('getVoiceManager returned invalid VoiceManager');
+      }
+    },
+  },
+];
+
+async function main() {
+  const failed = [];
+  for (const { pkg, exercise } of TESTS) {
+    try {
+      const m = await import(pkg);
+      await exercise(m);
+      console.log(`✓ ${pkg} (exercised)`);
+    } catch (err) {
+      console.error(`✗ ${pkg}:`, err.message);
+      failed.push({ pkg, err });
+    }
+  }
+  if (failed.length > 0) {
+    console.error('\nPackage export test failed for:', failed.map((f) => f.pkg).join(', '));
+    process.exit(1);
+  }
+  console.log(`\nAll ${TESTS.length} packages exercised successfully.`);
+}
+
+main();

package/core/scripts/test-smoke.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * Extended smoke test: exercises all packages repeatedly and validates core paths.
+ * Run after build to stress-test imports and basic functionality.
+ *
+ * Usage: node scripts/test-smoke.mjs
+ */
+
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+
+const iterations = 5;
+
+async function exerciseTypes() {
+  const m = await import('@erinjs/types');
+  const Routes = m.Routes;
+  if (!Routes?.channel) throw new Error('Routes.channel missing');
+  if (Routes.channel('123') !== '/channels/123') throw new Error('Routes.channel wrong');
+  if (Routes.guild('g1') !== '/guilds/g1') throw new Error('Routes.guild wrong');
+  if (Routes.gatewayBot() !== '/gateway/bot') throw new Error('Routes.gatewayBot wrong');
+}
+
+async function exerciseUtil() {
+  const m = await import('@erinjs/util');
+  if (!m.SnowflakeUtil?.isValid('0')) throw new Error('SnowflakeUtil.isValid failed');
+  const id = m.SnowflakeUtil?.snowflakeFromTimestamp?.(Date.now());
+  if (typeof id !== 'string') throw new Error('SnowflakeUtil.snowflakeFromTimestamp failed');
+  if (m.resolveColor?.(0xff0000) !== 0xff0000) throw new Error('resolveColor failed');
+  if (!m.formatColor?.(0xff0000)?.startsWith('#')) throw new Error('formatColor failed');
+  const parsed = m.parseEmoji?.('<:custom:123456789012345678>');
+  if (!parsed || parsed.id !== '123456789012345678') throw new Error('parseEmoji failed');
+}
+
+async function exerciseCollection() {
+  const m = await import('@erinjs/collection');
+  const coll = new m.Collection();
+  coll.set('a', 1);
+  coll.set('b', 2);
+  if (coll.get('a') !== 1 || coll.size !== 2) throw new Error('Collection set/get failed');
+  if (coll.first() !== 1 || coll.last() !== 2) throw new Error('Collection first/last failed');
+  if (coll.reduce((acc, v) => acc + v, 0) !== 3) throw new Error('Collection reduce failed');
+}
+
+async function exerciseRest() {
+  const m = await import('@erinjs/rest');
+  const rm = new m.RequestManager({ baseURL: 'https://example.com' });
+  if (typeof rm.request !== 'function') throw new Error('RequestManager.request missing');
+}
+
+async function exerciseWs() {
+  const m = await import('@erinjs/ws');
+  if (m.GatewayCloseCodes?.Normal !== 1000) throw new Error('GatewayCloseCodes wrong');
+}
+
+async function exerciseBuilders() {
+  const m = await import('@erinjs/builders');
+  const embed = new m.EmbedBuilder().setTitle('t').setDescription('d');
+  const json = embed.toJSON();
+  if (json.title !== 't' || json.description !== 'd') throw new Error('EmbedBuilder failed');
+  const att = new m.AttachmentBuilder(0, 'file.png', { spoiler: true });
+  if (!att.filename.startsWith('SPOILER_')) throw new Error('AttachmentBuilder spoiler failed');
+}
+
+async function exerciseCore() {
+  const m = await import('@erinjs/core');
+  if (typeof m.Client !== 'function') throw new Error('Client missing');
+  if (!m.Events?.Ready) throw new Error('Events.Ready missing');
+}
+
+async function exerciseVoice() {
+  const m = await import('@erinjs/voice');
+  const manager = m.getVoiceManager({ on: () => {} });
+  if (!manager || typeof manager.join !== 'function') throw new Error('VoiceManager failed');
+}
+
+const suites = [
+  exerciseTypes,
+  exerciseUtil,
+  exerciseCollection,
+  exerciseRest,
+  exerciseWs,
+  exerciseBuilders,
+  exerciseCore,
+  exerciseVoice,
+];
+
+async function main() {
+  let totalRuns = 0;
+  const start = Date.now();
+  for (let i = 0; i < iterations; i++) {
+    for (const suite of suites) {
+      await suite();
+      totalRuns++;
+    }
+  }
+  const elapsed = Date.now() - start;
+  console.log(`✓ Smoke test passed: ${totalRuns} suite runs in ${elapsed}ms`);
+}
+
+main().catch((err) => {
+  console.error('Smoke test failed:', err.message);
+  process.exit(1);
+});

package/core/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/core/turbo.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["pnpm-lock.yaml"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"]
+    },
+    "test": {
+      "dependsOn": ["^build"]
+    },
+    "test:coverage": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "lint": {
+      "dependsOn": []
+    },
+    "lint:fix": {
+      "dependsOn": []
+    },
+    "clean": {
+      "cache": false
+    },
+    "generate:docs": {
+      "dependsOn": ["build"],
+      "outputs": ["apps/docs-vitepress/api-data/**"]
+    }
+  }
+}

package/core/vitest.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['packages/*/src/**/*.test.ts', 'packages/*/src/**/*.spec.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'text-summary', 'html', 'lcov'],
+      include: ['packages/*/src/**/*.ts'],
+      exclude: ['**/*.test.ts', '**/*.spec.ts', '**/*.d.ts', '**/dist/**', '**/node_modules/**'],
+    },
+    outputFile: process.env.CI ? { junit: 'test-results/junit.xml' } : undefined,
+    reporters: process.env.CI ? ['default', 'junit'] : ['default'],
+  },
+});

package/core/wrangler.jsonc

@@ -0,0 +1,9 @@
+{
+  "name": "core",
+  "compatibility_date": "2025-02-15",
+  "workers_dev": true,
+  "assets": {
+    "directory": "./apps/docs/dist",
+    "not_found_handling": "single-page-application",
+  },
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@erinjs/core",
+  "version": "1.0.0",
+  "description": "A simple, powerful bot SDK.",
+  "keywords": [
+    "fluxer",
+    "bot",
+    "sdk",
+    "api"
+  ],
+  "homepage": "https://github.com/blstmo-abandoned-us-for-the-milk/core#readme",
+  "bugs": {
+    "url": "https://github.com/blstmo-abandoned-us-for-the-milk/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blstmo-abandoned-us-for-the-milk/core.git"
+  },
+  "license": "Apache-2.0",
+  "author": "vesaber, dogbone",
+  "type": "ESM",
+  "main": "index.js",
+  "scripts": {
+    "test": "turbo run test"
+  }
+}