@idevconn/create-icore 0.1.0

package/templates/libs/storage-strategies/firebase/eslint.config.mjs

@@ -0,0 +1,23 @@
+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}',
+          ],
+          ignoredDependencies: ['@icore/shared'],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/templates/libs/storage-strategies/firebase/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@icore/storage-firebase",
+  "version": "0.0.1",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@icore/shared": "*",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}

package/templates/libs/storage-strategies/firebase/project.json

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

package/templates/libs/storage-strategies/firebase/src/index.ts

@@ -0,0 +1,2 @@
+export * from './lib/firebase-storage.strategy.js';
+export * from './lib/testing/mock-firebase-storage.js';

package/templates/libs/storage-strategies/firebase/src/lib/__tests__/firebase-storage.contract.unit.test.ts

@@ -0,0 +1,8 @@
+import { runStorageContract } from '@icore/shared';
+import { FirebaseStorageStrategy } from '../firebase-storage.strategy.js';
+import { createMockFirebaseBucket } from '../testing/mock-firebase-storage.js';
+
+runStorageContract('FirebaseStorageStrategy', () => {
+  const bucket = createMockFirebaseBucket('icore-uploads');
+  return new FirebaseStorageStrategy({ bucket });
+});

package/templates/libs/storage-strategies/firebase/src/lib/firebase-storage.strategy.ts

@@ -0,0 +1,63 @@
+import { randomUUID } from 'node:crypto';
+import type { FileInput, StorageRef, StorageStrategy } from '@icore/shared';
+
+// Narrowed surfaces of firebase-admin's storage Bucket + File. The upload MS
+// wires the real admin.storage().bucket(name); we only need these methods.
+
+export interface FirebaseStorageFileLike {
+  save(body: Buffer, opts?: { metadata?: { contentType?: string } }): Promise<void>;
+  delete(): Promise<void>;
+  getSignedUrl(opts: { action?: 'read'; expires: number }): Promise<[string]>;
+}
+
+export interface FirebaseStorageBucketLike {
+  name: string;
+  file(path: string): FirebaseStorageFileLike;
+  getFiles(opts?: { prefix?: string }): Promise<[Array<{ name: string }>]>;
+}
+
+export interface FirebaseStorageStrategyOptions {
+  bucket: FirebaseStorageBucketLike;
+}
+
+export class FirebaseStorageStrategy implements StorageStrategy {
+  private readonly bucket: FirebaseStorageBucketLike;
+
+  constructor(opts: FirebaseStorageStrategyOptions) {
+    this.bucket = opts.bucket;
+  }
+
+  async upload(userId: string, file: FileInput): Promise<StorageRef> {
+    const path = `${userId}/${randomUUID()}-${file.filename}`;
+    await this.bucket.file(path).save(file.buffer, {
+      metadata: { contentType: file.mimeType },
+    });
+    return { bucket: this.bucket.name, path };
+  }
+
+  async remove(userId: string, ref: StorageRef): Promise<void> {
+    this.assertOwner(userId, ref);
+    await this.bucket.file(ref.path).delete();
+  }
+
+  async getSignedUrl(userId: string, ref: StorageRef, ttlSec = 900): Promise<string> {
+    this.assertOwner(userId, ref);
+    const [url] = await this.bucket.file(ref.path).getSignedUrl({
+      action: 'read',
+      expires: Date.now() + ttlSec * 1000,
+    });
+    return url;
+  }
+
+  async list(userId: string, prefix?: string): Promise<StorageRef[]> {
+    const folder = prefix ? `${userId}/${prefix}` : userId;
+    const [files] = await this.bucket.getFiles({ prefix: `${folder}/` });
+    return files
+      .filter((f) => f.name !== folder + '/')
+      .map((f) => ({ bucket: this.bucket.name, path: f.name }));
+  }
+
+  private assertOwner(userId: string, ref: StorageRef): void {
+    if (!ref.path.startsWith(`${userId}/`)) throw new Error('forbidden');
+  }
+}

package/templates/libs/storage-strategies/firebase/src/lib/testing/mock-firebase-storage.ts

@@ -0,0 +1,43 @@
+import type {
+  FirebaseStorageBucketLike,
+  FirebaseStorageFileLike,
+} from '../firebase-storage.strategy.js';
+
+interface StoredObject {
+  bytes: Buffer;
+  contentType: string;
+}
+
+export function createMockFirebaseBucket(name = 'icore-uploads'): FirebaseStorageBucketLike {
+  const objects = new Map<string, StoredObject>();
+
+  function fileHandle(path: string): FirebaseStorageFileLike {
+    return {
+      async save(body, opts) {
+        objects.set(path, {
+          bytes: Buffer.from(body),
+          contentType: opts?.metadata?.contentType ?? 'application/octet-stream',
+        });
+      },
+      async delete() {
+        if (!objects.has(path)) throw new Error('not_found');
+        objects.delete(path);
+      },
+      async getSignedUrl(opts) {
+        if (!objects.has(path)) throw new Error('not_found');
+        return [`https://mock.firebasestorage/${name}/${path}?ttl=${opts.expires}`];
+      },
+    };
+  }
+
+  return {
+    name,
+    file: (path: string) => fileHandle(path),
+    async getFiles(opts) {
+      const matches = [...objects.keys()].filter((p) =>
+        opts?.prefix ? p.startsWith(opts.prefix) : true,
+      );
+      return [matches.map((p) => ({ name: p }))];
+    },
+  };
+}

package/templates/libs/storage-strategies/firebase/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/storage-strategies/firebase/tsconfig.lib.json

@@ -0,0 +1,23 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "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/storage-strategies/firebase/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/storage-strategies/firebase/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/storage-strategies/firebase',
+  plugins: [nxViteTsPaths(), nxCopyAssetsPlugin(['*.md'])],
+  test: {
+    name: 'storage-firebase',
+    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/storage-strategies/firebase',
+      provider: 'v8' as const,
+    },
+  },
+}));

package/templates/libs/storage-strategies/supabase/README.md

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

package/templates/libs/storage-strategies/supabase/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/storage-strategies/supabase/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@icore/storage-supabase",
+  "version": "0.0.1",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@icore/shared": "*",
+    "@supabase/supabase-js": "^2.0.0",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}

package/templates/libs/storage-strategies/supabase/project.json

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

package/templates/libs/storage-strategies/supabase/src/index.ts

@@ -0,0 +1,2 @@
+export * from './lib/supabase-storage.strategy';
+export * from './lib/testing/mock-supabase-storage';

package/templates/libs/storage-strategies/supabase/src/lib/__tests__/supabase-storage.contract.unit.test.ts

@@ -0,0 +1,8 @@
+import { runStorageContract } from '@icore/shared';
+import { SupabaseStorageStrategy } from '../supabase-storage.strategy';
+import { createMockSupabaseStorageClient } from '../testing/mock-supabase-storage';
+
+runStorageContract('SupabaseStorageStrategy', () => {
+  const client = createMockSupabaseStorageClient('icore-uploads');
+  return new SupabaseStorageStrategy({ client, bucket: 'icore-uploads' });
+});

package/templates/libs/storage-strategies/supabase/src/lib/supabase-storage.strategy.ts

@@ -0,0 +1,53 @@
+import { randomUUID } from 'node:crypto';
+import type { SupabaseClient } from '@supabase/supabase-js';
+import type { FileInput, StorageRef, StorageStrategy } from '@icore/shared';
+
+export interface SupabaseStorageStrategyOptions {
+  client: SupabaseClient;
+  bucket: string;
+}
+
+export class SupabaseStorageStrategy implements StorageStrategy {
+  private readonly client: SupabaseClient;
+  private readonly bucket: string;
+
+  constructor(opts: SupabaseStorageStrategyOptions) {
+    this.client = opts.client;
+    this.bucket = opts.bucket;
+  }
+
+  async upload(userId: string, file: FileInput): Promise<StorageRef> {
+    const path = `${userId}/${randomUUID()}-${file.filename}`;
+    const { error } = await this.client.storage
+      .from(this.bucket)
+      .upload(path, file.buffer, { contentType: file.mimeType });
+    if (error) throw new Error(error.message);
+    return { bucket: this.bucket, path };
+  }
+
+  async remove(userId: string, ref: StorageRef): Promise<void> {
+    this.assertOwner(userId, ref);
+    const { error } = await this.client.storage.from(ref.bucket).remove([ref.path]);
+    if (error) throw new Error(error.message);
+  }
+
+  async getSignedUrl(userId: string, ref: StorageRef, ttlSec = 900): Promise<string> {
+    this.assertOwner(userId, ref);
+    const { data, error } = await this.client.storage
+      .from(ref.bucket)
+      .createSignedUrl(ref.path, ttlSec);
+    if (error || !data) throw new Error(error?.message ?? 'signed_url_failed');
+    return data.signedUrl;
+  }
+
+  async list(userId: string, prefix?: string): Promise<StorageRef[]> {
+    const folder = prefix ? `${userId}/${prefix}` : userId;
+    const { data, error } = await this.client.storage.from(this.bucket).list(folder);
+    if (error || !data) return [];
+    return data.map((row) => ({ bucket: this.bucket, path: `${folder}/${row.name}` }));
+  }
+
+  private assertOwner(userId: string, ref: StorageRef): void {
+    if (!ref.path.startsWith(`${userId}/`)) throw new Error('forbidden');
+  }
+}

package/templates/libs/storage-strategies/supabase/src/lib/testing/mock-supabase-storage.ts

@@ -0,0 +1,78 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+
+interface StoredObject {
+  bytes: Buffer;
+  mimeType: string;
+}
+
+interface MockBucketHandle {
+  upload(
+    path: string,
+    body: Buffer,
+    opts?: { contentType?: string },
+  ): Promise<{ data: { path: string } | null; error: { message: string } | null }>;
+  remove(paths: string[]): Promise<{ data: unknown; error: { message: string } | null }>;
+  createSignedUrl(
+    path: string,
+    ttlSec: number,
+  ): Promise<{ data: { signedUrl: string } | null; error: { message: string } | null }>;
+  list(
+    prefix?: string,
+  ): Promise<{ data: Array<{ name: string }> | null; error: { message: string } | null }>;
+}
+
+export function createMockSupabaseStorageClient(bucket = 'icore-uploads'): SupabaseClient {
+  const objects = new Map<string, StoredObject>();
+
+  function bucketHandle(name: string): MockBucketHandle {
+    if (name !== bucket) {
+      return {
+        async upload() {
+          return { data: null, error: { message: `unknown_bucket:${name}` } };
+        },
+        async remove() {
+          return { data: null, error: { message: `unknown_bucket:${name}` } };
+        },
+        async createSignedUrl() {
+          return { data: null, error: { message: `unknown_bucket:${name}` } };
+        },
+        async list() {
+          return { data: null, error: { message: `unknown_bucket:${name}` } };
+        },
+      };
+    }
+    return {
+      async upload(path, body, opts) {
+        if (objects.has(path)) return { data: null, error: { message: 'duplicate' } };
+        objects.set(path, {
+          bytes: body,
+          mimeType: opts?.contentType ?? 'application/octet-stream',
+        });
+        return { data: { path }, error: null };
+      },
+      async remove(paths) {
+        for (const p of paths) objects.delete(p);
+        return { data: null, error: null };
+      },
+      async createSignedUrl(path, ttlSec) {
+        if (!objects.has(path)) return { data: null, error: { message: 'not_found' } };
+        return {
+          data: { signedUrl: `https://mock.supabase/${path}?ttl=${ttlSec}` },
+          error: null,
+        };
+      },
+      async list(prefix) {
+        const matches = [...objects.keys()]
+          .filter((p) => (prefix ? p.startsWith(prefix) : true))
+          .map((name) => ({ name: name.split('/').pop() ?? name }));
+        return { data: matches, error: null };
+      },
+    };
+  }
+
+  const storage = {
+    from: (name: string) => bucketHandle(name),
+  };
+
+  return { storage } as unknown as SupabaseClient;
+}

package/templates/libs/storage-strategies/supabase/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/storage-strategies/supabase/tsconfig.lib.json

@@ -0,0 +1,23 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "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/storage-strategies/supabase/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/storage-strategies/supabase/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/storage-strategies/supabase',
+  plugins: [nxViteTsPaths(), nxCopyAssetsPlugin(['*.md'])],
+  test: {
+    name: 'storage-supabase',
+    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/storage-strategies/supabase',
+      provider: 'v8' as const,
+    },
+  },
+}));

package/templates/libs/template-shared/README.md

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

package/templates/libs/template-shared/eslint.config.mjs

@@ -0,0 +1,23 @@
+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}',
+          ],
+          ignoredDependencies: ['react', 'react-dom'],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

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

@@ -0,0 +1,22 @@
+{
+  "name": "@icore/template-shared",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@casl/react": "^7.0.0",
+    "@icore/shared": "*",
+    "@idevconn/api-client": "*",
+    "@idevconn/use-draft": "*",
+    "i18next": "^26.0.0",
+    "react-i18next": "^17.0.0",
+    "tslib": "^2.3.0",
+    "zustand": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}