1.0.0 • Published 11 months ago

@bryan-hoang/aoc-client v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
11 months ago

@bryan-hoang/aoc-client

npm version npm downloads bundle size license

standard-readme compliant

A TS library for Advent of Code.

It was primarily developed to build the @bryan-hoang/aoc-cli command-line tool, but it can also be integrated into other projects.

Table of Contents

Install

# ✨ Auto-detect
npx nypm install @bryan-hoang/aoc-client

# npm
npm install @bryan-hoang/aoc-client

# yarn
yarn add @bryan-hoang/aoc-client

# pnpm
pnpm install @bryan-hoang/aoc-client

# bun
bun install @bryan-hoang/aoc-client

# deno
deno install @bryan-hoang/aoc-client

Usage

Importing:

ESM (Node.js, Bun, Deno)

import { AocClientBuilder, AocClient } from "@bryan-hoang/aoc-client";

CommonJS (Legacy Node.js)

const { AocClientBuilder, AocClient } = require("@bryan-hoang/aoc-client");

CDN (Deno, Bun and Browsers)

import {
  AocClientBuilder,
  AocClient,
} from "https://esm.sh/@bryan-hoang/aoc-client";

API:

:factory: AocClientBuilder

Methods

:gear: buildClient

MethodType
buildClient() => AocClient

:gear: #validateBuild

MethodType
#validateBuild() => asserts this is this and { _sessionCookie: string; _year: number; _day: number; }

:gear: getSessionCookieFromDefaultLocations

MethodType
getSessionCookieFromDefaultLocations() => AocClientBuilder

:gear: getSessionCookieFromFile

MethodType
getSessionCookieFromFile(file: string) => AocClientBuilder

:gear: getDefaultSessionCookieFile

MethodType
getDefaultSessionCookieFile() => string

:gear: sessionCookie

MethodType
sessionCookie(sessionCookie: string) => AocClientBuilder

:gear: year

MethodType
year(year: number) => AocClientBuilder

:gear: day

MethodType
day(day: number) => AocClientBuilder

:gear: latestPuzzleDay

MethodType
latestPuzzleDay() => AocClientBuilder

:gear: latestEventYear

MethodType
latestEventYear() => AocClientBuilder

:gear: overwriteFiles

MethodType
overwriteFiles(overwriteFiles: boolean) => AocClientBuilder

:factory: AocClient

Methods

:gear: getBuilder

MethodType
getBuilder() => AocClientBuilder

:gear: ensureDayUnlocked

MethodType
ensureDayUnlocked() => void

:gear: isDayUnlocked

MethodType
isDayUnlocked() => boolean

Maintainers

@bryan-hoang

Contributing

PRs accepted.

Small note: if editing the README, please conform to the standard-readme specification.

License

MIT © 2024 Bryan Hoang


🤖 auto updated with automd