swcombine.js 0.0.10 → 0.1.0

package/dist/src/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility functions and classes
+ */
+export { Timestamp } from "./timestamp.ts";
+export type { TimestampMoment, Duration, TimestampFormat, TimestampUnit, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,YAAY,EACV,eAAe,EACf,QAAQ,EACR,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/src/utils/timestamp.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Timestamp utility for working with Star Wars Combine Combine Galactic Time (CGT)
+ */
+import type { TimestampMoment, Duration, TimestampFormat, TimestampUnit } from "./types.ts";
+/**
+ * Utility class for working with Star Wars Combine timestamps.
+ * Represents Combine Galactic Time and can convert unix timestamps
+ * and Date objects to/from CGT.
+ *
+ * @example
+ * ```typescript
+ * // Get current CGT
+ * const now = Timestamp.now();
+ *
+ * // Create from Unix timestamp
+ * const ts = Timestamp.fromUnixTimestamp(1735920000);
+ *
+ * // Create from Date
+ * const ts2 = Timestamp.fromDate(new Date());
+ *
+ * // Create specific moment
+ * const ts3 = new Timestamp({ year: 25, day: 60, hour: 12 });
+ *
+ * // Format as string
+ * console.log(now.toString("full")); // "Year 27 Day 134, 8:45:23"
+ * ```
+ */
+export declare class Timestamp {
+    /**
+     * SWC start date (December 3, 1998 at 07:00:00 UTC)
+     */
+    private static readonly swcStart;
+    protected year: number;
+    protected day: number;
+    protected hour: number;
+    protected minute: number;
+    protected second: number;
+    /**
+     * Create a new Timestamp object for a specific moment in Combine Galactic Time
+     *
+     * @param source - Moment in CGT (year, day, and optionally hour, minute, second)
+     */
+    constructor(source: TimestampMoment);
+    /**
+     * Convert a unix timestamp to Combine Galactic Time
+     *
+     * @param unixTimestamp - Unix timestamp (seconds or milliseconds, auto-detected)
+     * @returns Timestamp instance representing the CGT moment
+     */
+    static fromUnixTimestamp(unixTimestamp: number): Timestamp;
+    /**
+     * Convert a Date object into Combine Galactic Time
+     *
+     * @param date - JavaScript Date object
+     * @returns Timestamp instance representing the CGT moment
+     */
+    static fromDate(date: Date): Timestamp;
+    /**
+     * Get the current Combine Galactic Time
+     *
+     * @returns Timestamp instance representing the current CGT moment
+     */
+    static now(): Timestamp;
+    /**
+     * Calculate CGT from milliseconds since SWC start
+     *
+     * @param msSinceSwcStart - Milliseconds since SWC start date
+     * @returns Timestamp instance
+     */
+    private static calculateTimestampFromMillisecondsSinceStart;
+    /**
+     * Convert the CGT timestamp into a unix timestamp
+     *
+     * @param unit - Output unit (seconds or milliseconds)
+     * @returns Unix timestamp
+     */
+    toUnixTimestamp(unit: TimestampUnit): number;
+    /**
+     * Convert the CGT timestamp into a Date object
+     *
+     * @returns JavaScript Date object
+     */
+    toDate(): Date;
+    /**
+     * Get the timestamp as a TimestampMoment object
+     *
+     * @returns TimestampMoment representation
+     */
+    asMoment(): TimestampMoment;
+    /**
+     * Get the year component
+     *
+     * @returns Year in CGT
+     */
+    getYear(): number;
+    /**
+     * Get the day component
+     *
+     * @returns Day of the year (1-365)
+     */
+    getDay(): number;
+    /**
+     * Get the hour component
+     *
+     * @returns Hour of the day (0-23)
+     */
+    getHour(): number;
+    /**
+     * Get the minute component
+     *
+     * @returns Minute of the hour (0-59)
+     */
+    getMinute(): number;
+    /**
+     * Get the second component
+     *
+     * @returns Second of the minute (0-59)
+     */
+    getSecond(): number;
+    /**
+     * Calculate a new timestamp by adding time to this timestamp
+     *
+     * @param duration - Duration to add (partial duration allowed)
+     * @returns New Timestamp with added duration
+     */
+    add(duration: Partial<Duration>): Timestamp;
+    /**
+     * Calculate a new timestamp by subtracting time from this timestamp
+     *
+     * @param duration - Duration to subtract (partial duration allowed)
+     * @returns New Timestamp with subtracted duration (won't go before SWC start)
+     */
+    subtract(duration: Partial<Duration>): Timestamp;
+    /**
+     * Calculate the duration from this timestamp to another timestamp
+     *
+     * @param otherTimestamp - Target timestamp
+     * @returns Duration between timestamps (positive if other is in future)
+     */
+    getDurationTo(otherTimestamp: Timestamp): Duration;
+    /**
+     * Convert the CGT timestamp to a string
+     *
+     * You can either pass in a preset name, or a custom format string.
+     *
+     * **Preset formats:**
+     * - `'full'`: Year 25 Day 60, 6:03:12
+     * - `'minute'`: Year 25 Day 60, 6:03
+     * - `'day'`: Year 25 Day 60
+     * - `'shortFull'`: Y25 D60, 6:03:12
+     * - `'shortMinute'`: Y25 D60, 6:03
+     * - `'shortDay'`: Y26 D60
+     *
+     * **Custom format tags:**
+     * - `{y}`: year
+     * - `{d}`: day
+     * - `{h}`: hour
+     * - `{m}`: minute
+     * - `{s}`: second
+     * - Double the tag for leading zeroes (e.g., `{hh}` = 08)
+     * - `{hms}`: shorthand for `{hh}:{mm}:{ss}`
+     *
+     * @param format - Preset format name or custom format string
+     * @returns Formatted timestamp string
+     *
+     * @example
+     * ```typescript
+     * const ts = new Timestamp({ year: 25, day: 6, hour: 8, minute: 12, second: 14 });
+     * ts.toString("full"); // "Year 25 Day 6, 8:12:14"
+     * ts.toString("{hms} on Day {d} of Year {y}"); // "08:12:14 on Day 6 of Year 25"
+     * ```
+     */
+    toString(format?: TimestampFormat | string): string;
+    /**
+     * Substitute a format tag with its value
+     *
+     * @param tag - Format tag (e.g., "y", "yy", "hms")
+     * @returns Substituted value
+     */
+    private substituteTag;
+    /**
+     * Calculate milliseconds since SWC start from this timestamp
+     *
+     * @returns Milliseconds since SWC start date
+     */
+    private calculateMillisecondsSinceStartFromTimestamp;
+}
+//# sourceMappingURL=timestamp.d.ts.map

package/dist/src/utils/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAE5E,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAUnC;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS;IAW1D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAMtC;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,SAAS;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,4CAA4C;IAiC3D;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAY5C;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAOd;;;;OAIG;IACH,QAAQ,IAAI,eAAe;IAU3B;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS;IAO3C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS;IAUhD;;;;;OAKG;IACH,aAAa,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ;IAOlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,MAAM,GAAE,eAAe,GAAG,MAAe,GAAG,MAAM;IAoD3D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAuCrB;;;;OAIG;IACH,OAAO,CAAC,4CAA4C;CAgBrD"}

package/dist/src/utils/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Timestamp utility types
+ */
+/**
+ * Represents a moment in Combine Galactic Time
+ */
+export interface TimestampMoment {
+    /** Year in CGT */
+    year: number;
+    /** Day of the year (1-365) */
+    day: number;
+    /** Hour of the day (0-23) */
+    hour?: number;
+    /** Minute of the hour (0-59) */
+    minute?: number;
+    /** Second of the minute (0-59) */
+    second?: number;
+}
+/**
+ * Duration between two timestamps
+ */
+export interface Duration {
+    /** Number of years */
+    years: number;
+    /** Number of days */
+    days: number;
+    /** Number of hours */
+    hours: number;
+    /** Number of minutes */
+    minutes: number;
+    /** Number of seconds */
+    seconds: number;
+}
+/**
+ * Timestamp format presets
+ */
+export type TimestampFormat = "full" | "minute" | "day" | "shortFull" | "shortMinute" | "shortDay";
+/**
+ * Unix timestamp units
+ */
+export type TimestampUnit = "sec" | "ms" | "seconds" | "milliseconds";
+//# sourceMappingURL=types.d.ts.map

package/dist/src/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,KAAK,GACL,WAAW,GACX,aAAa,GACb,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAAC"}

package/package.json

@@ -1,74 +1,54 @@
 {
   "name": "swcombine.js",
-  "version": "0.0.10",
-  "description": "",
-  "keywords": [
-    "swcombine",
-    "sdk"
-  ],
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Star Wars Combine API",
+  "author": "Your Name",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "default": "./dist/index.esm.js",
-        "types": "./dist/index.d.ts"
-      },
-      "require": {
-        "default": "./dist/index.cjs.js",
-        "types": "./dist/index.d.ts"
-      }
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
-  "type": "module",
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.esm.js",
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
-  "contributors": [
-    {
-      "name": "kaelon",
-      "email": "j.dekoning141@gmail.com"
-    },
-    {
-      "name": "karnthis",
-      "email": "me@erinrivas.com"
-    }
+  "keywords": [
+    "swc",
+    "star-wars-combine",
+    "api",
+    "sdk",
+    "typescript",
+    "oauth",
+    "oauth2"
   ],
-  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/swc-unnamed/swcombine-js.git"
+    "url": "https://github.com/swc-unnamed/swcombine-js"
   },
   "bugs": {
     "url": "https://github.com/swc-unnamed/swcombine-js/issues"
   },
-  "homepage": "https://github.com/swc-unnamed/swcombine-js/#README",
+  "homepage": "https://github.com/swc-unnamed/swcombine-js#readme",
+  "scripts": {
+    "test": "bun test",
+    "build": "bun run build:clean && bun run build:types && bun run build:bundle",
+    "build:clean": "rm -rf dist",
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly",
+    "build:bundle": "bun build index.ts --outdir dist --target node --format esm --minify --sourcemap=external",
+    "prepublishOnly": "bun run build",
+    "example:oauth": "bun run examples/oauth-flow.ts"
+  },
   "devDependencies": {
-    "@eslint/js": "^9.19.0",
-    "@rollup/plugin-commonjs": "^28.0.2",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/node": "^22.13.0",
-    "@vitest/coverage-v8": "^3.0.4",
-    "eslint": "^9.19.0",
-    "eslint-config-prettier": "^10.0.1",
-    "eslint-plugin-prettier": "^5.2.3",
-    "jiti": "^2.4.2",
-    "prettier": "^3.4.2",
-    "rollup-plugin-node-externals": "^8.0.0",
-    "rollup-plugin-typescript-paths": "^1.5.0",
-    "tslib": "^2.8.1",
-    "typedoc": "^0.27.6",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.22.0",
-    "vite": "^6.0.11",
-    "vite-plugin-dts": "^4.5.0",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.0.4"
+    "@types/bun": "latest",
+    "typescript": "^5"
   },
-  "scripts": {
-    "build": "tsc && vite build",
-    "packit": "npm run build && npm pack --pack-destination packs",
-    "gen-docs": "npx typedoc",
-    "test": "vitest"
+  "engines": {
+    "node": ">=18"
   }
 }