@qaecy/cue-sdk 0.0.27 → 0.0.28

package/index.js

@@ -1,4 +1,4 @@
-import { C as s, a as u, b as C, c as t, d as i, e as c, f as o, g as r, h as l, i as n, j as P, k as j, l as m, m as S, n as g, o as h, p, R as E, q as R, r as f, s as d } from "./cue-CzxsQ6aP.js";
+import { C as s, a as u, b as C, c as t, d as i, e as c, f as o, g as r, h as l, i as n, j as P, k as j, l as m, m as S, n as g, o as h, p, R as E, q as R, r as f, s as d } from "./cue-BR7V1Nem.js";
 export {
   s as Cue,
   u as CueApi,

package/lib/documents.d.ts

@@ -1,5 +1,6 @@
 import { CueApi } from './api';
 import { ReadonlySignal } from './signal';
+import { FileType } from 'js/models';
 import { DocumentInfo, ProjectDocumentsData, QueryCache } from './models';
 /**
  * Manages document data for a single project.
@@ -122,6 +123,64 @@ export declare class CueProjectDocuments {
      * Useful for pre-filling path-based query inputs with a realistic example.
      */
     randomFilePath(): Promise<string | null>;
+    /**
+     * Fetches all `qcy:FileContent` documents whose file suffix matches one of
+     * the given extensions (e.g. `'.ifc'`, `'.pdf'`).
+     *
+     * By default returns only `{ iri, uuid }` — pass `includeMetadata: true` to
+     * also get `path`, `suffix`, and `size`. Use the default form when you intend
+     * to lazy-load full details via `requestDocumentData`.
+     *
+     * Suffixes are matched case-insensitively and the leading dot is optional
+     * (both `'ifc'` and `'.ifc'` are accepted).
+     */
+    documentsBySuffix(suffixes: string[], includeMetadata?: false): Promise<Array<{
+        iri: string;
+        uuid: string;
+    }>>;
+    documentsBySuffix(suffixes: string[], includeMetadata: true): Promise<Array<{
+        iri: string;
+        uuid: string;
+        path: string;
+        suffix: string;
+        size: number;
+    }>>;
+    /**
+     * Fetches documents whose file suffix maps to one of the given `FileType`
+     * values (e.g. `FileType.BIM`, `FileType.CAD`).
+     *
+     * Resolves matching suffixes from `fileExtensionsInfo` and delegates to
+     * `documentsBySuffix`. Accepts the same `includeMetadata` flag.
+     */
+    documentsByFileType(fileTypes: FileType[], includeMetadata?: false): Promise<Array<{
+        iri: string;
+        uuid: string;
+    }>>;
+    documentsByFileType(fileTypes: FileType[], includeMetadata: true): Promise<Array<{
+        iri: string;
+        uuid: string;
+        path: string;
+        suffix: string;
+        size: number;
+    }>>;
+    /**
+     * Fetches documents whose MIME type matches one of the given strings
+     * (e.g. `'application/x-step'`, `'application/pdf'`).
+     *
+     * Resolves matching suffixes from `fileExtensionsInfo` and delegates to
+     * `documentsBySuffix`. Accepts the same `includeMetadata` flag.
+     */
+    documentsByMime(mimeTypes: string[], includeMetadata?: false): Promise<Array<{
+        iri: string;
+        uuid: string;
+    }>>;
+    documentsByMime(mimeTypes: string[], includeMetadata: true): Promise<Array<{
+        iri: string;
+        uuid: string;
+        path: string;
+        suffix: string;
+        size: number;
+    }>>;
     /** Executes the document-info SPARQL query for the given UUIDs, merges results
      * into `documentInfoMap`, and returns the newly fetched entries. */
     private _fetchDocumentInfoBatch;

package/lib/entities.d.ts

@@ -106,6 +106,28 @@ export declare class CueProjectEntities {
         iri: string;
         label: string;
     }[]>;
+    /**
+     * Fetches all `qcy:CanonicalEntity` instances that belong to at least one of
+     * the given category IRIs.
+     *
+     * Accepts both full HTTP IRIs and prefixed forms, e.g.:
+     * - `"qcy:Building"`
+     * - `"https://cue.qaecy.com/ontology#Building"`
+     *
+     * By default returns only `{ iri, uuid }` — pass `includeMetadata: true` to
+     * also get `value` and `categories` (all categories, not just the filtered ones).
+     * Use the default form when you intend to lazy-load details via `requestEntityData`.
+     */
+    entitiesByCategory(categoryIris: string[], includeMetadata?: false): Promise<Array<{
+        iri: string;
+        uuid: string;
+    }>>;
+    entitiesByCategory(categoryIris: string[], includeMetadata: true): Promise<Array<{
+        iri: string;
+        uuid: string;
+        value: string;
+        categories: string[];
+    }>>;
     /**
      * Fetches a summary graph of entity category relationships for the project.
      *

package/node.js

@@ -1,5 +1,5 @@
-import { C as h, B as l, t as _, u as E, v as S, o as m, w as P, a as d } from "./cue-CzxsQ6aP.js";
-import { b as j, c as x, d as y, e as I, f as K, g as L, h as v, i as H, j as N, k as O, l as D, m as G, n as W, p as k, R as q, q as Q, r as V, s as z } from "./cue-CzxsQ6aP.js";
+import { C as h, B as l, t as _, u as E, v as S, o as m, w as P, a as d } from "./cue-BR7V1Nem.js";
+import { b as j, c as x, d as y, e as I, f as K, g as L, h as v, i as H, j as N, k as O, l as D, m as G, n as W, p as k, R as q, q as Q, r as V, s as z } from "./cue-BR7V1Nem.js";
 import { getStorage as t, connectStorageEmulator as w } from "firebase/storage";
 import "firebase/firestore";
 class A extends h {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qaecy/cue-sdk",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",