@haloduck/core 1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# @haloduck/core
+
+HaloDuck Core Library는 Angular 기반 애플리케이션을 위한 핵심 라이브러리입니다.
+
+## 설치
+
+```bash
+npm install @haloduck/core
+```
+
+## 설치 후
+### Copy scripts
+Copy script files to `scripts` folder in the root folder.
+```bash
+npx haloduck-copy-scripts
+```
+### Update `package.json`
+```bash
+"scripts": {
+  ...
+  "prebuild": "ts-node scripts/generate-build-timestamp.ts"
+}
+```
+## 주요 기능
+
+- **인증 서비스**: AWS Amplify 기반 인증 관리
+- **API 서비스**: RESTful API 통신을 위한 기본 서비스
+- **상태 관리**: NgRx 기반 전역 상태 관리
+- **가드**: 라우트 보호를 위한 인증 가드
+- **인터셉터**: HTTP 요청/응답 처리
+- **파이프**: 데이터 변환을 위한 유틸리티 파이프
+- **모델**: 타입 정의 및 인터페이스
+
+## 사용법
+
+### 기본 설정
+
+```typescript
+Amplify.configure({
+  Auth: {
+    Cognito: awsCognito as CognitoUserPoolConfig,
+  },
+});
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    // ...
+    provideHttpClient(
+      withInterceptors([idTokenInterceptor, dummyMemberIdInterceptor]),
+    ),
+    // ...
+    provideStore({
+      global: globalReducer,
+    }),
+    provideEffects(GlobalEffects),
+    provideStoreDevtools({ maxAge: 25, logOnly: !isDevMode() }),
+    // ...
+    provideQuillConfig({
+      modules: {
+        syntax: false,
+      },
+    }),
+    // ... 
+    provideServiceWorker('ngsw-worker.js', {
+      enabled: environment.usePwa,
+      registrationStrategy: 'registerWhenStable:30000',
+    }),
+    // ...
+    provideTransloco({
+      config: {
+        availableLangs: ['en', 'ko', 'ja'],
+        defaultLang: 'en',
+        // Remove this option if your application doesn't support changing language in runtime.
+        reRenderOnLangChange: true,
+        prodMode: !isDevMode(),
+      },
+      loader: TranslocoHttpLoader,
+    }),
+    provideHaloduckTransloco(),
+    // ...
+    provideHaloduckCoreConfig({
+      stage: environment.stage,
+      appName: environment.appName,
+      defaultLanguage: 'en',
+      dateFormat: {
+        long: 'yyyy-MM-dd',
+        short: 'yyMMdd',
+      },
+      apiUrl: environment.service.apiUrl,
+      cdnUrl: environment.service.cdnUrl,
+      map: {
+        googleApiKey: environment.service.google.apiKey,
+        mapId: environment.service.google.id,
+        defaultLngLat: environment.service.google.defaultLngLat,
+      },
+    }),
+    /// ...
+  ],
+};
+
+```
+
+## 의존성
+
+- Angular 19.2.0+
+- RxJS 7.8.0+
+- NgRx 19.0.0+
+- AWS Amplify 6.12.1+
+
+## 라이선스
+
+MIT License
+
+## 지원
+
+이슈나 질문이 있으시면 [GitHub Issues](https://github.com/haloduck/haloduck-frontend/issues)에 등록해 주세요.

package/assets/scripts/generate-build-timestamp.ts

@@ -0,0 +1,12 @@
+const fs = require('fs');
+const path = require('path');
+
+const now = new Date();
+const timestamp = now.toISOString();
+
+const content = `export const BUILD_TIMESTAMP = '${timestamp}';\n`;
+
+const filePath = path.join(__dirname, './build-timestamp.ts');
+fs.writeFileSync(filePath, content);
+
+console.log('✅ Build timestamp generated:', timestamp);

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@haloduck/core",
+  "version": "1.0.0",
+  "description": "HaloDuck Core Library - Angular 기반 핵심 라이브러리",
+  "keywords": ["angular", "haloduck", "core", "library", "typescript"],
+  "author": "HaloDuck",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/haloduck/haloduck-frontend.git"
+  },
+  "bugs": {
+    "url": "https://github.com/haloduck/haloduck-frontend/issues"
+  },
+  "homepage": "https://github.com/haloduck/haloduck-frontend#readme",
+  "main": "bundles/haloduck-core.umd.js",
+  "module": "fesm2022/haloduck-core.mjs",
+  "es2022": "fesm2022/haloduck-core.mjs",
+  "esm2022": "fesm2022/haloduck-core.mjs",
+  "fesm2022": "fesm2022/haloduck-core.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./fesm2022/haloduck-core.mjs",
+      "require": "./bundles/haloduck-core.umd.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "ng build @haloduck/core",
+    "build:prod": "ng build @haloduck/core --configuration production",
+    "test": "ng test @haloduck/core",
+    "lint": "ng lint @haloduck/core",
+    "prepublishOnly": "npm run build:prod"
+  },
+  "peerDependencies": {
+    "@angular/common": "^19.2.0",
+    "@angular/core": "^19.2.0",
+    "@angular/router": "^19.2.0",
+    "rxjs": "~7.8.0",
+    "@ngrx/effects": "^19.0.0",
+    "@ngrx/store": "^19.0.0",
+    "aws-amplify": "^6.12.1"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "bin": {
+    "haloduck-copy-scripts": "./scripts/copy-scripts.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/copy-folder.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function copyFolderSync(from, to) {
+  fs.mkdirSync(to, { recursive: true });
+  for (const file of fs.readdirSync(from)) {
+    const src = path.join(from, file);
+    const dest = path.join(to, file);
+    if (fs.lstatSync(src).isDirectory()) {
+      copyFolderSync(src, dest);
+    } else {
+      fs.copyFileSync(src, dest);
+    }
+  }
+}
+
+module.exports = { copyFolderSync };

package/scripts/copy-scripts.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const path = require('path');
+const copyFolderSync = require('./copy-folder').copyFolderSync;
+
+const targetDir = path.resolve(process.cwd(), 'scripts');
+const sourceDir = path.resolve(__dirname, '../assets/scripts');
+
+copyFolderSync(sourceDir, targetDir);