@idevconn/create-icore 0.1.0

package/templates/libs/template-shared/project.json

@@ -0,0 +1,19 @@
+{
+  "name": "template-shared",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/template-shared/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/libs/template-shared",
+        "main": "libs/template-shared/src/index.ts",
+        "tsConfig": "libs/template-shared/tsconfig.lib.json",
+        "assets": ["libs/template-shared/*.md"]
+      }
+    }
+  }
+}

package/templates/libs/template-shared/src/index.ts

@@ -0,0 +1,9 @@
+export * from './lib/api/create-api.js';
+export * from './lib/stores/auth.store.js';
+export * from './lib/stores/loading.store.js';
+export * from './lib/abilities/ability-provider.js';
+export * from './lib/i18n/create-i18n.js';
+export * from './lib/i18n/keys.js';
+export * from './lib/notify/use-notify.js';
+export * from './lib/draft/index.js';
+export * from './lib/landing/LandingPage.js';

package/templates/libs/template-shared/src/lib/abilities/ability-provider.tsx

@@ -0,0 +1,19 @@
+import { AbilityProvider as CaslAbilityProvider, Can } from '@casl/react';
+import type { ReactNode } from 'react';
+import { useMemo } from 'react';
+import { defineAbilitiesFor, type AppAbility } from '@icore/shared';
+import { useAuthStore } from '../stores/auth.store.js';
+
+export { Can };
+
+export function AbilityProvider({ children }: { children: ReactNode }) {
+  const user = useAuthStore((s) => s.user);
+  const ability = useMemo<AppAbility>(
+    () =>
+      user
+        ? defineAbilitiesFor({ id: user.id, role: user.role === 'admin' ? 'admin' : 'user' })
+        : defineAbilitiesFor(null),
+    [user],
+  );
+  return <CaslAbilityProvider value={ability}>{children}</CaslAbilityProvider>;
+}

package/templates/libs/template-shared/src/lib/api/create-api.ts

@@ -0,0 +1,20 @@
+import { createApiClient } from '@idevconn/api-client';
+import { useAuthStore } from '../stores/auth.store.js';
+
+export function createIcoreApi(opts: { baseUrl: string; onUnauthorized?: () => void }) {
+  return createApiClient({
+    baseUrl: opts.baseUrl,
+    getAccessToken: () => useAuthStore.getState().accessToken,
+    getRefreshToken: () => useAuthStore.getState().refreshToken,
+    onTokenRefreshed: ({ accessToken, refreshToken }) => {
+      const user = useAuthStore.getState().user;
+      if (user) useAuthStore.getState().setAuth({ accessToken, refreshToken, user });
+    },
+    onUnauthorized: () => {
+      useAuthStore.getState().logout();
+      opts.onUnauthorized?.();
+    },
+  });
+}
+
+export { ApiError } from '@idevconn/api-client';

package/templates/libs/template-shared/src/lib/draft/index.ts

@@ -0,0 +1 @@
+export { useDraft, useDraftStore } from '@idevconn/use-draft';

package/templates/libs/template-shared/src/lib/i18n/create-i18n.ts

@@ -0,0 +1,42 @@
+import i18next, { type Resource } from 'i18next';
+import { initReactI18next } from 'react-i18next';
+
+const STORAGE_KEY = 'icore-lang';
+
+export type IcoreLocale = 'en' | 'ru' | 'he';
+const RTL_LOCALES: ReadonlySet<IcoreLocale> = new Set(['he']);
+
+export function getStoredLocale(fallback: IcoreLocale = 'en'): IcoreLocale {
+  if (typeof window === 'undefined') return fallback;
+  const v = window.localStorage.getItem(STORAGE_KEY);
+  return v === 'en' || v === 'ru' || v === 'he' ? v : fallback;
+}
+
+export function setStoredLocale(loc: IcoreLocale): void {
+  if (typeof window === 'undefined') return;
+  window.localStorage.setItem(STORAGE_KEY, loc);
+  document.documentElement.dir = RTL_LOCALES.has(loc) ? 'rtl' : 'ltr';
+  document.documentElement.lang = loc;
+}
+
+export interface CreateIcoreI18nOpts {
+  resources: Resource;
+  defaultLocale?: IcoreLocale;
+}
+
+export function createIcoreI18n(opts: CreateIcoreI18nOpts) {
+  const lng = getStoredLocale(opts.defaultLocale ?? 'en');
+  void i18next.use(initReactI18next).init({
+    resources: opts.resources,
+    lng,
+    fallbackLng: 'en',
+    interpolation: { escapeValue: false },
+  });
+  if (typeof document !== 'undefined') {
+    document.documentElement.dir = RTL_LOCALES.has(lng) ? 'rtl' : 'ltr';
+    document.documentElement.lang = lng;
+  }
+  return i18next;
+}
+
+export { i18next };

package/templates/libs/template-shared/src/lib/i18n/keys.ts

@@ -0,0 +1,30 @@
+export const ICORE_LOCALES = {
+  en: {
+    common: {
+      loading: 'Loading…',
+      save: 'Save',
+      cancel: 'Cancel',
+      logout: 'Log out',
+    },
+    auth: {
+      email: 'Email',
+      password: 'Password',
+      login: 'Log in',
+      register: 'Sign up',
+      switchToLogin: 'Have an account? Log in',
+      switchToRegister: 'No account yet? Sign up',
+    },
+    nav: {
+      dashboard: 'Dashboard',
+      profile: 'Profile',
+    },
+    profile: {
+      title: 'Profile',
+      hint: 'Edit your account details.',
+    },
+    error: {
+      accessDenied: 'Access denied',
+      unknown: 'Something went wrong.',
+    },
+  },
+} as const;

package/templates/libs/template-shared/src/lib/landing/LandingPage.tsx

@@ -0,0 +1,68 @@
+import type { ReactNode } from 'react';
+
+export interface LandingPageDep {
+  name: string;
+  version: string;
+  url?: string;
+}
+
+export interface LandingPageProps {
+  coreVersion: string;
+  uiLibrary: 'shadcn' | 'antd' | 'mui';
+  deps: LandingPageDep[];
+  ctaHref?: string;
+  ctaLabel?: ReactNode;
+}
+
+export function LandingPage(props: LandingPageProps) {
+  return (
+    <main
+      style={{
+        maxWidth: 720,
+        margin: '4rem auto',
+        padding: '2rem',
+        fontFamily: 'ui-sans-serif, system-ui, sans-serif',
+        lineHeight: 1.5,
+      }}
+    >
+      <h1 style={{ marginBottom: '0.25rem' }}>icore v{props.coreVersion}</h1>
+      <p style={{ color: '#666' }}>
+        Bootstrap scaffold built with <strong>{props.uiLibrary}</strong>.
+      </p>
+
+      <h2 style={{ marginTop: '2rem' }}>Installed packages</h2>
+      <ul style={{ listStyle: 'none', padding: 0 }}>
+        {props.deps.map((d) => (
+          <li
+            key={d.name}
+            style={{
+              padding: '0.5rem 0',
+              borderBottom: '1px solid #eee',
+              display: 'flex',
+              justifyContent: 'space-between',
+            }}
+          >
+            <span>
+              {d.url ? (
+                <a href={d.url} target="_blank" rel="noreferrer noopener">
+                  {d.name}
+                </a>
+              ) : (
+                d.name
+              )}
+            </span>
+            <code style={{ color: '#888' }}>{d.version}</code>
+          </li>
+        ))}
+      </ul>
+
+      {props.ctaHref ? (
+        <p style={{ marginTop: '2rem' }}>
+          <a href={props.ctaHref} style={{ fontWeight: 600 }}>
+            {props.ctaLabel ?? 'Continue →'}
+          </a>
+        </p>
+      ) : null}
+    </main>
+  );
+}

package/templates/libs/template-shared/src/lib/notify/use-notify.ts

@@ -0,0 +1,26 @@
+export interface NotifyOptions {
+  description?: string;
+  duration?: number;
+}
+
+export interface Notifier {
+  success(title: string, opts?: NotifyOptions): void;
+  error(title: string, opts?: NotifyOptions): void;
+  info(title: string, opts?: NotifyOptions): void;
+  warning(title: string, opts?: NotifyOptions): void;
+}
+
+let active: Notifier = {
+  success: () => undefined,
+  error: () => undefined,
+  info: () => undefined,
+  warning: () => undefined,
+};
+
+export function setNotifier(n: Notifier): void {
+  active = n;
+}
+
+export function useNotify(): Notifier {
+  return active;
+}

package/templates/libs/template-shared/src/lib/stores/auth.store.ts

@@ -0,0 +1,29 @@
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  role?: string;
+}
+
+export interface AuthState {
+  accessToken: string | null;
+  refreshToken: string | null;
+  user: AuthUser | null;
+  setAuth: (a: { accessToken: string; refreshToken: string; user: AuthUser }) => void;
+  logout: () => void;
+}
+
+export const useAuthStore = create<AuthState>()(
+  persist(
+    (set) => ({
+      accessToken: null,
+      refreshToken: null,
+      user: null,
+      setAuth: ({ accessToken, refreshToken, user }) => set({ accessToken, refreshToken, user }),
+      logout: () => set({ accessToken: null, refreshToken: null, user: null }),
+    }),
+    { name: 'icore-auth' },
+  ),
+);

package/templates/libs/template-shared/src/lib/stores/loading.store.ts

@@ -0,0 +1,13 @@
+import { create } from 'zustand';
+
+interface LoadingState {
+  loading: boolean;
+  setLoading: (v: boolean) => void;
+}
+
+export const useLoadingStore = create<LoadingState>((set) => ({
+  loading: false,
+  setLoading: (loading) => set({ loading }),
+}));
+
+export const useLoading = () => useLoadingStore((s) => s.loading);

package/templates/libs/template-shared/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/templates/libs/template-shared/tsconfig.lib.json

@@ -0,0 +1,25 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "lib": ["ES2022", "DOM"],
+    "types": ["node", "react", "react-dom"],
+    "jsx": "react-jsx"
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx"
+  ]
+}

package/templates/libs/template-shared/tsconfig.spec.json

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": ["vitest/globals", "vitest/importMeta", "vite/client", "node", "vitest"]
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ]
+}

package/templates/libs/template-shared/vitest.config.mts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vitest/config';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+import { nxCopyAssetsPlugin } from '@nx/vite/plugins/nx-copy-assets.plugin';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../../node_modules/.vite/libs/template-shared',
+  plugins: [nxViteTsPaths(), nxCopyAssetsPlugin(['*.md'])],
+  test: {
+    name: 'template-shared',
+    watch: false,
+    globals: true,
+    environment: 'node',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    passWithNoTests: true,
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: '../../coverage/libs/template-shared',
+      provider: 'v8' as const,
+    },
+  },
+}));

package/templates/libs/upload-client/README.md

@@ -0,0 +1,11 @@
+# upload-client
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build upload-client` to build the library.
+
+## Running unit tests
+
+Run `nx test upload-client` to execute the unit tests via [Vitest](https://vitest.dev/).

package/templates/libs/upload-client/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
+            '{projectRoot}/vitest.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/templates/libs/upload-client/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@icore/upload-client",
+  "version": "0.0.1",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@icore/shared": "*",
+    "@nestjs/common": "^11.1.24",
+    "@nestjs/microservices": "^11.1.24",
+    "rxjs": "^7.8.2",
+    "tslib": "^2.3.0"
+  }
+}

package/templates/libs/upload-client/project.json

@@ -0,0 +1,19 @@
+{
+  "name": "upload-client",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/upload-client/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/libs/upload-client",
+        "main": "libs/upload-client/src/index.ts",
+        "tsConfig": "libs/upload-client/tsconfig.lib.json",
+        "assets": ["libs/upload-client/*.md"]
+      }
+    }
+  }
+}

package/templates/libs/upload-client/src/index.ts

@@ -0,0 +1,2 @@
+export * from './lib/upload-client.module';
+export * from './lib/upload-client.service';

package/templates/libs/upload-client/src/lib/upload-client.module.ts

@@ -0,0 +1,25 @@
+import { DynamicModule, Module } from '@nestjs/common';
+import { ClientsModule } from '@nestjs/microservices';
+import { buildTransport } from '@icore/shared';
+import { UploadClientService } from './upload-client.service';
+
+export const UPLOAD_CLIENT = 'UPLOAD_CLIENT';
+
+@Module({})
+export class UploadClientModule {
+  static forRoot(): DynamicModule {
+    return {
+      module: UploadClientModule,
+      imports: [
+        ClientsModule.registerAsync([
+          {
+            name: UPLOAD_CLIENT,
+            useFactory: () => buildTransport('UPLOAD'),
+          },
+        ]),
+      ],
+      providers: [UploadClientService],
+      exports: [UploadClientService],
+    };
+  }
+}

package/templates/libs/upload-client/src/lib/upload-client.service.ts

@@ -0,0 +1,38 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { ClientProxy } from '@nestjs/microservices';
+import { firstValueFrom } from 'rxjs';
+import type { StorageRef } from '@icore/shared';
+import { UPLOAD_CLIENT } from './upload-client.module';
+
+@Injectable()
+export class UploadClientService {
+  constructor(@Inject(UPLOAD_CLIENT) private readonly client: ClientProxy) {}
+
+  upload(
+    userId: string,
+    file: { buffer: Buffer; filename: string; mimeType: string },
+  ): Promise<StorageRef> {
+    return firstValueFrom(
+      this.client.send<StorageRef>('storage.upload', {
+        userId,
+        file: {
+          buffer: file.buffer.toString('base64'),
+          filename: file.filename,
+          mimeType: file.mimeType,
+        },
+      }),
+    );
+  }
+
+  remove(userId: string, ref: StorageRef): Promise<void> {
+    return firstValueFrom(this.client.send<void>('storage.remove', { userId, ref }));
+  }
+
+  signedUrl(userId: string, ref: StorageRef, ttlSec?: number): Promise<string> {
+    return firstValueFrom(this.client.send<string>('storage.signedUrl', { userId, ref, ttlSec }));
+  }
+
+  list(userId: string, prefix?: string): Promise<StorageRef[]> {
+    return firstValueFrom(this.client.send<StorageRef[]>('storage.list', { userId, prefix }));
+  }
+}

package/templates/libs/upload-client/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "node16",
+    "moduleResolution": "node16",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/templates/libs/upload-client/tsconfig.lib.json

@@ -0,0 +1,26 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"],
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx"
+  ]
+}

package/templates/libs/upload-client/tsconfig.spec.json

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "types": ["vitest/globals", "vitest/importMeta", "vite/client", "node", "vitest"]
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ]
+}

package/templates/libs/upload-client/vitest.config.mts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vitest/config';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+import { nxCopyAssetsPlugin } from '@nx/vite/plugins/nx-copy-assets.plugin';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../../node_modules/.vite/libs/upload-client',
+  plugins: [nxViteTsPaths(), nxCopyAssetsPlugin(['*.md'])],
+  test: {
+    name: 'upload-client',
+    watch: false,
+    globals: true,
+    environment: 'node',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    passWithNoTests: true,
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: '../../coverage/libs/upload-client',
+      provider: 'v8' as const,
+    },
+  },
+}));