@qaecy/cue-sdk 0.0.28 → 0.0.29

package/README.md

@@ -238,15 +238,14 @@ Entity data for a project is accessed via a `CueProjectView`. Create a view with
 
 Fetch all canonical entities that belong to at least one of the given category IRIs. Accepts both full HTTP IRIs and prefixed forms.
 
-By default returns only `{ iri, uuid }` — suitable for feeding directly into `requestEntityData()` for lazy detail loading. Pass `true` to also receive `value` and `categories`.
+By default returns a `string[]` of UUIDs — suitable for feeding directly into `requestEntityData()` for lazy detail loading. Pass `true` to also receive `iri`, `value`, and `categories`.
 
 ```typescript
-// Lean — just IRIs + UUIDs (default)
-const entities = await view.entities.entitiesByCategory([
+// Lean — just UUIDs (default)
+const uuids = await view.entities.entitiesByCategory([
   'qcy:Building',
   'qcy:BuildingStorey',
 ]);
-const uuids = entities.map((e) => e.uuid);
 view.entities.requestEntityData(uuids); // lazy-loads labels + categories
 
 // With metadata
@@ -260,7 +259,7 @@ entities.forEach((e) => console.log(e.uuid, e.value, e.categories));
 | Parameter | Type | Description |
 |---|---|---|
 | `categoryIris` | `string[]` | Full IRIs (`https://…`) or prefixed forms (`qcy:…`) |
-| `includeMetadata` | `boolean` | `false` (default) → `{ iri, uuid }[]`; `true` → adds `value` and `categories` |
+| `includeMetadata` | `boolean` | `false` (default) → `string[]` UUIDs; `true` → adds `iri`, `value`, and `categories` |
 
 ### `view.entities.contentCategoriesInProject(orderByOccurrences?)`
 
@@ -303,12 +302,12 @@ Document data for a project is accessed via `view.documents` (`CueProjectDocumen
 
 Fetch all documents whose file extension matches one of the given suffixes. The leading dot is optional — both `'ifc'` and `'.ifc'` are accepted.
 
-By default returns only `{ iri, uuid }` for pairing with `requestDocumentData()`. Pass `true` to also receive `path`, `suffix`, and `size`.
+By default returns a `string[]` of UUIDs — suitable for feeding directly into `requestDocumentData()`. Pass `true` to also receive `path`, `suffix`, and `size`.
 
 ```typescript
-// Lean — just IRIs + UUIDs (default)
-const docs = await view.documents.documentsBySuffix(['.ifc', '.rvt']);
-view.documents.requestDocumentData(docs.map((d) => d.uuid));
+// Lean — just UUIDs (default)
+const uuids = await view.documents.documentsBySuffix(['.ifc', '.rvt']);
+view.documents.requestDocumentData(uuids);
 
 // With file metadata
 const docs = await view.documents.documentsBySuffix(['pdf', 'docx'], true);
@@ -322,8 +321,8 @@ Fetch documents by semantic `FileType` category. Resolves all matching suffixes
 ```typescript
 import { FileType } from 'js/models';
 
-// All BIM and CAD files
-const docs = await view.documents.documentsByFileType([
+// All BIM and CAD files — just UUIDs
+const uuids = await view.documents.documentsByFileType([
   FileType.BIM,
   FileType.CAD,
 ]);
@@ -337,7 +336,8 @@ const docs = await view.documents.documentsByFileType([FileType.IMAGE], true);
 Fetch documents whose MIME type matches one of the given strings:
 
 ```typescript
-const docs = await view.documents.documentsByMime([
+// Just UUIDs
+const uuids = await view.documents.documentsByMime([
   'application/x-step',  // .ifc
   'application/pdf',
 ]);
@@ -349,13 +349,11 @@ const docs = await view.documents.documentsByMime(
 );
 ```
 
-| Method | Filters by | Extra metadata (`true`) |
-|---|---|---|
-| `documentsBySuffix` | File extension string(s) | `path`, `suffix`, `size` |
-| `documentsByFileType` | `FileType` enum value(s) | `path`, `suffix`, `size` |
-| `documentsByMime` | MIME type string(s) | `path`, `suffix`, `size` |
-
-All three exclude alternative representations (e.g. derived `.fragments` tiles) from results.
+| Method | Filters by | Default return | With `true` |
+|---|---|---|---|
+| `documentsBySuffix` | File extension string(s) | `string[]` UUIDs | adds `iri`, `path`, `suffix`, `size` |
+| `documentsByFileType` | `FileType` enum value(s) | `string[]` UUIDs | adds `iri`, `path`, `suffix`, `size` |
+| `documentsByMime` | MIME type string(s) | `string[]` UUIDs | adds `iri`, `path`, `suffix`, `size` |
 
 ## Node.js — file sync
 

package/{cue-BR7V1Nem.js → cue-CnZyGMRG.js}

@@ -6507,31 +6507,26 @@ WHERE {
          qcy:hasEntityCategory ?filterCat ;
          qcy:value ?val ;
          qcy:hasEntityCategory ?allCat .
-    BIND(REPLACE(STR(?iri), "^.*/([^/]*)$", "$1") AS ?id)
+    BIND(REPLACE(STR(?iri), "^.*/", "") AS ?id)
 }
 GROUP BY ?iri ?id` : `PREFIX qcy: <${y.qcy}>
-SELECT DISTINCT ?iri ?id
+SELECT DISTINCT ?id
 WHERE {
     VALUES ?filterCat { ${s} }
     ?iri a qcy:CanonicalEntity ;
          qcy:hasEntityCategory ?filterCat .
-    BIND(REPLACE(STR(?iri), "^.*/([^/]*)$", "$1") AS ?id)
-}`;
-    return (await this._api.sparql(
+    BIND(REPLACE(STR(?iri), "^.*/", "") AS ?id)
+}`, n = await this._api.sparql(
       a,
       this._projectId,
       this._graphType
-    )).results.bindings.filter((p) => p.iri && p.id).map(
-      (p) => e ? {
-        iri: p.iri.value,
-        uuid: p.id.value,
-        value: p.value?.value ?? "",
-        categories: p.categories?.value?.split(";").filter(Boolean) ?? []
-      } : {
-        iri: p.iri.value,
-        uuid: p.id.value
-      }
     );
+    return e ? n.results.bindings.filter((p) => p.iri && p.id).map((p) => ({
+      iri: p.iri.value,
+      uuid: p.id.value,
+      value: p.value?.value ?? "",
+      categories: p.categories?.value?.split(";").filter(Boolean) ?? []
+    })) : n.results.bindings.filter((p) => p.id).map((p) => p.id.value);
   }
   async buildSummaryGraph(t) {
     const e = `PREFIX qcy: <${y.qcy}>
@@ -7810,29 +7805,24 @@ WHERE {
     ?loc qcy:suffix ?suffix ;
          qcy:filePath ?fp .
     FILTER NOT EXISTS { ?x qcy:alternativeRepresentation ?iri }
-    BIND(REPLACE(STR(?iri), "^.*/([^/]*)$", "$1") AS ?id)
+    BIND(REPLACE(STR(?iri), "^.*/", "") AS ?id)
 }
 GROUP BY ?iri ?id ?suffix` : `PREFIX qcy: <${y.qcy}>
-SELECT DISTINCT ?iri ?id
+SELECT DISTINCT ?id
 WHERE {
     VALUES ?suffix { ${r} }
     ?iri a qcy:FileContent ;
          qcy:hasFileLocation/qcy:suffix ?suffix .
     FILTER NOT EXISTS { ?x qcy:alternativeRepresentation ?iri }
-    BIND(REPLACE(STR(?iri), "^.*/([^/]*)$", "$1") AS ?id)
-}`;
-    return (await this._api.sparql(s, this._projectId, this._graphType)).results.bindings.filter((n) => n.iri && n.id).map(
-      (n) => e ? {
-        iri: n.iri.value,
-        uuid: n.id.value,
-        path: n.path?.value ?? "",
-        suffix: n.suffix?.value ?? "",
-        size: n.size ? parseInt(n.size.value, 10) : 0
-      } : {
-        iri: n.iri.value,
-        uuid: n.id.value
-      }
-    );
+    BIND(REPLACE(STR(?iri), "^.*/", "") AS ?id)
+}`, a = await this._api.sparql(s, this._projectId, this._graphType);
+    return e ? a.results.bindings.filter((n) => n.iri && n.id).map((n) => ({
+      iri: n.iri.value,
+      uuid: n.id.value,
+      path: n.path?.value ?? "",
+      suffix: n.suffix?.value ?? "",
+      size: n.size ? parseInt(n.size.value, 10) : 0
+    })) : a.results.bindings.filter((n) => n.id).map((n) => n.id.value);
   }
   documentsByFileType(t, e = !1) {
     const o = new Set(t), r = Object.values(lt).filter((s) => o.has(s.type)).map((s) => s.suffix);

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-BR7V1Nem.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-CnZyGMRG.js";
 export {
   s as Cue,
   u as CueApi,

package/lib/documents.d.ts

@@ -134,10 +134,7 @@ export declare class CueProjectDocuments {
      * 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?: false): Promise<string[]>;
     documentsBySuffix(suffixes: string[], includeMetadata: true): Promise<Array<{
         iri: string;
         uuid: string;
@@ -152,10 +149,7 @@ export declare class CueProjectDocuments {
      * 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?: false): Promise<string[]>;
     documentsByFileType(fileTypes: FileType[], includeMetadata: true): Promise<Array<{
         iri: string;
         uuid: string;
@@ -170,10 +164,7 @@ export declare class CueProjectDocuments {
      * 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?: false): Promise<string[]>;
     documentsByMime(mimeTypes: string[], includeMetadata: true): Promise<Array<{
         iri: string;
         uuid: string;

package/lib/entities.d.ts

@@ -114,14 +114,11 @@ export declare class CueProjectEntities {
      * - `"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).
+     * By default returns only UUIDs (`string[]`) — pass `includeMetadata: true` to
+     * also get `iri`, `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?: false): Promise<string[]>;
     entitiesByCategory(categoryIris: string[], includeMetadata: true): Promise<Array<{
         iri: string;
         uuid: string;

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-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 { 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-CnZyGMRG.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-CnZyGMRG.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.28",
+  "version": "0.0.29",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",