@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/graph-manager/protocol/pure/v1/V1_LegendCubeServiceCatalog.js

@@ -0,0 +1,69 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { DeploymentOwnershipDetail, UserListOwnershipDetail, } from '@finos/legend-graph';
+import { HttpStatus, NetworkClientError } from '@finos/legend-shared';
+/** Who owns a service, as people read it */
+const ownersOf = (service) => service.ownership instanceof UserListOwnershipDetail
+    ? service.ownership.users
+    : service.ownership instanceof DeploymentOwnershipDetail
+        ? [`Deployment ${service.ownership.identifier}`]
+        : [];
+/** Why the list can't be read, when the engine has no service registry */
+export const V1_CUBE_NO_SERVICE_REGISTRY_MESSAGE = "This Legend deployment's engine has no service registry, so it lists no services";
+const toSummary = (service) => ({
+    name: service.name,
+    title: service.title?.trim() ? service.title.trim() : undefined,
+    pattern: service.pattern,
+    documentation: service.documentation,
+    owners: ownersOf(service),
+});
+/**
+ * Lists the services in the engine's registry
+ * (`/service/v1/list/detailsFromCache`, as Marketplace's Data APIs page). The
+ * list is read once per page; a failed read is tried again.
+ */
+export class V1_LegendCubeServiceCatalog {
+    readServices;
+    services;
+    constructor(readServices) {
+        this.readServices = readServices;
+    }
+    listServices() {
+        if (!this.services) {
+            const services = this.readServices()
+                .catch((error) => {
+                // the registry isn't in the open-source engine
+                throw error instanceof NetworkClientError &&
+                    error.response.status === HttpStatus.NOT_FOUND
+                    ? new Error(V1_CUBE_NO_SERVICE_REGISTRY_MESSAGE)
+                    : error;
+            })
+                .then((details) => details
+                .filter((detail) => detail.name && detail.pattern)
+                .map(toSummary)
+                .sort((left, right) => (left.title ?? left.name).localeCompare(right.title ?? right.name) || left.name.localeCompare(right.name)));
+            // a failed read is tried again next time
+            services.catch(() => {
+                if (this.services === services) {
+                    this.services = undefined;
+                }
+            });
+            this.services = services;
+        }
+        return this.services;
+    }
+}
+//# sourceMappingURL=V1_LegendCubeServiceCatalog.js.map

package/lib/graph-manager/protocol/pure/v1/V1_LegendCubeServiceCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_LegendCubeServiceCatalog.js","sourceRoot":"","sources":["../../../../../src/graph-manager/protocol/pure/v1/V1_LegendCubeServiceCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,yBAAyB,EAEzB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAMtE,4CAA4C;AAC5C,MAAM,QAAQ,GAAG,CAAC,OAAsB,EAAqB,EAAE,CAC7D,OAAO,CAAC,SAAS,YAAY,uBAAuB;IAClD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK;IACzB,CAAC,CAAC,OAAO,CAAC,SAAS,YAAY,yBAAyB;QACtD,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC;AAEX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mCAAmC,GAC9C,kFAAkF,CAAC;AAErF,MAAM,SAAS,GAAG,CAAC,OAAsB,EAAsB,EAAE,CAAC,CAAC;IACjE,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;IAC/D,OAAO,EAAE,OAAO,CAAC,OAAO;IACxB,aAAa,EAAE,OAAO,CAAC,aAAa;IACpC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAO,2BAA2B;IACrB,YAAY,CAAiC;IACtD,QAAQ,CAAqD;IAErE,YAAY,YAA4C;QACtD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE;iBACjC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,+CAA+C;gBAC/C,MAAM,KAAK,YAAY,kBAAkB;oBACvC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,SAAS;oBAC9C,CAAC,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC;oBAChD,CAAC,CAAC,KAAK,CAAC;YACZ,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAChB,OAAO;iBACJ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC;iBACjD,GAAG,CAAC,SAAS,CAAC;iBACd,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,aAAa,CACrC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAC3C,CACJ,CAAC;YACJ,yCAAyC;YACzC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE;gBAClB,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC/B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { jest } from '@jest/globals';
+import { V1_LegendCubeConnectionExplorer } from '../V1_LegendCubeConnectionExplorer.js';
+/** Build one per test (in `beforeEach`): the spy is restored after each test */
+export declare const V1_createEngineBackedCubeConnectionExplorer: () => {
+    explorer: V1_LegendCubeConnectionExplorer;
+    calls: {
+        buildDatabase: jest.Mock;
+    };
+};
+//# sourceMappingURL=V1_CubeConnectionExplorerTestUtils.d.ts.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeConnectionExplorerTestUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKrC,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AAqBxF,gFAAgF;AAChF,eAAO,MAAM,2CAA2C,QAAO;IAC7D,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,KAAK,EAAE;QAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAA;KAAE,CAAC;CAerC,CAAC"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.js

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { jest } from '@jest/globals';
+import { ENGINE_TEST_SUPPORT_API_URL } from '@finos/legend-graph/test';
+import { NetworkClientError, TracerService } from '@finos/legend-shared';
+import { AxiosError } from 'axios';
+import { CUBE_ENGINE_TEST__schemaExploration } from '../../../../../__test-utils__/CubeConnectionTestSupport.js';
+import { V1_LegendCubeConnectionExplorer } from '../V1_LegendCubeConnectionExplorer.js';
+// The real connection explorer, its client's schema exploration routed to the
+// engine on :6300 (PLAN §3.4): the test environment refuses network calls.
+// A failed call is thrown as the client throws it.
+/** A helper's non-2xx response, rethrown as the client throws it */
+const rethrowAsClientError = (error) => {
+    if (error instanceof AxiosError && error.response) {
+        throw new NetworkClientError({
+            status: error.response.status,
+            statusText: String(error.response.status),
+            url: ENGINE_TEST_SUPPORT_API_URL,
+        }, error.response.data);
+    }
+    throw error;
+};
+/** Build one per test (in `beforeEach`): the spy is restored after each test */
+export const V1_createEngineBackedCubeConnectionExplorer = () => {
+    const explorer = new V1_LegendCubeConnectionExplorer({ baseUrl: ENGINE_TEST_SUPPORT_API_URL }, new TracerService());
+    const buildDatabase = jest
+        .spyOn(explorer.client, 'buildDatabase')
+        .mockImplementation(async (input) => CUBE_ENGINE_TEST__schemaExploration(input).catch(rethrowAsClientError));
+    return {
+        explorer,
+        calls: { buildDatabase: buildDatabase },
+    };
+};
+//# sourceMappingURL=V1_CubeConnectionExplorerTestUtils.js.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeConnectionExplorerTestUtils.js","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeConnectionExplorerTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,mCAAmC,EAAE,MAAM,4DAA4D,CAAC;AACjH,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AAExF,8EAA8E;AAC9E,2EAA2E;AAC3E,mDAAmD;AAEnD,oEAAoE;AACpE,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAS,EAAE;IACrD,IAAI,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,kBAAkB,CAC1B;YACE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC7B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzC,GAAG,EAAE,2BAA2B;SACrB,EACb,KAAK,CAAC,QAAQ,CAAC,IAAqC,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAGzD,EAAE;IACF,MAAM,QAAQ,GAAG,IAAI,+BAA+B,CAClD,EAAE,OAAO,EAAE,2BAA2B,EAAE,EACxC,IAAI,aAAa,EAAE,CACpB,CAAC;IACF,MAAM,aAAa,GAAG,IAAI;SACvB,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;SACvC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAClC,mCAAmC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACvE,CAAC;IACJ,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,EAAE,aAAa,EAAE,aAAqC,EAAE;KAChE,CAAC;AACJ,CAAC,CAAC"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PlainObject } from '@finos/legend-shared';
+/** A relation column, as the engine types it */
+export declare const V1_TEST__relationColumn: (name: string, fullPath: string, params?: number[], lowerBound?: number) => PlainObject;
+/** A lambdaGenericType: a relation of these columns, under the outer type given */
+export declare const V1_TEST__relationGenericType: (columns: PlainObject[], outer?: string) => PlainObject;
+/** The orders product's definition, as its project holds it at the deployed version */
+export declare const V1_TEST__ORDERS_DEFINITION: PlainObject;
+/** The orders product's deployed artifact */
+export declare const V1_TEST__ORDERS_ARTIFACT: PlainObject;
+/** A product of Lakehouse access points only, with no model group: definition and artifact */
+export declare const V1_TEST__LAKEHOUSE_ONLY_DEFINITION: PlainObject;
+export declare const V1_TEST__LAKEHOUSE_ONLY_ARTIFACT: PlainObject;
+//# sourceMappingURL=V1_CubeDataProductFixtures.d.ts.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductFixtures.d.ts","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAUxD,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,SAAQ,MAAM,EAAO,EACrB,mBAAc,KACb,WASD,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,GACvC,SAAS,WAAW,EAAE,EACtB,cAAmD,KAClD,WAYD,CAAC;AAcH,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,EAAE,WA4FxC,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,EAAE,WA2HtC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,kCAAkC,EAAE,WAkBhD,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,WAqB9C,CAAC"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.js

@@ -0,0 +1,310 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// A deployed data product's two documents, as the depot serves them, for
+// Cube's tests. Their shapes are copied from legend-graph's
+// TEST_DATA__DataProductAnalysis.ts (the artifact) and
+// legend-extension-dsl-data-product's TEST_DATA__LakehouseDataProducts.ts
+// (the definition); nothing is imported from another package's test utils
+const P = 'meta::pure::precisePrimitives::';
+/** A relation column, as the engine types it */
+export const V1_TEST__relationColumn = (name, fullPath, params = [], lowerBound = 1) => ({
+    name,
+    genericType: {
+        rawType: { _type: 'packageableType', fullPath },
+        typeArguments: [],
+        multiplicityArguments: [],
+        typeVariableValues: params.map((value) => ({ _type: 'integer', value })),
+    },
+    multiplicity: { lowerBound, upperBound: 1 },
+});
+/** A lambdaGenericType: a relation of these columns, under the outer type given */
+export const V1_TEST__relationGenericType = (columns, outer = 'meta::pure::metamodel::relation::Relation') => ({
+    rawType: { _type: 'packageableType', fullPath: outer },
+    typeArguments: [
+        {
+            rawType: { _type: 'relationType', columns },
+            typeArguments: [],
+            multiplicityArguments: [],
+            typeVariableValues: [],
+        },
+    ],
+    multiplicityArguments: [],
+    typeVariableValues: [],
+});
+const lambda = (parameters = []) => ({
+    _type: 'lambda',
+    body: [],
+    parameters,
+});
+const ORDERS_COLUMNS = [
+    V1_TEST__relationColumn('ORDER_ID', `${P}Int`),
+    V1_TEST__relationColumn('REGION', `${P}Varchar`, [200], 0),
+    V1_TEST__relationColumn('AMOUNT', `${P}Numeric`, [10, 2], 0),
+];
+/** The orders product's definition, as its project holds it at the deployed version */
+export const V1_TEST__ORDERS_DEFINITION = {
+    _type: 'dataProduct',
+    package: 'sales::products',
+    name: 'OrdersProduct',
+    title: 'Orders Product',
+    accessPointGroups: [
+        {
+            _type: 'defaultAccessPointGroup',
+            id: 'core',
+            title: 'Core',
+            accessPoints: [
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'daily_orders',
+                    title: 'Daily orders',
+                    description: 'One row per order',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'orders_as_of',
+                    title: 'Orders as of a date',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda([{ _type: 'var', name: 'asOf' }]),
+                },
+                {
+                    _type: 'functionAccessPoint',
+                    id: 'order_function',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'events',
+                    title: 'Order events',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'scalar',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'tags',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'nested',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'undeployed',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+                { _type: 'laterAccessPoint', id: 'later', func: lambda() },
+            ],
+        },
+        {
+            _type: 'defaultAccessPointGroup',
+            id: 'reference',
+            title: 'Reference',
+            accessPoints: [
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'daily_orders',
+                    title: 'Daily customers',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+            ],
+        },
+        {
+            _type: 'modelAccessPointGroup',
+            id: 'model',
+            accessPoints: [
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'modelled',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+            ],
+        },
+    ],
+};
+/** The orders product's deployed artifact */
+export const V1_TEST__ORDERS_ARTIFACT = {
+    dataProduct: {
+        path: 'sales::products::OrdersProduct',
+        deploymentId: 'deployment-1234',
+        title: 'Orders Product',
+        dataProductType: { _type: 'laterDataProductType' },
+    },
+    accessPointGroups: [
+        {
+            id: 'core',
+            accessPointImplementations: [
+                {
+                    id: 'daily_orders',
+                    description: 'Deployed daily orders',
+                    resourceBuilder: [
+                        { _type: 'functionAccessPoint', functionGrammar: '|1' },
+                    ],
+                    lambdaGenericType: V1_TEST__relationGenericType(ORDERS_COLUMNS),
+                    relationElement: {
+                        columns: ['REGION', 'ORDER_ID', 'AMOUNT'],
+                        paths: [],
+                        rows: [1, 2, 3, 4, 5, 6, 7].map((id) => ({
+                            values: [id % 2 ? 'EMEA' : 'APAC', String(id), `${id}.50`],
+                        })),
+                    },
+                },
+                {
+                    id: 'orders_as_of',
+                    lambdaGenericType: V1_TEST__relationGenericType(ORDERS_COLUMNS),
+                },
+                {
+                    id: 'order_function',
+                    lambdaGenericType: V1_TEST__relationGenericType(ORDERS_COLUMNS),
+                },
+                {
+                    id: 'events',
+                    // as artifacts were generated before it became a list
+                    resourceBuilder: {
+                        _type: 'functionAccessPoint',
+                        functionGrammar: '|1',
+                    },
+                    lambdaGenericType: V1_TEST__relationGenericType([
+                        V1_TEST__relationColumn('EVENT_ID', 'Integer'),
+                        V1_TEST__relationColumn('AT', `${P}Timestamp`),
+                        V1_TEST__relationColumn('DAY', 'StrictDate', [], 0),
+                        V1_TEST__relationColumn('RATE', `${P}Float4`, [], 0),
+                        V1_TEST__relationColumn('PAYLOAD', 'meta::pure::metamodel::variant::Variant', [], 0),
+                        // a column with nothing but its type
+                        {
+                            name: 'NOTE',
+                            genericType: {
+                                rawType: { _type: 'packageableType', fullPath: 'String' },
+                            },
+                            multiplicity: { lowerBound: 0, upperBound: 1 },
+                        },
+                    ], 'meta::external::ingest::accessor::IngestRelationAccessor'),
+                },
+                {
+                    id: 'scalar',
+                    lambdaGenericType: {
+                        rawType: { _type: 'packageableType', fullPath: 'String' },
+                    },
+                },
+                {
+                    id: 'tags',
+                    lambdaGenericType: V1_TEST__relationGenericType([
+                        // no upper bound: many values
+                        {
+                            name: 'TAG',
+                            genericType: {
+                                rawType: { _type: 'packageableType', fullPath: 'String' },
+                            },
+                            multiplicity: { lowerBound: 0 },
+                        },
+                    ]),
+                },
+                {
+                    id: 'nested',
+                    lambdaGenericType: V1_TEST__relationGenericType([
+                        {
+                            name: 'INNER',
+                            genericType: { rawType: { _type: 'relationType', columns: [] } },
+                            multiplicity: { lowerBound: 1, upperBound: 1 },
+                        },
+                    ]),
+                },
+                {
+                    id: 'later',
+                    lambdaGenericType: V1_TEST__relationGenericType(ORDERS_COLUMNS),
+                },
+                { id: 'only_in_artifact' },
+            ],
+        },
+        {
+            id: 'reference',
+            accessPointImplementations: [
+                {
+                    id: 'daily_orders',
+                    lambdaGenericType: V1_TEST__relationGenericType([
+                        V1_TEST__relationColumn('CUSTOMER_ID', `${P}Varchar`, [10]),
+                    ]),
+                },
+            ],
+        },
+        {
+            _type: 'modelAccessPointGroup',
+            id: 'model',
+            accessPointImplementations: [
+                {
+                    id: 'modelled',
+                    lambdaGenericType: V1_TEST__relationGenericType(ORDERS_COLUMNS),
+                },
+            ],
+        },
+    ],
+};
+/** A product of Lakehouse access points only, with no model group: definition and artifact */
+export const V1_TEST__LAKEHOUSE_ONLY_DEFINITION = {
+    _type: 'dataProduct',
+    package: 'sales::products',
+    name: 'CustomersProduct',
+    accessPointGroups: [
+        {
+            _type: 'defaultAccessPointGroup',
+            id: 'customers',
+            accessPoints: [
+                {
+                    _type: 'lakehouseAccessPoint',
+                    id: 'all_customers',
+                    targetEnvironment: 'Snowflake',
+                    func: lambda(),
+                },
+            ],
+        },
+    ],
+};
+export const V1_TEST__LAKEHOUSE_ONLY_ARTIFACT = {
+    dataProduct: {
+        path: 'sales::products::CustomersProduct',
+        deploymentId: 'deployment-5678',
+    },
+    accessPointGroups: [
+        {
+            id: 'customers',
+            accessPointImplementations: [
+                {
+                    id: 'all_customers',
+                    resourceBuilder: [
+                        { _type: 'functionAccessPoint', functionGrammar: '|1' },
+                    ],
+                    lambdaGenericType: V1_TEST__relationGenericType([
+                        V1_TEST__relationColumn('CUSTOMER_ID', `${P}Varchar`, [10]),
+                    ]),
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=V1_CubeDataProductFixtures.js.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductFixtures.js","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductFixtures.ts"],"names":[],"mappings":"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"}

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductSearchFixtures.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PlainObject } from '@finos/legend-shared';
+/** The orders product deployed to Production, as a search row: no description */
+export declare const V1_TEST__SEARCH_ROW_ORDERS: PlainObject;
+/** A product whose class comes in 'Production' casing, as some deployments send it */
+export declare const V1_TEST__SEARCH_ROW_CASED: PlainObject;
+/** Rows the search's serializer reads, but Cube doesn't list: one of each kind */
+export declare const V1_TEST__UNLISTED_SEARCH_ROWS: readonly PlainObject[];
+/** Rows of a type the search's serializer doesn't know, on which it throws */
+export declare const V1_TEST__UNREADABLE_SEARCH_ROWS: readonly PlainObject[];
+/** A Lakehouse Access answer: one page of the rows given */
+export declare const V1_TEST__searchPage: (rows: readonly PlainObject[], totalCount?: number) => PlainObject;
+/** Every kind of row, the ones Cube can't read among the ones it lists */
+export declare const V1_TEST__SEARCH_PAGE: PlainObject;
+/** The rows whose types the search's serializer knows, which it reads as a whole page */
+export declare const V1_TEST__SEARCH_PAGE_KNOWN_SHAPES: PlainObject;
+/** The orders product deployed to Production, as the lakehouse's lite list gives it: no description */
+export declare const V1_TEST__LITE_PAGE_ORDERS: PlainObject;
+//# sourceMappingURL=V1_CubeDataProductSearchFixtures.d.ts.map

package/lib/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductSearchFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"V1_CubeDataProductSearchFixtures.d.ts","sourceRoot":"","sources":["../../../../../../src/graph-manager/protocol/pure/v1/__test-utils__/V1_CubeDataProductSearchFixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA2CxD,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAE,WAIxC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,EAAE,WAGtC,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,EAAE,SAAS,WAAW,EAuD/D,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,EAAE,SAAS,WAAW,EASjE,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,GAC9B,MAAM,SAAS,WAAW,EAAE,EAC5B,mBAAwB,KACvB,WAaD,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,EAAE,WAKjC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,iCAAiC,EAAE,WAK5C,CAAC;AAEL,uGAAuG;AACvG,eAAO,MAAM,yBAAyB,EAAE,WA2BvC,CAAC"}