@erinjs/core 1.0.0 → 1.2.4

package/core/packages/builders/src/messages/MessagePayload.ts

@@ -1,122 +0,0 @@
-import { APIEmbed, APIMessageReference } from '@erinjs/types';
-import { EmbedBuilder } from './EmbedBuilder.js';
-import { AttachmentBuilder } from './AttachmentBuilder.js';
-
-/** Data for a message payload (content, embeds, reply reference, etc.). */
-export interface MessagePayloadData {
-  content?: string | null;
-  embeds?: APIEmbed[] | null;
-  attachments?: Array<{ id: number; filename: string; description?: string | null }>;
-  message_reference?: APIMessageReference | null;
-  tts?: boolean;
-  flags?: number;
-}
-
-const CONTENT_MAX = 2000;
-const EMBEDS_MAX = 10;
-
-/** Builder for message payloads. Use with `channel.send()` or `message.reply()`. */
-export class MessagePayload {
-  public static readonly ContentMaxLength = CONTENT_MAX;
-
-  public readonly data: MessagePayloadData = {};
-
-  /** Set message text. Max 2000 characters. */
-  setContent(content: string | null): this {
-    if (content !== null && content.length > CONTENT_MAX)
-      throw new RangeError(`Content must be ≤${CONTENT_MAX} characters`);
-    this.data.content = content ?? undefined;
-    return this;
-  }
-
-  /** Set embeds. Max 10. Replaces existing. */
-  setEmbeds(embeds: (APIEmbed | EmbedBuilder)[] | null): this {
-    if (!embeds?.length) {
-      this.data.embeds = undefined;
-      return this;
-    }
-    if (embeds.length > EMBEDS_MAX) throw new RangeError(`Embeds must be ≤${EMBEDS_MAX}`);
-    this.data.embeds = embeds.map((e) => (e instanceof EmbedBuilder ? e.toJSON() : e));
-    return this;
-  }
-
-  /** Add one embed. Max 10 total. */
-  addEmbed(embed: APIEmbed | EmbedBuilder): this {
-    const list = (this.data.embeds ?? []).slice();
-    if (list.length >= EMBEDS_MAX) throw new RangeError(`Embeds must be ≤${EMBEDS_MAX}`);
-    list.push(embed instanceof EmbedBuilder ? embed.toJSON() : embed);
-    this.data.embeds = list;
-    return this;
-  }
-
-  /** Set attachment metadata (for files sent with the request). */
-  setAttachments(
-    attachments: Array<
-      AttachmentBuilder | { id: number; filename: string; description?: string | null }
-    > | null,
-  ): this {
-    if (!attachments?.length) {
-      this.data.attachments = undefined;
-      return this;
-    }
-    this.data.attachments = attachments.map((a) =>
-      a instanceof AttachmentBuilder ? a.toJSON() : a,
-    );
-    return this;
-  }
-
-  /** Set reply reference (creates a reply to another message). */
-  setReply(
-    reference:
-      | { channel_id: string; message_id: string; guild_id?: string | null }
-      | APIMessageReference
-      | null,
-  ): this {
-    if (!reference) {
-      this.data.message_reference = undefined;
-      return this;
-    }
-    this.data.message_reference = {
-      channel_id: reference.channel_id,
-      message_id: reference.message_id,
-      guild_id: reference.guild_id ?? undefined,
-    };
-    return this;
-  }
-
-  /** Enable text-to-speech. */
-  setTTS(tts: boolean): this {
-    this.data.tts = tts;
-    return this;
-  }
-
-  /** Set message flags (e.g. ephemeral, suppress embeds). */
-  setFlags(flags: number): this {
-    this.data.flags = flags;
-    return this;
-  }
-
-  /** Get the payload as a plain object. */
-  toJSON(): MessagePayloadData {
-    return { ...this.data };
-  }
-
-  /** Create a MessagePayload from a string or options object. */
-  static create(contentOrOptions?: string | MessagePayloadData): MessagePayload {
-    const payload = new MessagePayload();
-    if (typeof contentOrOptions === 'string') {
-      payload.setContent(contentOrOptions);
-    } else if (contentOrOptions && typeof contentOrOptions === 'object') {
-      if (contentOrOptions.content !== undefined)
-        payload.setContent(contentOrOptions.content ?? null);
-      if (contentOrOptions.embeds?.length) payload.setEmbeds(contentOrOptions.embeds);
-      if (contentOrOptions.attachments?.length)
-        payload.setAttachments(contentOrOptions.attachments);
-      if (contentOrOptions.message_reference)
-        payload.setReply(contentOrOptions.message_reference as APIMessageReference);
-      if (contentOrOptions.tts !== undefined) payload.setTTS(contentOrOptions.tts);
-      if (contentOrOptions.flags !== undefined) payload.setFlags(contentOrOptions.flags);
-    }
-    return payload;
-  }
-}

package/core/packages/builders/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "noEmit": false
-  },
-  "include": ["src/**/*"]
-}

package/core/packages/builders/tsup.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['cjs', 'esm'],
-  dts: true,
-  splitting: false,
-  clean: true,
-});

package/core/packages/builders/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['src/**/*.test.ts'],
-  },
-});

package/core/packages/collection/package.json

@@ -1,47 +0,0 @@
-{
-  "name": "@erinjs/collection",
-  "publishConfig": {
-    "access": "public"
-  },
-  "version": "1.2.4",
-  "description": "Extended Map with utility methods for @erinjs/core",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/blstmo-abandoned-us-for-the-milk/core.git",
-    "directory": "packages/collection"
-  },
-  "bugs": "https://github.com/blstmo-abandoned-us-for-the-milk/core/issues",
-  "homepage": "https://github.com/blstmo-abandoned-us-for-the-milk/core#readme",
-  "keywords": [
-    "fluxer",
-    "collection",
-    "map"
-  ],
-  "license": "Apache-2.0",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "lint": "eslint src --max-warnings 0 --config ../../eslint.config.js",
-    "lint:fix": "eslint src --fix --config ../../eslint.config.js",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage"
-  },
-  "devDependencies": {
-    "tsup": "^8.3.0",
-    "typescript": "^5.6.0",
-    "vitest": "^4.0.18"
-  }
-}

package/core/packages/collection/src/Collection.test.ts

@@ -1,232 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { Collection } from './Collection.js';
-
-describe('Collection', () => {
-  it('creates empty collection', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.size).toBe(0);
-  });
-
-  it('first returns undefined for empty', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.first()).toBeUndefined();
-  });
-
-  it('first returns first value', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.first()).toBe(1);
-  });
-
-  it('first(amount) returns first n values', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.first(2)).toEqual([1, 2]);
-  });
-
-  it('last returns last value', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.last()).toBe(3);
-  });
-
-  it('random returns undefined for empty', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.random()).toBeUndefined();
-  });
-
-  it('find returns matching value', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.find((v) => v === 2)).toBe(2);
-  });
-
-  it('filter returns matching subset', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    const filtered = coll.filter((v) => v > 1);
-    expect(filtered.size).toBe(2);
-    expect(filtered.get('b')).toBe(2);
-    expect(filtered.get('c')).toBe(3);
-  });
-
-  it('map transforms values', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    expect(coll.map((v) => v * 2)).toEqual([2, 4]);
-  });
-
-  it('reduce accumulates', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.reduce((acc, v) => acc + v, 0)).toBe(6);
-  });
-
-  it('findKey returns matching key', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.findKey((v) => v === 2)).toBe('b');
-    expect(coll.findKey((v) => v === 99)).toBeUndefined();
-  });
-
-  it('some returns true when any element matches', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    expect(coll.some((v) => v === 2)).toBe(true);
-    expect(coll.some((v) => v === 99)).toBe(false);
-  });
-
-  it('every returns true when all match', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    expect(coll.every((v) => v > 0)).toBe(true);
-    expect(coll.every((v) => v > 1)).toBe(false);
-  });
-
-  it('partition splits into pass/fail collections', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    const [pass, fail] = coll.partition((v) => v >= 2);
-    expect(pass.size).toBe(2);
-    expect(fail.size).toBe(1);
-    expect(pass.get('b')).toBe(2);
-    expect(pass.get('c')).toBe(3);
-    expect(fail.get('a')).toBe(1);
-  });
-
-  it('clone creates shallow copy', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    const clone = coll.clone();
-    expect(clone.size).toBe(coll.size);
-    expect(clone.get('a')).toBe(1);
-    clone.set('a', 99);
-    expect(coll.get('a')).toBe(1); // original unchanged
-  });
-
-  it('concat merges collections', () => {
-    const a = new Collection<string, number>([['x', 1]]);
-    const b = new Collection<string, number>([
-      ['y', 2],
-      ['z', 3],
-    ]);
-    const c = a.concat(b);
-    expect(c.size).toBe(3);
-    expect(c.get('x')).toBe(1);
-    expect(c.get('y')).toBe(2);
-    expect(c.get('z')).toBe(3);
-  });
-
-  it('last(amount) returns last n values', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    expect(coll.last(2)).toEqual([2, 3]);
-  });
-
-  it('tap invokes fn and returns this', () => {
-    const coll = new Collection<string, number>([['a', 1]]);
-    let tapped = false;
-    const result = coll.tap(() => {
-      tapped = true;
-    });
-    expect(tapped).toBe(true);
-    expect(result).toBe(coll);
-  });
-
-  it('toString returns Collection(n)', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    expect(coll.toString()).toBe('Collection(2)');
-  });
-
-  it('first(0) and last(0) return empty array', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    expect(coll.first(0)).toEqual([]);
-    expect(coll.last(0)).toEqual([]);
-  });
-
-  it('random(amount) returns requested count without duplicates', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-      ['c', 3],
-    ]);
-    const result = coll.random(2);
-    expect(result).toHaveLength(2);
-    expect(new Set(result).size).toBe(2);
-  });
-
-  it('random(amount) when amount exceeds size returns all', () => {
-    const coll = new Collection<string, number>([
-      ['a', 1],
-      ['b', 2],
-    ]);
-    const result = coll.random(5);
-    expect(result).toHaveLength(2);
-  });
-
-  it('sort orders by compareFn', () => {
-    const coll = new Collection<string, number>([
-      ['c', 3],
-      ['a', 1],
-      ['b', 2],
-    ]);
-    coll.sort((a, b) => a - b);
-    expect(coll.toJSON()).toEqual([1, 2, 3]);
-  });
-
-  it('last returns undefined for empty', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.last()).toBeUndefined();
-  });
-
-  it('every returns true for empty', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.every(() => true)).toBe(true);
-  });
-
-  it('some returns false for empty', () => {
-    const coll = new Collection<string, number>();
-    expect(coll.some(() => true)).toBe(false);
-  });
-});

package/core/packages/collection/src/Collection.ts

@@ -1,196 +0,0 @@
-/**
- * Extended Map with utility methods for key-value collections.
- * Similar to discord.js Collection.
- */
-export class Collection<K, V> extends Map<K, V> {
-  /**
-   * Obtains the first value(s) in this collection.
-   * @param amount - Amount of values to obtain (optional)
-   */
-  first(): V | undefined;
-  first(amount: number): V[];
-  first(amount?: number): V | V[] | undefined {
-    if (amount === undefined) return this.values().next().value;
-    const arr = this.toJSON();
-    if (amount <= 0) return [];
-    return arr.slice(0, amount);
-  }
-
-  /**
-   * Obtains the last value(s) in this collection.
-   * @param amount - Amount of values to obtain (optional)
-   */
-  last(): V | undefined;
-  last(amount: number): V[];
-  last(amount?: number): V | V[] | undefined {
-    const arr = this.toJSON();
-    if (amount === undefined) return arr[arr.length - 1];
-    if (amount <= 0) return [];
-    return arr.slice(-amount);
-  }
-
-  /**
-   * Returns a random value from this collection.
-   * @param amount - Amount of values to randomly obtain (optional)
-   */
-  random(): V | undefined;
-  random(amount: number): V[];
-  random(amount?: number): V | V[] | undefined {
-    const arr = this.toJSON();
-    if (arr.length === 0) return amount === undefined ? undefined : [];
-    if (amount === undefined) return arr[Math.floor(Math.random() * arr.length)]!;
-    const copy = [...arr];
-    const result: V[] = [];
-    for (let i = 0; i < Math.min(amount, arr.length); i++) {
-      const index = Math.floor(Math.random() * copy.length);
-      result.push(copy.splice(index, 1)[0]!);
-    }
-    return result;
-  }
-
-  /**
-   * Searches for a single item where the given function returns a truthy value.
-   */
-  find(fn: (value: V, key: K) => boolean): V | undefined {
-    for (const [key, value] of this) {
-      if (fn(value, key)) return value;
-    }
-    return undefined;
-  }
-
-  /**
-   * Returns the key of the first item where the given function returns a truthy value.
-   */
-  findKey(fn: (value: V, key: K) => boolean): K | undefined {
-    for (const [key, value] of this) {
-      if (fn(value, key)) return key;
-    }
-    return undefined;
-  }
-
-  /**
-   * Creates a new collection with all elements that pass the test implemented by the provided function.
-   */
-  filter(fn: (value: V, key: K) => boolean): Collection<K, V> {
-    const result = new Collection<K, V>();
-    for (const [key, value] of this) {
-      if (fn(value, key)) result.set(key, value);
-    }
-    return result;
-  }
-
-  /**
-   * Creates a new array with the results of calling the provided function on every element.
-   */
-  map<T>(fn: (value: V, key: K) => T): T[] {
-    const result: T[] = [];
-    for (const [key, value] of this) {
-      result.push(fn(value, key));
-    }
-    return result;
-  }
-
-  /**
-   * Tests whether at least one element passes the test implemented by the provided function.
-   */
-  some(fn: (value: V, key: K) => boolean): boolean {
-    for (const [key, value] of this) {
-      if (fn(value, key)) return true;
-    }
-    return false;
-  }
-
-  /**
-   * Tests whether all elements pass the test implemented by the provided function.
-   */
-  every(fn: (value: V, key: K) => boolean): boolean {
-    for (const [key, value] of this) {
-      if (!fn(value, key)) return false;
-    }
-    return true;
-  }
-
-  /**
-   * Applies a function against an accumulator and each element to reduce the collection to a single value.
-   */
-  reduce<T>(fn: (accumulator: T, value: V, key: K) => T, initialValue: T): T {
-    let acc = initialValue;
-    for (const [key, value] of this) {
-      acc = fn(acc, value, key);
-    }
-    return acc;
-  }
-
-  /**
-   * Partitions the collection into two collections: one that passes the predicate and one that fails.
-   */
-  partition(fn: (value: V, key: K) => boolean): [Collection<K, V>, Collection<K, V>] {
-    const pass = new Collection<K, V>();
-    const fail = new Collection<K, V>();
-    for (const [key, value] of this) {
-      if (fn(value, key)) pass.set(key, value);
-      else fail.set(key, value);
-    }
-    return [pass, fail];
-  }
-
-  /**
-   * Invokes the given function and returns this collection (for chaining).
-   */
-  tap(fn: (collection: this) => void): this {
-    fn(this);
-    return this;
-  }
-
-  /**
-   * Creates an identical shallow copy of this collection.
-   */
-  clone(): Collection<K, V> {
-    return new Collection(this);
-  }
-
-  /**
-   * Combines this collection with others into a new collection.
-   */
-  concat(...collections: ReadonlyCollection<K, V>[]): Collection<K, V> {
-    const result = this.clone();
-    for (const coll of collections) {
-      for (const [key, value] of coll) result.set(key, value);
-    }
-    return result;
-  }
-
-  /**
-   * Sorts the collection in place and returns it.
-   */
-  sort(compareFn?: (a: V, b: V, aKey: K, bKey: K) => number): this {
-    const entries = [...this.entries()].sort((a, b) => {
-      if (compareFn) return compareFn(a[1], b[1], a[0], b[0]);
-      return 0;
-    });
-    this.clear();
-    for (const [key, value] of entries) {
-      this.set(key, value);
-    }
-    return this;
-  }
-
-  /**
-   * Returns an array of the values in this collection.
-   */
-  toJSON(): V[] {
-    return [...this.values()];
-  }
-
-  /**
-   * Returns a string representation of the collection (array of values).
-   */
-  override toString(): string {
-    return `Collection(${this.size})`;
-  }
-}
-
-/**
- * Read-only view of a Collection (e.g. for method return types).
- */
-export type ReadonlyCollection<K, V> = Omit<Collection<K, V>, 'set' | 'delete' | 'clear'>;

package/core/packages/collection/src/index.ts

@@ -1 +0,0 @@
-export { Collection, type ReadonlyCollection } from './Collection.js';

package/core/packages/collection/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "noEmit": false
-  },
-  "include": ["src/**/*"]
-}

package/core/packages/collection/tsup.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['cjs', 'esm'],
-  dts: true,
-  splitting: false,
-  clean: true,
-});

package/core/packages/collection/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['src/**/*.test.ts'],
-  },
-});

package/core/packages/docgen/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "@erinjs/docgen",
-  "version": "1.2.4",
-  "private": true,
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "lint": "eslint src --max-warnings 0 --config ../../eslint.config.js",
-    "lint:fix": "eslint src --fix --config ../../eslint.config.js",
-    "test": "vitest run --passWithNoTests",
-    "test:coverage": "vitest run --coverage --passWithNoTests"
-  },
-  "dependencies": {
-    "doctrine": "^3.0.0",
-    "typescript": "^5.6.0"
-  },
-  "devDependencies": {
-    "@types/doctrine": "^0.0.9",
-    "@types/node": "^20.0.0",
-    "tsup": "^8.3.0",
-    "typescript": "^5.6.0"
-  }
-}