@ifc-lite/flow-nodes 0.3.1 → 0.5.0

package/README.md

@@ -13,6 +13,7 @@ in the headless CLI.
 | `table.*` | fromEntities, longFormat, column, groupRows, pivot, rowCount | Typed columns with IFC value types and pset/prop bindings |
 | `viewer.*` | colorize, isolate, select, selection, flyTo | `noop` on a headless host; entities pass through |
 | `model.set*` | setProperty, setAttribute | Capability-checked against the actual pset (`model.mutate:<Pset>`) |
+| `http.request`, `speckle.receive` | network | Every request goes through the gated `coreNetworkRequest` (`network.fetch:<host>` grants, https only); `speckle.receive` writes a Speckle model's walls, floors, roofs, columns and beams, and reports what it cannot map |
 | `script.run` | one node | JavaScript in the QuickJS sandbox with the sandbox `bim` API |
 
 ## Usage

package/dist/aps-client.d.ts

@@ -0,0 +1,55 @@
+import type { Ctx } from './host.js';
+export declare const APS_HOST = "developer.api.autodesk.com";
+export declare const APS_DEFAULT_SCOPE = "data:read viewables:read";
+export declare const APS_REGIONS: readonly ["US", "EMEA", "AUS", "CAN", "DEU", "IND", "JPN", "GBR"];
+/**
+ * An opaque APS access token. Only this module can read the bearer string;
+ * serialising the handle yields its description, never the token.
+ */
+export declare class ApsToken {
+    /** `client_credentials` (2-legged, minted here) or `provided` (a 3-legged token passed in). */
+    readonly grant: 'client_credentials' | 'provided';
+    readonly scope: string;
+    /** Epoch ms, when the token endpoint reported `expires_in`. */
+    readonly expiresAt: number | null;
+    readonly kind = "aps.token";
+    constructor(bearer: string, 
+    /** `client_credentials` (2-legged, minted here) or `provided` (a 3-legged token passed in). */
+    grant: 'client_credentials' | 'provided', scope: string, 
+    /** Epoch ms, when the token endpoint reported `expires_in`. */
+    expiresAt: number | null);
+    toJSON(): Record<string, unknown>;
+    toString(): string;
+}
+interface ApsGetOptions {
+    readonly region: string;
+    readonly timeoutMs: number;
+    readonly maxBytes: number;
+}
+/**
+ * A 2-legged token from the client-credentials grant. `clientSecret` is
+ * normally a `{{secret:APS_CLIENT_SECRET}}` reference, already interpolated
+ * by the CLI/MCP runner; it only ever travels in the request body.
+ */
+export declare function requestClientToken(ctx: Ctx, node: string, clientId: string, clientSecret: string, scope: string): Promise<ApsToken>;
+/** Wrap a ready (typically 3-legged) access token without any request. */
+export declare function providedToken(accessToken: string): ApsToken;
+/** Authorised GET against the APS host; returns status and parsed-or-raw body. */
+export declare function apsGet(ctx: Ctx, node: string, token: ApsToken, path: string, opts: ApsGetOptions): Promise<{
+    status: number;
+    body: string;
+}>;
+/**
+ * The Model Derivative URN for a model reference:
+ *   - a raw `urn:adsk.…` id (a Docs/ACC version id such as
+ *     `urn:adsk.wipprod:fs.file:vf.…?version=3`, or an OSS object id) is
+ *     base64url-encoded without padding, as ifc-ai-rendering does;
+ *   - an already-encoded URN (optionally `urn:`-prefixed, as the viewer
+ *     writes it) is normalised to the base64url alphabet without padding.
+ * A lineage (item) id names no version, so it is refused with a hint.
+ */
+export declare function toDerivativeUrn(raw: string): string;
+/** Resolves after `ms`, or rejects as soon as `signal` aborts. */
+export declare function delay(ms: number, signal: AbortSignal | undefined): Promise<void>;
+export {};
+//# sourceMappingURL=aps-client.d.ts.map

package/dist/aps-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-client.d.ts","sourceRoot":"","sources":["../src/aps-client.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,eAAO,MAAM,QAAQ,+BAA+B,CAAC;AAErD,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAC5D,eAAO,MAAM,WAAW,mEAAoE,CAAC;AAO7F;;;GAGG;AACH,qBAAa,QAAQ;IAKjB,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IARnC,QAAQ,CAAC,IAAI,eAAe;gBAG1B,MAAM,EAAE,MAAM;IACd,+FAA+F;IACtF,KAAK,EAAE,oBAAoB,GAAG,UAAU,EACxC,KAAK,EAAE,MAAM;IACtB,+DAA+D;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,QAAQ,IAAI,MAAM;CAGnB;AAqBD,UAAU,aAAa;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAaD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAC5E,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAE3D;AAED,kFAAkF;AAClF,wBAAsB,MAAM,CAC1B,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GACzE,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYnD;AAQD,kEAAkE;AAClE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhF"}

package/dist/aps-client.js

@@ -0,0 +1,194 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Autodesk Platform Services (APS) protocol handling for the `aps.*` flow
+ * nodes (#5634): OAuth token acquisition and Model Derivative reads.
+ *
+ * The protocol knowledge is adapted, at the author's request, from the
+ * author's own ifc-ai-rendering project (`lib/aps-auth.ts`,
+ * `app/api/aps/{viewer-token,viewable,derivative/[urn]}`), which runs these
+ * exact calls against live APS:
+ *   - `POST /authentication/v2/token`, form-encoded, `grant_type=client_credentials`
+ *     with `client_id`/`client_secret`/`scope` in the body;
+ *   - the derivative URN is the Docs/ACC version id (or OSS object id),
+ *     base64url-encoded without padding;
+ *   - `GET /modelderivative/v2/designdata/{urn}/metadata`, picking the `3d`
+ *     view, then `.../metadata/{guid}/properties`; `x-ads-region` selects the
+ *     data centre.
+ *
+ * Every request goes through `coreNetworkRequest`, so the https-only /
+ * exact-host-grant policy of `http.request` applies unchanged: a graph must
+ * declare `network.fetch:developer.api.autodesk.com`.
+ *
+ * The access token never becomes a plain flow value. A token derived from a
+ * client secret is not itself a secret the redaction map knows, so a string
+ * output would print it in clear on `flow run` / `run_flow`. It travels as an
+ * {@link ApsToken} handle instead: the bearer string lives in a module-private
+ * `WeakMap`, invisible to `JSON.stringify`, `redactDeep`, digests and
+ * inspectors, and every error message is scrubbed of it before it is thrown.
+ */
+import { coreNetworkRequest } from '@ifc-lite/sandbox';
+export const APS_HOST = 'developer.api.autodesk.com';
+const APS_BASE = `https://${APS_HOST}`;
+export const APS_DEFAULT_SCOPE = 'data:read viewables:read';
+export const APS_REGIONS = ['US', 'EMEA', 'AUS', 'CAN', 'DEU', 'IND', 'JPN', 'GBR'];
+const TOKEN_TIMEOUT_MS = 15_000;
+const TOKEN_MAX_BYTES = 64 * 1024;
+const bearerByHandle = new WeakMap();
+/**
+ * An opaque APS access token. Only this module can read the bearer string;
+ * serialising the handle yields its description, never the token.
+ */
+export class ApsToken {
+    grant;
+    scope;
+    expiresAt;
+    kind = 'aps.token';
+    constructor(bearer, 
+    /** `client_credentials` (2-legged, minted here) or `provided` (a 3-legged token passed in). */
+    grant, scope, 
+    /** Epoch ms, when the token endpoint reported `expires_in`. */
+    expiresAt) {
+        this.grant = grant;
+        this.scope = scope;
+        this.expiresAt = expiresAt;
+        bearerByHandle.set(this, bearer);
+    }
+    toJSON() {
+        return { kind: this.kind, grant: this.grant, scope: this.scope, expiresAt: this.expiresAt };
+    }
+    toString() {
+        return `[APS token, ${this.grant}]`;
+    }
+}
+function bearerOf(token) {
+    const bearer = bearerByHandle.get(token);
+    // A handle that crossed a structured clone (worker, IPC) loses its bearer on purpose.
+    if (bearer === undefined)
+        throw new Error('APS token handle has no bearer (was it copied across a process or worker boundary?)');
+    return bearer;
+}
+/** `aps.xxx: ` prefixed error, with every occurrence of `bearer` scrubbed. */
+function apsError(node, message, bearer) {
+    const clean = bearer && bearer.length > 0 ? message.split(bearer).join('<aps-token>') : message;
+    return new Error(`${node}: ${clean}`);
+}
+/** At most `max` characters of an APS error body, for a diagnosable message. */
+function snippet(body, max = 300) {
+    const flat = body.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max)}…` : flat;
+}
+async function send(ctx, node, init, bearer) {
+    try {
+        return await coreNetworkRequest(init, ctx.host.networkGrants ?? [], ctx.host.networkTransport);
+    }
+    catch (err) {
+        // Denials (ungranted host, redirect) and transport failures alike: prefix and scrub.
+        throw apsError(node, err instanceof Error ? err.message : String(err), bearer);
+    }
+}
+/**
+ * A 2-legged token from the client-credentials grant. `clientSecret` is
+ * normally a `{{secret:APS_CLIENT_SECRET}}` reference, already interpolated
+ * by the CLI/MCP runner; it only ever travels in the request body.
+ */
+export async function requestClientToken(ctx, node, clientId, clientSecret, scope) {
+    const body = new URLSearchParams({ grant_type: 'client_credentials', client_id: clientId, client_secret: clientSecret, scope }).toString();
+    const res = await send(ctx, node, {
+        url: `${APS_BASE}/authentication/v2/token`,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
+        body,
+        timeoutMs: TOKEN_TIMEOUT_MS,
+        maxBytes: TOKEN_MAX_BYTES,
+        signal: ctx.signal,
+    });
+    if (res.status < 200 || res.status >= 300) {
+        throw apsError(node, `token request failed (HTTP ${res.status}): ${snippet(res.body)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(res.body);
+    }
+    catch {
+        throw apsError(node, 'token endpoint returned a non-JSON body');
+    }
+    if (typeof parsed.access_token !== 'string' || parsed.access_token.length === 0) {
+        throw apsError(node, 'token endpoint returned no access_token');
+    }
+    const expiresAt = typeof parsed.expires_in === 'number' ? Date.now() + parsed.expires_in * 1000 : null;
+    return new ApsToken(parsed.access_token, 'client_credentials', scope, expiresAt);
+}
+/** Wrap a ready (typically 3-legged) access token without any request. */
+export function providedToken(accessToken) {
+    return new ApsToken(accessToken, 'provided', '', null);
+}
+/** Authorised GET against the APS host; returns status and parsed-or-raw body. */
+export async function apsGet(ctx, node, token, path, opts) {
+    const bearer = bearerOf(token);
+    const res = await send(ctx, node, {
+        url: `${APS_BASE}${path}`,
+        method: 'GET',
+        headers: { Authorization: `Bearer ${bearer}`, 'x-ads-region': opts.region, Accept: 'application/json' },
+        timeoutMs: opts.timeoutMs,
+        maxBytes: opts.maxBytes,
+        signal: ctx.signal,
+    }, bearer);
+    if (res.truncated) {
+        throw apsError(node, `response for ${path.split('?')[0]} exceeded maxBytes (${opts.maxBytes}); raise the node's maxBytes param`, bearer);
+    }
+    // The body is APS's, but scrub anyway: a proxy echoing the request must not leak the bearer.
+    return { status: res.status, body: res.body.split(bearer).join('<aps-token>') };
+}
+/**
+ * The Model Derivative URN for a model reference:
+ *   - a raw `urn:adsk.…` id (a Docs/ACC version id such as
+ *     `urn:adsk.wipprod:fs.file:vf.…?version=3`, or an OSS object id) is
+ *     base64url-encoded without padding, as ifc-ai-rendering does;
+ *   - an already-encoded URN (optionally `urn:`-prefixed, as the viewer
+ *     writes it) is normalised to the base64url alphabet without padding.
+ * A lineage (item) id names no version, so it is refused with a hint.
+ */
+export function toDerivativeUrn(raw) {
+    const value = raw.trim();
+    if (value.length === 0)
+        throw new Error('a model URN is required');
+    const body = value.startsWith('urn:') ? value.slice(4) : value;
+    if (value.startsWith('urn:') && body.includes(':')) {
+        if (body.includes(':dm.lineage:')) {
+            throw new Error(`"${value}" is an item (lineage) id, not a version; pass the item's version id (…:fs.file:vf.…?version=N)`);
+        }
+        return base64Url(value);
+    }
+    if (!/^[A-Za-z0-9+/_=-]+$/.test(body))
+        throw new Error(`"${value}" is neither a urn:adsk… id nor a base64 derivative URN`);
+    return body.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+function base64Url(text) {
+    let binary = '';
+    for (const byte of new TextEncoder().encode(text))
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+/** Resolves after `ms`, or rejects as soon as `signal` aborts. */
+export function delay(ms, signal) {
+    if (ms <= 0)
+        return signal?.aborted ? Promise.reject(new Error('cancelled')) : Promise.resolve();
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('cancelled'));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new Error('cancelled'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=aps-client.js.map

package/dist/aps-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-client.js","sourceRoot":"","sources":["../src/aps-client.ts"],"names":[],"mappings":"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"}

package/dist/aps-nodes.d.ts

@@ -0,0 +1,3 @@
+import { type FlowNodeDef } from './host.js';
+export declare const apsNodes: FlowNodeDef[];
+//# sourceMappingURL=aps-nodes.d.ts.map

package/dist/aps-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-nodes.d.ts","sourceRoot":"","sources":["../src/aps-nodes.ts"],"names":[],"mappings":"AAyBA,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AA0G1F,eAAO,MAAM,QAAQ,EAAE,WAAW,EA8EjC,CAAC"}

package/dist/aps-nodes.js

@@ -0,0 +1,192 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * `aps.token` / `aps.modelProperties` — receive Autodesk Platform Services
+ * (APS) model data into a flow graph (#5634), so Revit/ACC properties can be
+ * joined to an IFC model with `table.joinByKey`.
+ *
+ * Model Derivative is the read path, not Data Exchange: it is the path the
+ * author's ifc-ai-rendering project runs successfully against live APS for
+ * any translated Docs/ACC version, while its Data Exchange route needed
+ * region/URN-format fallbacks and hard-coded exchange ids to find anything.
+ *
+ * Credentials: either chain `aps.token` into `token`, or set the credential
+ * params on `aps.modelProperties` itself. The token is an opaque
+ * {@link ApsToken} handle (see `aps-client.ts`), never a string, so neither
+ * shape can print it. All I/O is `coreNetworkRequest` behind the graph's
+ * `network.fetch:developer.api.autodesk.com` grant.
+ */
+import { APS_DEFAULT_SCOPE, APS_REGIONS, ApsToken, apsGet, delay, providedToken, requestClientToken, toDerivativeUrn, } from './aps-client.js';
+import { propertiesToTable } from './aps-table.js';
+import { ANY_ITEM, SCALAR_ITEM, TABLE_ITEM } from './host.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_BYTES = 64 * 1024 * 1024;
+const DEFAULT_MAX_ATTEMPTS = 6;
+const DEFAULT_RETRY_DELAY_MS = 5_000;
+const CREDENTIAL_PARAMS = [
+    { name: 'clientId', kind: 'string', default: '', doc: 'APS app client id, e.g. {{secret:APS_CLIENT_ID}}. With clientSecret, mints a 2-legged token.' },
+    { name: 'clientSecret', kind: 'string', default: '', doc: 'APS app client secret: use {{secret:APS_CLIENT_SECRET}}, never a literal.' },
+    { name: 'scope', kind: 'string', default: APS_DEFAULT_SCOPE, doc: 'OAuth scopes for the 2-legged token.' },
+    { name: 'accessToken', kind: 'string', default: '', doc: 'A ready (e.g. 3-legged) access token, {{secret:APS_TOKEN}}. Wins over clientId/clientSecret.' },
+];
+function str(v) {
+    return typeof v === 'string' ? v.trim() : '';
+}
+function bounded(value, fallback, min) {
+    const n = typeof value === 'number' ? value : typeof value === 'string' && value.trim() !== '' ? Number(value) : Number.NaN;
+    return Number.isFinite(n) && n >= min ? n : fallback;
+}
+async function tokenFromParams(ctx, node, p) {
+    const accessToken = str(p.accessToken);
+    if (accessToken)
+        return providedToken(accessToken);
+    const clientId = str(p.clientId);
+    const clientSecret = str(p.clientSecret);
+    if (!clientId || !clientSecret) {
+        throw new Error(`${node}: no credentials — set accessToken, or clientId and clientSecret (e.g. {{secret:APS_CLIENT_ID}} / {{secret:APS_CLIENT_SECRET}})`);
+    }
+    return requestClientToken(ctx, node, clientId, clientSecret, str(p.scope) || APS_DEFAULT_SCOPE);
+}
+async function resolveToken(ctx, node, input, p) {
+    if (input instanceof ApsToken)
+        return input;
+    if (input !== undefined && input !== null) {
+        throw new Error(`${node}: "token" input is not an aps.token handle (a token cannot be passed as text or through a serialised value)`);
+    }
+    return tokenFromParams(ctx, node, p);
+}
+/**
+ * GET a Model Derivative resource, waiting out `202 Accepted` (APS is still
+ * extracting the property database) for at most `maxAttempts` requests.
+ */
+async function getJson(ctx, node, token, path, region, limits, retry, what) {
+    for (let attempt = 1;; attempt++) {
+        const res = await apsGet(ctx, node, token, path, { region, ...limits });
+        if (res.status === 202) {
+            if (attempt >= retry.maxAttempts) {
+                throw new Error(`${node}: ${what} still processing on APS after ${attempt} attempt(s) (HTTP 202); the derivative is being extracted — re-run later or raise maxAttempts/retryDelayMs`);
+            }
+            ctx.log('info', `${what}: APS is still processing (HTTP 202), retry ${attempt}/${retry.maxAttempts - 1} in ${retry.retryDelayMs} ms`);
+            await delay(retry.retryDelayMs, ctx.signal);
+            continue;
+        }
+        if (res.status >= 200 && res.status < 300) {
+            try {
+                return JSON.parse(res.body);
+            }
+            catch {
+                throw new Error(`${node}: ${what} returned a non-JSON body`);
+            }
+        }
+        throw new Error(`${node}: ${what} failed — ${describeStatus(res.status)} ${res.body.replace(/\s+/g, ' ').slice(0, 300)}`.trim());
+    }
+}
+function describeStatus(status) {
+    if (status === 401 || status === 403) {
+        return `not authorised (HTTP ${status}): the token lacks data:read/viewables:read, or a 2-legged app is not provisioned for this ACC/BIM 360 hub (use a 3-legged accessToken).`;
+    }
+    if (status === 404)
+        return 'not found (HTTP 404): the URN has no derivatives (not translated yet, wrong region, or wrong URN).';
+    if (status === 413)
+        return 'too large (HTTP 413): set forceget to true.';
+    return `HTTP ${status}:`;
+}
+function pickView(metadata, requested) {
+    const list = metadata?.data?.metadata;
+    const views = (Array.isArray(list) ? list : []).filter((v) => !!v && typeof v.guid === 'string');
+    if (requested) {
+        const hit = views.find((v) => v.guid === requested);
+        if (!hit)
+            throw new Error(`view "${requested}" is not in this model's metadata (views: ${views.map((v) => `${v.guid} ${v.name ?? ''} [${v.role ?? '?'}]`).join(', ') || 'none'})`);
+        return hit;
+    }
+    const threeD = views.filter((v) => v.role === '3d');
+    const view = threeD.find((v) => v.isMasterView) ?? threeD[0];
+    if (!view)
+        throw new Error(`the model has no 3d view (views: ${views.map((v) => `${v.name ?? v.guid} [${v.role ?? '?'}]`).join(', ') || 'none'}); set viewGuid`);
+    return view;
+}
+export const apsNodes = [
+    {
+        type: 'aps.token',
+        title: 'APS token',
+        category: 'network',
+        doc: 'An Autodesk Platform Services access token as an opaque handle for aps.* nodes: 2-legged from clientId/clientSecret, or a ready accessToken (3-legged). The token itself is never output, logged or serialised.',
+        inputs: [],
+        outputs: [{ name: 'token', type: ANY_ITEM }],
+        params: CREDENTIAL_PARAMS,
+        capabilities: ['network.fetch:*'],
+        requires: { network: true },
+        volatile: true,
+        run: async (ctx, _i, p) => ({ token: await tokenFromParams(ctx, 'aps.token', p) }),
+    },
+    {
+        type: 'aps.modelProperties',
+        title: 'APS model properties',
+        category: 'network',
+        doc: 'Reads Model Derivative metadata and properties of a translated model (base64 derivative URN, or a Docs/ACC version id) into a table: objectid, externalId (Revit UniqueId), name, category, IfcGUID and every property as a Group.Property column. Joinable with IFC via table.joinByKey.',
+        inputs: [
+            { name: 'token', type: ANY_ITEM, optional: true, doc: 'From aps.token; otherwise the credential params are used.' },
+            { name: 'urn', type: SCALAR_ITEM, optional: true, doc: 'Overrides the urn param.' },
+        ],
+        outputs: [
+            { name: 'table', type: TABLE_ITEM },
+            { name: 'view', type: SCALAR_ITEM },
+        ],
+        params: [
+            { name: 'urn', kind: 'string', default: '', doc: 'Base64 derivative URN, or a urn:adsk.wipprod:fs.file:vf.…?version=N version id (encoded for you).' },
+            { name: 'viewGuid', kind: 'string', default: '', doc: 'Metadata view guid; defaults to the master (else first) 3d view.' },
+            { name: 'region', kind: 'enum', default: 'US', options: [...APS_REGIONS], doc: 'Data centre, sent as x-ads-region.' },
+            { name: 'key', kind: 'string', default: 'externalId', doc: 'Key column of the output table, e.g. externalId, IfcGUID or objectid.' },
+            { name: 'forceget', kind: 'boolean', default: false, doc: 'Ask APS for a property payload over its 20 MB default (answers HTTP 413 otherwise).' },
+            { name: 'maxAttempts', kind: 'number', default: DEFAULT_MAX_ATTEMPTS, doc: 'Requests per resource while APS answers 202 (still processing).' },
+            { name: 'retryDelayMs', kind: 'number', default: DEFAULT_RETRY_DELAY_MS },
+            { name: 'timeoutMs', kind: 'number', default: DEFAULT_TIMEOUT_MS },
+            { name: 'maxBytes', kind: 'number', default: DEFAULT_MAX_BYTES, doc: 'Response size cap per request.' },
+            ...CREDENTIAL_PARAMS,
+        ],
+        capabilities: ['network.fetch:*'],
+        requires: { network: true },
+        volatile: true,
+        run: async (ctx, i, p) => {
+            const node = 'aps.modelProperties';
+            const rawUrn = str(i.urn) || str(p.urn);
+            let urn;
+            try {
+                urn = toDerivativeUrn(rawUrn);
+            }
+            catch (err) {
+                throw new Error(`${node}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            const region = APS_REGIONS.includes(str(p.region).toUpperCase()) ? str(p.region).toUpperCase() : 'US';
+            const limits = { timeoutMs: bounded(p.timeoutMs, DEFAULT_TIMEOUT_MS, 1), maxBytes: bounded(p.maxBytes, DEFAULT_MAX_BYTES, 1) };
+            const retry = {
+                maxAttempts: Math.floor(bounded(p.maxAttempts, DEFAULT_MAX_ATTEMPTS, 1)),
+                retryDelayMs: bounded(p.retryDelayMs, DEFAULT_RETRY_DELAY_MS, 0),
+            };
+            const token = await resolveToken(ctx, node, i.token, p);
+            const base = `/modelderivative/v2/designdata/${urn}/metadata`;
+            const metadata = await getJson(ctx, node, token, base, region, limits, retry, 'metadata');
+            let view;
+            try {
+                view = pickView(metadata, str(p.viewGuid));
+            }
+            catch (err) {
+                throw new Error(`${node}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            const query = p.forceget === true ? '?forceget=true' : '';
+            const props = await getJson(ctx, node, token, `${base}/${encodeURIComponent(view.guid)}/properties${query}`, region, limits, retry, 'properties');
+            const collection = props?.data?.collection;
+            if (!Array.isArray(collection))
+                throw new Error(`${node}: properties response has no data.collection`);
+            try {
+                return { table: propertiesToTable(collection, str(p.key) || 'externalId'), view: view.guid };
+            }
+            catch (err) {
+                throw new Error(`${node}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    },
+];
+//# sourceMappingURL=aps-nodes.js.map

package/dist/aps-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-nodes.js","sourceRoot":"","sources":["../src/aps-nodes.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,GAC5G,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAA8B,MAAM,WAAW,CAAC;AAG1F,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAErC,MAAM,iBAAiB,GAAe;IACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,8FAA8F,EAAE;IACtJ,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,2EAA2E,EAAE;IACvI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,sCAAsC,EAAE;IAC1G,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,8FAA8F,EAAE;CAC1J,CAAC;AAEF,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW;IAC5D,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAC5H,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAQ,EAAE,IAAY,EAAE,CAAoC;IACzF,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,WAAW;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iIAAiI,CAAC,CAAC;IAC5J,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,CAAC;AAClG,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,IAAY,EAAE,KAAc,EAAE,CAAoC;IACtG,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6GAA6G,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAOD;;;GAGG;AACH,KAAK,UAAU,OAAO,CACpB,GAAQ,EAAE,IAAY,EAAE,KAAe,EAAE,IAAY,EAAE,MAAc,EAAE,MAA+C,EAAE,KAAY,EAAE,IAAY;IAElJ,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACxE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,kCAAkC,OAAO,4GAA4G,CAAC,CAAC;YACzL,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,+CAA+C,OAAO,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC;YACtI,MAAM,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAY,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,2BAA2B,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,aAAa,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACnI,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,wBAAwB,MAAM,0IAA0I,CAAC;IAClL,CAAC;IACD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,oGAAoG,CAAC;IAChI,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,6CAA6C,CAAC;IACzE,OAAO,QAAQ,MAAM,GAAG,CAAC;AAC3B,CAAC;AASD,SAAS,QAAQ,CAAC,QAAiB,EAAE,SAAiB;IACpD,MAAM,IAAI,GAAI,QAA8C,EAAE,IAAI,EAAE,QAAQ,CAAC;IAC7E,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAQ,CAAkB,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACtI,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,6CAA6C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;QACnL,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,iBAAiB,CAAC,CAAC;IACjK,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,SAAS;QACnB,GAAG,EAAE,iNAAiN;QACtN,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,iBAAiB;QACzB,YAAY,EAAE,CAAC,iBAAiB,CAAC;QACjC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;KACnF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,sBAAsB;QAC7B,QAAQ,EAAE,SAAS;QACnB,GAAG,EAAE,2RAA2R;QAChS,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,2DAA2D,EAAE;YACnH,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,0BAA0B,EAAE;SACpF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE;YACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;SACpC;QACD,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,mGAAmG,EAAE;YACtJ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,kEAAkE,EAAE;YAC1H,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,GAAG,EAAE,oCAAoC,EAAE;YACrH,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,uEAAuE,EAAE;YACpI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,qFAAqF,EAAE;YACjJ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,iEAAiE,EAAE;YAC9I,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE;YACzE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE;YAClE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,gCAAgC,EAAE;YACvG,GAAG,iBAAiB;SACrB;QACD,YAAY,EAAE,CAAC,iBAAiB,CAAC;QACjC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,qBAAqB,CAAC;YACnC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,GAAW,CAAC;YAChB,IAAI,CAAC;gBACH,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,MAAM,GAAI,WAAiC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7H,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/H,MAAM,KAAK,GAAU;gBACnB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;gBACxE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,sBAAsB,EAAE,CAAC,CAAC;aACjE,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAExD,MAAM,IAAI,GAAG,kCAAkC,GAAG,WAAW,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YAC1F,IAAI,IAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YAClJ,MAAM,UAAU,GAAI,KAA6C,EAAE,IAAI,EAAE,UAAU,CAAC;YACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,8CAA8C,CAAC,CAAC;YACvG,IAAI,CAAC;gBACH,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;KACF;CACF,CAAC"}

package/dist/aps-table.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Model Derivative property collection → flow `Table` (#5634).
+ *
+ * `GET …/metadata/{guid}/properties` returns
+ * `{ data: { type: 'properties', collection: [{ objectid, name, externalId, properties }] } }`
+ * where `properties` maps a display group (`Identity Data`, `Dimensions`, …)
+ * to its name/value pairs. One row per object:
+ *   - `objectid` (viewer dbId), `externalId` (for Revit the element UniqueId),
+ *     `name`;
+ *   - `category`: the first `Category` value found, the hidden `__category__`
+ *     group first (the Revit viewer's property database keeps it there), then
+ *     every other group in response order;
+ *   - `IfcGUID`: promoted from whichever group carries it (Revit writes it
+ *     under `IFC Parameters`), so the table joins with an IFC export's
+ *     `GlobalId` via `table.joinByKey` without the caller knowing the group;
+ *   - every property flattened to a `Group.Property` column.
+ * A column whose values are all numbers is typed `real`, all booleans
+ * `boolean`; anything else is `string`. Nothing is dropped: a row without an
+ * `externalId` keeps a null there, and the caller picks the key column.
+ */
+import type { Table } from '@ifc-lite/flow';
+/** Build the table; `key` must name one of its columns. */
+export declare function propertiesToTable(collection: readonly unknown[], key: string): Table;
+//# sourceMappingURL=aps-table.d.ts.map

package/dist/aps-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-table.d.ts","sourceRoot":"","sources":["../src/aps-table.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAiC,KAAK,EAAE,MAAM,gBAAgB,CAAC;AA6D3E,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CA2DpF"}

package/dist/aps-table.js

@@ -0,0 +1,123 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+const FIXED = ['objectid', 'externalId', 'name', 'category', 'IfcGUID'];
+function isRecord(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function toCell(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === 'string' || typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : String(v);
+    if (Array.isArray(v))
+        return v.map((x) => (isRecord(x) || Array.isArray(x) ? JSON.stringify(x) : String(x))).join('; ');
+    return JSON.stringify(v);
+}
+/**
+ * Flatten a property tree to `path → value` leaves. Iterative (a JSON tree
+ * has no cycles, but a deep one must not cost stack), arrays kept as leaves.
+ */
+function flatten(properties) {
+    const out = new Map();
+    const stack = [['', properties]];
+    while (stack.length > 0) {
+        const [prefix, obj] = stack.pop();
+        const groups = [];
+        for (const [k, v] of Object.entries(obj)) {
+            const path = prefix ? `${prefix}.${k}` : k;
+            if (isRecord(v))
+                groups.push([path, v]);
+            else
+                out.set(path, v);
+        }
+        // Reversed, so groups pop off the stack in response order.
+        for (let g = groups.length - 1; g >= 0; g--)
+            stack.push(groups[g]);
+    }
+    return out;
+}
+function findProperty(properties, prop, preferGroup) {
+    const groups = Object.entries(properties).filter((e) => isRecord(e[1]));
+    if (preferGroup)
+        groups.sort(([a], [b]) => Number(b === preferGroup) - Number(a === preferGroup));
+    for (const [, group] of groups) {
+        const v = group[prop];
+        if (v !== undefined && v !== null && v !== '')
+            return v;
+    }
+    return null;
+}
+function inferType(values) {
+    const present = values.filter((v) => v !== null);
+    if (present.length > 0 && present.every((v) => typeof v === 'number'))
+        return 'real';
+    if (present.length > 0 && present.every((v) => typeof v === 'boolean'))
+        return 'boolean';
+    return 'string';
+}
+/** Build the table; `key` must name one of its columns. */
+export function propertiesToTable(collection, key) {
+    const fixedRows = [];
+    const flatRows = [];
+    const propColumns = [];
+    const seen = new Set();
+    for (const raw of collection) {
+        if (!isRecord(raw))
+            continue;
+        const item = raw;
+        const properties = isRecord(item.properties) ? item.properties : {};
+        fixedRows.push({
+            objectid: typeof item.objectid === 'number' ? item.objectid : null,
+            externalId: typeof item.externalId === 'string' && item.externalId.length > 0 ? item.externalId : null,
+            name: typeof item.name === 'string' ? item.name : null,
+            category: toCell(findProperty(properties, 'Category', '__category__')),
+            IfcGUID: toCell(findProperty(properties, 'IfcGUID', 'IFC Parameters')),
+        });
+        const flat = flatten(properties);
+        flatRows.push(flat);
+        for (const path of flat.keys()) {
+            if (seen.has(path))
+                continue;
+            seen.add(path);
+            propColumns.push(path);
+        }
+    }
+    // A top-level scalar property named like a fixed column would overwrite it.
+    const reserved = new Set(FIXED);
+    const columnName = new Map(propColumns.map((p) => [p, reserved.has(p) ? `properties.${p}` : p]));
+    const rows = fixedRows.map((fixed, i) => {
+        const row = { ...fixed };
+        for (const path of propColumns)
+            row[columnName.get(path)] = toCell(flatRows[i].get(path));
+        return row;
+    });
+    const columns = [
+        { name: 'objectid', type: 'integer' },
+        { name: 'externalId', type: 'identifier' },
+        { name: 'name', type: 'label' },
+        { name: 'category', type: 'label' },
+        { name: 'IfcGUID', type: 'identifier' },
+        ...propColumns.map((p) => {
+            const name = columnName.get(p);
+            return { name, type: inferType(rows.map((r) => r[name])) };
+        }),
+    ];
+    // Mixed columns were inferred `string`: make their cells agree.
+    for (const col of columns) {
+        if (col.type !== 'string')
+            continue;
+        for (const row of rows) {
+            const v = row[col.name];
+            if (v !== null && typeof v !== 'string')
+                row[col.name] = String(v);
+        }
+    }
+    if (!columns.some((c) => c.name === key)) {
+        throw new Error(`key column "${key}" is not in the table (columns: ${columns.slice(0, 12).map((c) => c.name).join(', ')}${columns.length > 12 ? ', …' : ''})`);
+    }
+    return { columns, rows, key };
+}
+//# sourceMappingURL=aps-table.js.map