@_linked/core 0.0.1 → 1.0.0-next.20260216062729

package/src/tests/store-routing.test.ts

@@ -1,133 +0,0 @@
-import {describe, expect, test} from '@jest/globals';
-import {linkedPackage} from '../utils/Package';
-import {Shape} from '../shapes/Shape';
-import {LinkedStorage} from '../utils/LinkedStorage';
-import {IQuadStore} from '../interfaces/IQuadStore';
-import {NodeReferenceValue} from '../utils/NodeReference';
-
-const {linkedShape} = linkedPackage('store-routing-test');
-
-const type = (suffix: string): NodeReferenceValue => ({
-  id: `linked://tmp/types/${suffix}`,
-});
-
-@linkedShape
-class RoutedPerson extends Shape {
-  static targetClass = type('RoutedPerson');
-}
-
-@linkedShape
-class RoutedEmployee extends RoutedPerson {
-  static targetClass = type('RoutedEmployee');
-}
-
-@linkedShape
-class RoutedPet extends Shape {
-  static targetClass = type('RoutedPet');
-}
-
-type StoreCalls = {
-  select: number;
-  update: number;
-  create: number;
-  delete: number;
-};
-
-const createStore = () => {
-  const calls: StoreCalls = {select: 0, update: 0, create: 0, delete: 0};
-  const store: IQuadStore = {
-    selectQuery: async <ResultType>() => {
-      calls.select += 1;
-      return [] as ResultType;
-    },
-    updateQuery: async () => {
-      calls.update += 1;
-      return {} as any;
-    },
-    createQuery: async () => {
-      calls.create += 1;
-      return {} as any;
-    },
-    deleteQuery: async () => {
-      calls.delete += 1;
-      return {deleted: [], count: 0};
-    },
-  };
-  return {store, calls};
-};
-
-describe('LinkedStorage store routing', () => {
-  test('routes select queries based on shape mapping', async () => {
-    const defaultStore = createStore();
-    const personStore = createStore();
-    LinkedStorage.setDefaultStore(defaultStore.store);
-    LinkedStorage.setStoreForShapes(personStore.store, RoutedPerson);
-
-    await LinkedStorage.selectQuery({
-      type: 'select',
-      select: [],
-      shape: RoutedPerson,
-    } as any);
-
-    expect(personStore.calls.select).toBe(1);
-    expect(defaultStore.calls.select).toBe(0);
-  });
-
-  test('routes select queries to default store when no mapping exists', async () => {
-    const defaultStore = createStore();
-    LinkedStorage.setDefaultStore(defaultStore.store);
-
-    await LinkedStorage.selectQuery({
-      type: 'select',
-      select: [],
-      shape: RoutedPet,
-    } as any);
-
-    expect(defaultStore.calls.select).toBe(1);
-  });
-
-  test('uses parent shape store for subclasses', async () => {
-    const defaultStore = createStore();
-    const personStore = createStore();
-    LinkedStorage.setDefaultStore(defaultStore.store);
-    LinkedStorage.setStoreForShapes(personStore.store, RoutedPerson);
-
-    await LinkedStorage.selectQuery({
-      type: 'select',
-      select: [],
-      shape: RoutedEmployee,
-    } as any);
-
-    expect(personStore.calls.select).toBe(1);
-    expect(defaultStore.calls.select).toBe(0);
-  });
-
-  test('routes update/create/delete using node shape ids', async () => {
-    const defaultStore = createStore();
-    const personStore = createStore();
-    LinkedStorage.setDefaultStore(defaultStore.store);
-    LinkedStorage.setStoreForShapes(personStore.store, RoutedPerson);
-
-    await LinkedStorage.updateQuery({
-      type: 'update',
-      id: 'p1',
-      shape: RoutedPerson.shape,
-      updates: {},
-    } as any);
-    await LinkedStorage.createQuery({
-      type: 'create',
-      shape: RoutedPerson.shape,
-      updates: {},
-    } as any);
-    await LinkedStorage.deleteQuery({
-      type: 'delete',
-      ids: [{id: 'p1'}],
-      shape: RoutedPerson.shape,
-    } as any);
-
-    expect(personStore.calls.update).toBe(1);
-    expect(personStore.calls.create).toBe(1);
-    expect(personStore.calls.delete).toBe(1);
-    expect(defaultStore.calls.update).toBe(0);
-  });
-});

package/src/utils/LinkedErrorLogging.ts

@@ -1,25 +0,0 @@
-export interface IErrorLogger {
-  log?(error: any): Promise<void>;
-}
-
-/**
- * Utility class to log errors.
- * Install any error client package like lincd-sentry in your app to log errors.
- */
-export class LinkedErrorLogging {
-  private static logger: IErrorLogger;
-
-  static setDefaultLogger(logger: IErrorLogger) {
-    this.logger = logger;
-  }
-
-  static hasDefaultLogger() {
-    return this.logger && true;
-  }
-
-  static log(error: Error) {
-    if (this.logger) {
-      return this.logger.log(error);
-    }
-  }
-}

package/src/utils/LinkedFileStorage.ts

@@ -1,75 +0,0 @@
-import {IFileStore} from '../interfaces/IFileStore.js';
-import type {Readable} from 'stream';
-
-export abstract class LinkedFileStorage {
-  private static defaultStore: IFileStore;
-  private static url: string; // default accessURL
-
-  static get accessURL(): string {
-    // check if default store is not set, return default accessURL
-    if (!this.defaultStore) {
-      return this.url;
-    }
-
-    return this.defaultStore.accessURL;
-  }
-
-  static setDefaultAccessURL(accessURL: string): string {
-    return (this.url = accessURL);
-  }
-
-  static getDefaultStore(): IFileStore {
-    return this.defaultStore;
-  }
-
-  static setDefaultStore(store: IFileStore) {
-    this.defaultStore = store;
-
-    if (this.defaultStore.init) {
-      this.defaultStore.init();
-    }
-  }
-
-  static deleteFile(filePath: string): Promise<void> {
-    return this.defaultStore.deleteFile(filePath);
-  }
-
-  static fileExists(filePath: string): Promise<boolean> {
-    return this.defaultStore.fileExists(filePath);
-  }
-
-  static getFile(filePath: string): Promise<Buffer> {
-    return this.defaultStore.getFile(filePath);
-  }
-
-  static listFiles(prefix?: string): Promise<string[]> {
-    return this.defaultStore.listFiles(prefix);
-  }
-
-  static saveFile(
-    filePath: string,
-    fileContent: string | Uint8Array | Buffer | Readable,
-    mimeType?: string,
-    preventDuplicates: boolean = false,
-  ): Promise<string> {
-    return this.defaultStore.saveFile(
-      filePath,
-      fileContent,
-      mimeType,
-      preventDuplicates,
-    );
-  }
-}
-
-/**
- * Get the full path of an asset based on the way LinkedFileStorage is configured
- * Returns accessURL + directory (/public by default) + path
- * @param path asset path
- * @param directory asset directory (optional, default is /public)
- * @returns asset url. e.g. https://cdn.example.com/public/image.png
- */
-export function asset(path: string, directory: string = '/public'): string {
-  const accessURL = LinkedFileStorage.accessURL;
-  const assetUrl = accessURL + directory + path;
-  return assetUrl;
-}

package/src/utils/LinkedStorage.ts

@@ -1,120 +0,0 @@
-import {CoreMap} from '../collections/CoreMap.js';
-import {CoreSet} from '../collections/CoreSet.js';
-import {IQuadStore} from '../interfaces/IQuadStore.js';
-import {CreateQuery} from '../queries/CreateQuery.js';
-import {DeleteQuery, DeleteResponse} from '../queries/DeleteQuery.js';
-import {SelectQuery} from '../queries/SelectQuery.js';
-import {UpdateQuery} from '../queries/UpdateQuery.js';
-import {Shape, ShapeType} from '../shapes/Shape.js';
-import {getShapeClass} from './ShapeClass.js';
-
-export abstract class LinkedStorage {
-  private static defaultStore?: IQuadStore;
-  private static shapeToStore: CoreMap<typeof Shape, IQuadStore> =
-    new CoreMap();
-
-  static isInitialised() {
-    return !!this.defaultStore;
-  }
-
-  static getDefaultStore() {
-    return this.defaultStore;
-  }
-
-  static setDefaultStore(store: IQuadStore) {
-    this.defaultStore = store;
-    if (this.defaultStore?.init) {
-      this.defaultStore.init();
-    }
-  }
-
-  static setStoreForShapes(store: IQuadStore, ...shapeClasses: (typeof Shape)[]) {
-    shapeClasses.forEach((shapeClass) => {
-      this.shapeToStore.set(shapeClass, store);
-    });
-  }
-
-  static getStores(): CoreSet<IQuadStore> {
-    const stores = new CoreSet<IQuadStore>();
-    if (this.defaultStore) {
-      stores.add(this.defaultStore);
-    }
-    this.shapeToStore.forEach((store) => stores.add(store));
-    return stores;
-  }
-
-  static getShapeToStoreMap(): CoreMap<typeof Shape, IQuadStore> {
-    return this.shapeToStore;
-  }
-
-  static getStoreForShapeClass(shapeClass?: typeof Shape | null): IQuadStore {
-    let current = shapeClass || null;
-    while (current) {
-      const store = this.shapeToStore.get(current);
-      if (store) {
-        return store;
-      }
-      if (current === Shape) {
-        break;
-      }
-      current = Object.getPrototypeOf(current);
-    }
-    return this.defaultStore;
-  }
-
-  private static resolveStoreForQueryShape(
-    shape?: {id?: string} | typeof Shape | ShapeType | null,
-  ): IQuadStore {
-    if (!shape) {
-      return this.defaultStore;
-    }
-    if (typeof shape === 'function') {
-      return this.getStoreForShapeClass(shape as typeof Shape);
-    }
-    if (shape.id) {
-      const shapeClass = getShapeClass(shape.id);
-      return this.getStoreForShapeClass(shapeClass);
-    }
-    return this.defaultStore;
-  }
-
-  static selectQuery<ResultType>(query: SelectQuery<any>): Promise<ResultType> {
-    const store = this.resolveStoreForQueryShape(query?.shape);
-    if (!store?.selectQuery) {
-      return Promise.reject(
-        new Error('No query store configured. Call LinkedStorage.setDefaultStore().'),
-      );
-    }
-    return store.selectQuery(query);
-  }
-
-  static updateQuery<ResponseType>(query: UpdateQuery<ResponseType>) {
-    const store = this.resolveStoreForQueryShape(query?.shape);
-    if (!store?.updateQuery) {
-      return Promise.reject(
-        new Error('No update handler configured on the query store.'),
-      );
-    }
-    return store.updateQuery(query);
-  }
-
-  static createQuery<ResponseType>(query: CreateQuery<ResponseType>) {
-    const store = this.resolveStoreForQueryShape(query?.shape);
-    if (!store?.createQuery) {
-      return Promise.reject(
-        new Error('No create handler configured on the query store.'),
-      );
-    }
-    return store.createQuery(query);
-  }
-
-  static deleteQuery(query: DeleteQuery): Promise<DeleteResponse> {
-    const store = this.resolveStoreForQueryShape(query?.shape);
-    if (!store?.deleteQuery) {
-      return Promise.reject(
-        new Error('No delete handler configured on the query store.'),
-      );
-    }
-    return store.deleteQuery(query);
-  }
-}

package/src/utils/NameSpace.ts

@@ -1,5 +0,0 @@
-import {NodeReferenceValue} from './NodeReference.js';
-
-export const createNameSpace = (nameSpace: string) => {
-  return (term: string): NodeReferenceValue => ({id: nameSpace + term});
-};

package/src/utils/NodeReference.ts

@@ -1,16 +0,0 @@
-export type NodeReferenceValue = {id: string};
-
-export type NodeReferenceInput = NodeReferenceValue | string;
-
-export function toNodeReference(value: NodeReferenceInput): NodeReferenceValue {
-  return typeof value === 'string' ? {id: value} : value;
-}
-
-export function isNodeReferenceValue(value: unknown): value is NodeReferenceValue {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    'id' in value &&
-    typeof (value as NodeReferenceValue).id === 'string'
-  );
-}