@aiao/rxdb-angular 0.0.7 → 0.0.8

package/src/devtools/settings.ts

@@ -1,122 +0,0 @@
-import { RxDB, RxDBEvent } from '@aiao/rxdb';
-import {
-  ChangeDetectionStrategy,
-  Component,
-  inject,
-  output,
-  signal,
-  TemplateRef,
-  viewChild,
-  ViewContainerRef
-} from '@angular/core';
-import { LucideAngularModule, PanelBottom, PanelLeft, PanelRight } from 'lucide-angular';
-
-interface FileEntry {
-  name: string;
-  path: string;
-  type: 'file' | 'directory';
-  handle: FileSystemDirectoryHandle | FileSystemFileHandle;
-}
-
-@Component({
-  selector: 'rxdb-settings',
-  imports: [LucideAngularModule],
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  styleUrls: ['./settings.scss'],
-  templateUrl: './settings.html'
-})
-export class RxDBSettings {
-  #viewContainerRef = inject(ViewContainerRef);
-  #rxdb = inject(RxDB);
-
-  protected readonly PanelLeft = PanelLeft;
-  protected readonly PanelBottom = PanelBottom;
-  protected readonly PanelRight = PanelRight;
-
-  messageTmp = viewChild<TemplateRef<any>>('message');
-
-  $events = signal<RxDBEvent[]>([]);
-
-  sideChange = output<'right' | 'left' | 'bottom'>();
-
-  async delete_db() {
-    try {
-      await this.#rxdb.disconnectAll();
-    } catch {
-      //
-    }
-
-    try {
-      const root = await navigator.storage.getDirectory();
-      const files = await this.listAllFiles(root, 1);
-      for (const entry of files) {
-        if (entry.type === 'file') {
-          await root.removeEntry(entry.name, { recursive: true });
-        }
-      }
-      await this.clean_indexedDB();
-      localStorage.clear();
-      // 使用 baseURI 跳转回首页，避免在子路由刷新时因服务器配置问题导致 404 fallback 到主站
-      window.location.href = document.baseURI;
-    } catch (error: Error | any) {
-      if (error && error.name === 'NoModificationAllowedError') {
-        const ref = this.#viewContainerRef.createEmbeddedView<{ message: string }>(this.messageTmp()!, {
-          message: '关闭数据库失败，请检查是否在多个浏览器 tab 中打开页面'
-        });
-        setTimeout(() => {
-          ref.destroy();
-        }, 3000);
-      }
-      console.error(error);
-    }
-  }
-
-  async clean_indexedDB() {
-    const dbList = indexedDB.databases ? await indexedDB.databases() : [];
-    if (dbList.length) {
-      await Promise.all(
-        dbList.map(({ name }) => {
-          return new Promise<void>((resolve, reject) => {
-            const request = indexedDB.deleteDatabase(name!);
-            request.onsuccess = () => resolve();
-            request.onerror = () => reject(request.error);
-            request.onblocked = () => resolve();
-          });
-        })
-      );
-    }
-  }
-
-  async listAllFiles(
-    directoryHandle: FileSystemDirectoryHandle | any,
-    maxDeep = Number.MAX_SAFE_INTEGER,
-    path = '',
-    currentDeep = 1
-  ) {
-    const entries: FileEntry[] = [];
-    for await (const [name, handle] of directoryHandle) {
-      const entryPath = path ? `${path}/${name}` : name;
-      if (handle.kind === 'file') {
-        entries.push({
-          name: name,
-          path: entryPath,
-          type: 'file',
-          handle: handle
-        });
-      } else if (handle.kind === 'directory') {
-        entries.push({
-          name: name,
-          path: entryPath,
-          type: 'directory',
-          handle: handle
-        });
-
-        if (currentDeep < maxDeep) {
-          const subEntries = await this.listAllFiles(handle, maxDeep, entryPath, currentDeep + 1);
-          entries.push(...subEntries);
-        }
-      }
-    }
-    return entries;
-  }
-}

package/src/hooks.ts

@@ -1,307 +0,0 @@
-import { EntityStaticType, EntityType, TreeEntityType } from '@aiao/rxdb';
-import { GraphEntityType } from '@aiao/rxdb-plugin-graph';
-import { isFunction } from '@aiao/utils';
-import { effect, Signal, signal } from '@angular/core';
-import { toLazySignal } from 'ngxtension/to-lazy-signal';
-import { Observable, Subscriber, Subscription } from 'rxjs';
-
-type UseOptions<T> = T | (() => T);
-
-export interface RxDBResource<T> {
-  /**
-   * 资源的值
-   */
-  readonly value: Signal<T>;
-  /**
-   * 资源的错误
-   */
-  readonly error: Signal<Error | undefined>;
-  /**
-   * 资源的加载状态
-   */
-  readonly isLoading: Signal<boolean>;
-  /**
-   * 资源是否为空
-   */
-  readonly isEmpty: Signal<boolean | undefined>;
-  /**
-   * 资源是否有值
-   */
-  readonly hasValue: Signal<boolean>;
-}
-
-export const useRepositoryQuery = <T extends EntityType, RT>(
-  EntityType: T,
-  method: string,
-  defaultValue: any,
-  options: UseOptions<any>
-): RxDBResource<RT> => {
-  let _observer: Subscriber<any>;
-  let sub: Subscription;
-
-  const _has_sub = signal<boolean>(false);
-  const _refresh = signal<number>(0);
-
-  const _eff = effect(() => {
-    if (_has_sub() === false) return;
-    // re-run when refresh is called or options change
-    _refresh();
-    const opt = isFunction(options) ? options() : options;
-    if (sub) sub.unsubscribe();
-    // reset state for a new request
-    isLoading.set(true);
-    error.set(undefined);
-    hasValue.set(false);
-    isEmpty.set(undefined);
-    // 优化：使用 Record<string, any> 替代 any，以提高类型安全性
-    const func = (EntityType as unknown as Record<string, any>)[method];
-    sub =
-      func &&
-      func(opt).subscribe({
-        next: (d: any) => {
-          isLoading.set(false);
-          hasValue.set(true);
-          if (Array.isArray(d)) {
-            isEmpty.set(d.length === 0);
-          } else if (d == null) {
-            // null/undefined treated as empty
-            isEmpty.set(true);
-          } else {
-            isEmpty.set(false);
-          }
-          _observer.next(d);
-        },
-        error: (e: any) => {
-          isLoading.set(false);
-          error.set(e);
-        },
-        complete: () => {
-          // ensure loading is false even if observable completes without next
-          isLoading.set(false);
-        }
-      });
-  });
-  const ob = new Observable<RT>(observer => {
-    _has_sub.set(true);
-    _observer = observer;
-    _observer.next(defaultValue);
-    return () => {
-      _eff.destroy();
-      sub?.unsubscribe();
-    };
-  });
-
-  const value = toLazySignal<RT>(ob, {
-    initialValue: defaultValue
-  }) as Signal<RT>;
-  const error = signal<Error | undefined>(undefined);
-  const isLoading = signal<boolean>(false);
-  const hasValue = signal<boolean>(false);
-  const isEmpty = signal<boolean | undefined>(undefined);
-  return {
-    value,
-    error,
-    isLoading,
-    isEmpty,
-    hasValue
-  };
-};
-
-/*
- * Repository
- */
-
-/**
- * 通过 ID 获取单个实体
- *
- * @param EntityType 实体类
- * @param options 实体 ID 或查询参数对象
- * @returns 返回包含实体的资源 signal
- *
- * @example
- * ```typescript
- * const user = useGet(User, 'user-1');
- * ```
- */
-export const useGet = <T extends EntityType>(EntityType: T, options: UseOptions<EntityStaticType<T, 'getOptions'>>) =>
-  useRepositoryQuery<T, InstanceType<T>>(EntityType, 'get', undefined, options);
-
-/**
- * 查找第一个匹配条件的实体
- *
- * @param EntityType 实体类
- * @param options 查询参数（where、排序等）
- * @returns 返回包含实体的资源 signal
- */
-export const useFindOne = <T extends EntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findOneOptions'>>
-) => useRepositoryQuery<T, InstanceType<T> | undefined>(EntityType, 'findOne', undefined, options);
-
-/**
- * 查找匹配的实体，未找到则抛出错误
- *
- * @param EntityType 实体类
- * @param options 查询参数
- * @returns 返回包含实体的资源 signal
- */
-export const useFindOneOrFail = <T extends EntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findOneOrFailOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>>(EntityType, 'findOneOrFail', undefined, options);
-
-/**
- * 查找符合条件的多个实体
- *
- * @param EntityType 实体类
- * @param options 查询参数
- * @returns 返回包含实体数组的资源 signal
- */
-export const useFind = <T extends EntityType>(EntityType: T, options: UseOptions<EntityStaticType<T, 'findOptions'>>) =>
-  useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'find', [], options);
-
-/**
- * 使用游标分页查找实体
- *
- * @param EntityType 实体类
- * @param options 游标参数
- * @returns 返回包含实体数组的资源 signal
- */
-export const useFindByCursor = <T extends EntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findByCursorOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'findByCursor', [], options);
-
-/**
- * 查找全部实体
- *
- * @param EntityType 实体类
- * @param options 查询参数
- * @returns 返回包含全部实体的资源 signal
- */
-export const useFindAll = <T extends EntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findAllOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'findAll', [], options);
-
-/**
- * 统计满足条件的实体数量
- *
- * @param EntityType 实体类
- * @param options 查询参数
- * @returns 返回包含数量的资源 signal
- */
-export const useCount = <T extends EntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'countOptions'>>
-) => useRepositoryQuery<T, number>(EntityType, 'count', undefined, options);
-
-/*
- * TreeRepository
- */
-
-/**
- * 查找树结构中的所有子孙实体
- *
- * @param EntityType 实体类
- * @param options 树查询参数（entityId、深度等）
- * @returns 返回包含子孙实体的资源 signal
- */
-export const useFindDescendants = <T extends TreeEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findTreeOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'findDescendants', [], options);
-
-/**
- * 统计树结构中的子孙数量
- *
- * @param EntityType 实体类
- * @param options 树查询参数
- * @returns 返回包含数量的资源 signal
- */
-export const useCountDescendants = <T extends TreeEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findTreeOptions'>>
-) => useRepositoryQuery<T, number>(EntityType, 'countDescendants', undefined, options);
-
-/**
- * 查找树结构中的所有祖先实体
- *
- * @param EntityType 实体类
- * @param options 树查询参数
- * @returns 返回包含祖先实体的资源 signal
- */
-export const useFindAncestors = <T extends TreeEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findTreeOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'findAncestors', [], options);
-
-/**
- * 统计树结构中的祖先数量
- *
- * @param EntityType 实体类
- * @param options 树查询参数
- * @returns 返回包含数量的资源 signal
- */
-export const useCountAncestors = <T extends TreeEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findTreeOptions'>>
-) => useRepositoryQuery<T, number>(EntityType, 'countAncestors', undefined, options);
-
-/*
- * GraphRepository
- */
-
-/**
- * 查找图结构中的邻接实体
- *
- * @param EntityType 实体类
- * @param options 图查询参数（entityId、方向、层级等）
- * @returns 返回包含邻居实体的资源 signal
- *
- * @example
- * ```typescript
- * const friends = useGraphNeighbors(User, {
- *   entityId: 'user-1',
- *   direction: 'out',
- *   level: 1
- * });
- * ```
- */
-export const useGraphNeighbors = <T extends GraphEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findNeighborsOptions'>>
-) => useRepositoryQuery<T, InstanceType<T>[]>(EntityType, 'findNeighbors', [], options);
-
-/**
- * 统计图结构中的邻接数量
- *
- * @param EntityType 实体类
- * @param options 图查询参数
- * @returns 返回包含数量的资源 signal
- */
-export const useCountNeighbors = <T extends GraphEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findNeighborsOptions'>>
-) => useRepositoryQuery<T, number>(EntityType, 'countNeighbors', 0, options);
-
-/**
- * 查找图结构中两个实体之间的路径
- *
- * @param EntityType 实体类
- * @param options 路径查询参数（fromId、toId、最大深度等）
- * @returns 返回包含路径的资源 signal
- *
- * @example
- * ```typescript
- * const paths = useGraphPaths(User, {
- *   fromId: 'user-1',
- *   toId: 'user-2',
- *   maxDepth: 5
- * });
- * ```
- */
-export const useGraphPaths = <T extends GraphEntityType>(
-  EntityType: T,
-  options: UseOptions<EntityStaticType<T, 'findPathsOptions'>>
-) => useRepositoryQuery<T, any[]>(EntityType, 'findPaths', [], options);

package/src/index.ts

@@ -1,7 +0,0 @@
-export * from './hooks';
-export * from './InfiniteScrollingList';
-export { RxDBEntityChangeDirective } from './rxdb-change-detector.directive';
-export { provideRxDB } from './rxdb.provider';
-export * from './rxdb.service';
-export * from './use-action';
-export * from './use-state';

package/src/rxdb-change-detector.directive.spec.ts

@@ -1,94 +0,0 @@
-import { ChangeDetectionStrategy, Component, provideZonelessChangeDetection } from '@angular/core';
-import { TestBed } from '@angular/core/testing';
-import { Subject } from 'rxjs';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { RxDBEntityChangeDirective } from './rxdb-change-detector.directive';
-
-// Mock entity type
-const mockEntity = {
-  id: 'test-1',
-  name: 'Test Entity'
-};
-
-const mockPatchesSubject = new Subject();
-
-// Mock getEntityStatus
-vi.mock('@aiao/rxdb', () => ({
-  getEntityStatus: vi.fn(() => ({
-    patches$: mockPatchesSubject.asObservable()
-  }))
-}));
-
-@Component({
-  // eslint-disable-next-line @angular-eslint/component-selector
-  selector: 'test-component',
-  standalone: true,
-  imports: [RxDBEntityChangeDirective],
-  template: '<div [rxdbChangeDetector]="entity"></div>',
-  changeDetection: ChangeDetectionStrategy.OnPush
-})
-class TestComponent {
-  entity = mockEntity;
-}
-
-describe('RxDBEntityChangeDirective', () => {
-  beforeEach(() => {
-    TestBed.configureTestingModule({
-      providers: [provideZonelessChangeDetection()]
-    });
-  });
-
-  it('should create directive', () => {
-    const fixture = TestBed.createComponent(TestComponent);
-    expect(fixture).toBeDefined();
-  });
-
-  it('should subscribe to patches$ on initialization', () => {
-    const fixture = TestBed.createComponent(TestComponent);
-    fixture.detectChanges();
-
-    // Verify component was created successfully with the directive
-    expect(fixture.componentInstance).toBeDefined();
-
-    // 指令应该已经设置了订阅
-    // Testing the actual subscription behavior requires more complex mocking
-  });
-
-  it('should handle debounceTime input', () => {
-    @Component({
-      // eslint-disable-next-line @angular-eslint/component-selector
-      selector: 'test-debounce',
-      standalone: true,
-      imports: [RxDBEntityChangeDirective],
-      template: '<div [rxdbChangeDetector]="entity" [debounceTime]="100"></div>',
-      changeDetection: ChangeDetectionStrategy.OnPush
-    })
-    class TestDebounceComponent {
-      entity = mockEntity;
-    }
-
-    const fixture = TestBed.createComponent(TestDebounceComponent);
-    fixture.detectChanges();
-
-    expect(fixture.componentInstance).toBeDefined();
-  });
-
-  it('should handle auditTime input', () => {
-    @Component({
-      // eslint-disable-next-line @angular-eslint/component-selector
-      selector: 'test-audit',
-      standalone: true,
-      imports: [RxDBEntityChangeDirective],
-      template: '<div [rxdbChangeDetector]="entity" [auditTime]="50"></div>',
-      changeDetection: ChangeDetectionStrategy.OnPush
-    })
-    class TestAuditComponent {
-      entity = mockEntity;
-    }
-
-    const fixture = TestBed.createComponent(TestAuditComponent);
-    fixture.detectChanges();
-
-    expect(fixture.componentInstance).toBeDefined();
-  });
-});

package/src/rxdb-change-detector.directive.ts

@@ -1,35 +0,0 @@
-import { EntityType, getEntityStatus } from '@aiao/rxdb';
-import { ChangeDetectorRef, DestroyRef, Directive, effect, inject, input } from '@angular/core';
-import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
-import { auditTime, debounceTime, Subscription } from 'rxjs';
-
-/**
- * RxDB 实体变化指令
- * 如果你使用了 `changeDetection: ChangeDetectionStrategy.OnPush`
- * 那么正在输入的变化不会触发 angular 渲染机制，使用这个指令可以实现实时渲染
- *
- * @example
- * 当修改实体时，需要在多个地方预览修改变化时，可以使用这个指令
- */
-@Directive({ selector: '[rxdbChangeDetector]' })
-export class RxDBEntityChangeDirective {
-  #destroyRef = inject(DestroyRef);
-  #changeDetectorRef = inject(ChangeDetectorRef);
-  #sub?: Subscription;
-  public readonly rxdbChangeDetector = input<InstanceType<EntityType>>();
-  public readonly debounceTime = input<number>(0);
-  public readonly auditTime = input<number>(0);
-
-  constructor() {
-    effect(() => {
-      const rxdbChange = this.rxdbChangeDetector();
-      const dt = this.debounceTime();
-      const at = this.auditTime();
-      const status = getEntityStatus(rxdbChange);
-      this.#sub?.unsubscribe();
-      this.#sub = status.patches$
-        .pipe(takeUntilDestroyed(this.#destroyRef), debounceTime(dt), auditTime(at))
-        .subscribe(() => this.#changeDetectorRef.markForCheck());
-    });
-  }
-}

package/src/rxdb.provider.ts

@@ -1,13 +0,0 @@
-import { RxDB } from '@aiao/rxdb';
-import { makeEnvironmentProviders } from '@angular/core';
-
-/**
- * RxDB 配置
- */
-export const provideRxDB = (useFactory?: () => RxDB) =>
-  makeEnvironmentProviders([
-    {
-      provide: RxDB,
-      useFactory
-    }
-  ]);

package/src/rxdb.service.spec.ts

@@ -1,31 +0,0 @@
-import { provideZonelessChangeDetection } from '@angular/core';
-import { TestBed } from '@angular/core/testing';
-import { beforeEach, describe, expect, it } from 'vitest';
-import { RxDBService } from './rxdb.service';
-
-describe('RxDBService', () => {
-  let service: RxDBService;
-
-  beforeEach(() => {
-    TestBed.configureTestingModule({
-      providers: [provideZonelessChangeDetection(), RxDBService]
-    });
-    service = TestBed.inject(RxDBService);
-  });
-
-  it('should be created', () => {
-    expect(service).toBeDefined();
-  });
-
-  it('should not throw when closing devtools if not open', () => {
-    expect(() => service.closeDevTools()).not.toThrow();
-  });
-
-  it('should not throw when setting theme if devtools not open', () => {
-    expect(() => service.setDevToolsTheme('dark')).not.toThrow();
-  });
-
-  // Note: Tests for devtools loading are skipped because they require
-  // full RxDB setup with database connections, which is better tested
-  // in integration tests with actual Angular applications.
-});

package/src/rxdb.service.ts

@@ -1,35 +0,0 @@
-import { ComponentRef, Injectable, ViewContainerRef } from '@angular/core';
-import { RxDBDevtools } from './devtools/devtools';
-import { RxDBDevToolsOptions } from './devtools/devtools.interface';
-
-@Injectable({
-  providedIn: 'root'
-})
-export class RxDBService {
-  #componentRef?: ComponentRef<RxDBDevtools>;
-
-  async devtools(view: ViewContainerRef, options?: RxDBDevToolsOptions) {
-    if (this.#componentRef) {
-      this.closeDevTools();
-      return;
-    }
-    const { RxDBDevtools } = await import('./devtools/devtools.js');
-    const componentRef = view.createComponent(RxDBDevtools);
-    this.#componentRef = componentRef;
-    componentRef.setInput('componentRef', componentRef);
-    if (options) {
-      if (options.theme) this.setDevToolsTheme(options.theme);
-    }
-    componentRef.onDestroy(() => {
-      this.#componentRef = undefined;
-    });
-  }
-
-  closeDevTools() {
-    this.#componentRef?.instance.close_rxdb_devtools();
-  }
-
-  setDevToolsTheme(theme: 'light' | 'dark') {
-    this.#componentRef?.setInput('theme', theme);
-  }
-}

package/src/test-setup.ts

@@ -1,14 +0,0 @@
-import '@angular/compiler';
-
-import { getTestBed } from '@angular/core/testing';
-import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';
-
-const testBed = getTestBed();
-if (!testBed.platform) {
-  testBed.initTestEnvironment(BrowserTestingModule, platformBrowserTesting());
-}
-
-import { afterEach } from 'vitest';
-afterEach(() => {
-  getTestBed().resetTestingModule();
-});