@mikulogin/core 1.0.0

package/dist/crypto.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Meng-hash password teks polos menggunakan algoritma bcrypt.
+ * @param password Password teks polos yang akan di-hash.
+ * @returns Promise yang menghasilkan string hash bcrypt.
+ * @throws Error jika password kosong atau bukan string valid.
+ */
+export declare function hashPassword(password: string): Promise<string>;
+/**
+ * Memverifikasi apakah password teks polos sesuai dengan hash bcrypt yang tersimpan.
+ * Memiliki penanganan kegagalan eksplisit (Anti Happy-Path) untuk input invalid.
+ * @param password Password teks polos dari input pengguna.
+ * @param hash Hash bcrypt tersimpan yang akan dibandingkan.
+ * @returns Promise<boolean> true jika cocok, false jika tidak cocok atau format hash invalid.
+ */
+export declare function verifyPassword(password: string, hash: string): Promise<boolean>;
+/**
+ * Menghasilkan token sesi acak yang aman secara kriptografis (32 byte hex = 64 karakter).
+ * @returns String token sesi acak.
+ */
+export declare function generateSessionToken(): string;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAerF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/crypto.js

@@ -0,0 +1,45 @@
+import bcrypt from "bcryptjs";
+import crypto from "node:crypto";
+/**
+ * Meng-hash password teks polos menggunakan algoritma bcrypt.
+ * @param password Password teks polos yang akan di-hash.
+ * @returns Promise yang menghasilkan string hash bcrypt.
+ * @throws Error jika password kosong atau bukan string valid.
+ */
+export async function hashPassword(password) {
+    if (!password || typeof password !== "string" || password.trim().length === 0) {
+        throw new Error("Password tidak boleh kosong");
+    }
+    const saltRounds = 10;
+    return await bcrypt.hash(password, saltRounds);
+}
+/**
+ * Memverifikasi apakah password teks polos sesuai dengan hash bcrypt yang tersimpan.
+ * Memiliki penanganan kegagalan eksplisit (Anti Happy-Path) untuk input invalid.
+ * @param password Password teks polos dari input pengguna.
+ * @param hash Hash bcrypt tersimpan yang akan dibandingkan.
+ * @returns Promise<boolean> true jika cocok, false jika tidak cocok atau format hash invalid.
+ */
+export async function verifyPassword(password, hash) {
+    if (!password || typeof password !== "string" || password.trim().length === 0) {
+        return false;
+    }
+    if (!hash || typeof hash !== "string" || hash.trim().length === 0) {
+        return false;
+    }
+    try {
+        return await bcrypt.compare(password, hash);
+    }
+    catch (_error) {
+        // Menangani kasus jika format hash tidak valid (misal bukan format bcrypt)
+        return false;
+    }
+}
+/**
+ * Menghasilkan token sesi acak yang aman secara kriptografis (32 byte hex = 64 karakter).
+ * @returns String token sesi acak.
+ */
+export function generateSessionToken() {
+    return crypto.randomBytes(32).toString("hex");
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAY;IACjE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,2EAA2E;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./crypto.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./crypto.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Interface User merepresentasikan entitas pengguna dalam sistem mikulogin.
+ * Menyimpan data dasar pengguna termasuk identitas, email, hash kata sandi, dan timestamp.
+ */
+export interface User {
+    id: string;
+    email: string;
+    passwordHash: string;
+    name: string | null;
+    createdAt: Date;
+}
+/**
+ * Interface Session merepresentasikan sesi aktif yang dimiliki pengguna.
+ * Menghubungkan token sesi dengan userId dan waktu kadaluarsa (expiresAt).
+ */
+export interface Session {
+    id: string;
+    userId: string;
+    expiresAt: Date;
+    token: string;
+}
+/**
+ * Interface DatabaseAdapter didefinisikan sebagai kontrak abstraksi
+ * Bring Your Own Database (BYOD) yang harus diimplementasikan oleh adapter database.
+ */
+export interface DatabaseAdapter {
+    /**
+     * Mengambil data pengguna berdasarkan alamat email.
+     * @param email Alamat email pengguna.
+     * @returns Pengguna jika ditemukan, atau null jika tidak ada.
+     */
+    getUserByEmail(email: string): Promise<User | null>;
+    /**
+     * Membuat pengguna baru dalam database.
+     * @param data Data pengguna tanpa id dan createdAt (dihasilkan otomatis oleh adapter/DB).
+     * @returns Pengguna yang berhasil dibuat.
+     */
+    createUser(data: Omit<User, "id" | "createdAt">): Promise<User>;
+    /**
+     * Membuat sesi pengguna baru dalam database.
+     * @param userId ID pengguna pemilik sesi.
+     * @param token Token acak unik untuk identifikasi sesi.
+     * @param expiresAt Waktu sesi akan kadaluarsa.
+     * @returns Sesi yang berhasil dibuat.
+     */
+    createSession(userId: string, token: string, expiresAt: Date): Promise<Session>;
+    /**
+     * Validasi token sesi dan ambil data sesi beserta penggunanya sekaligus.
+     * @param token Token sesi yang dikirim oleh klien.
+     * @returns Objek berisi session dan user jika token valid, atau null jika tidak ditemukan/kadaluarsa.
+     */
+    getSessionAndUser(token: string): Promise<{
+        session: Session;
+        user: User;
+    } | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhF;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACpF"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@mikulogin/core",
+  "version": "1.0.0",
+  "description": "Komponen inti autentikasi Mikulogin yang menyediakan tipe antarmuka (interface) dan fungsi kriptografi dasar.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./crypto": {
+      "types": "./dist/crypto.d.ts",
+      "import": "./dist/crypto.js",
+      "default": "./dist/crypto.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "mikulogin",
+    "core",
+    "auth",
+    "types",
+    "crypto"
+  ],
+  "license": "ISC"
+}