@things-factory/dataset 10.0.0-zeta.7 → 10.0.0

package/dist-server/service/data-spec/data-spec.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSpecList = exports.DataSpec = exports.DataSpecItem = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+let DataSpecItem = class DataSpecItem {
+};
+exports.DataSpecItem = DataSpecItem;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The data type of the specification item.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpecItem.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The display label for the specification item.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpecItem.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The unique name identifier for the specification item.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpecItem.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Placeholder text for the input field.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpecItem.prototype, "placeholder", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, {
+        nullable: true,
+        description: 'Additional properties and configuration for the specification item.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], DataSpecItem.prototype, "property", void 0);
+exports.DataSpecItem = DataSpecItem = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({
+        description: 'Represents a specification item that defines the structure and validation rules for a data field.'
+    })
+], DataSpecItem);
+let DataSpec = class DataSpec {
+};
+exports.DataSpec = DataSpec;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The unique name identifier for the data specification.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpec.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'A description of the data specification and its purpose.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpec.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Help text or documentation for the data specification.' }),
+    tslib_1.__metadata("design:type", String)
+], DataSpec.prototype, "help", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [DataSpecItem], {
+        nullable: true,
+        description: 'The specification items that define the data structure and validation rules.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], DataSpec.prototype, "specItems", void 0);
+exports.DataSpec = DataSpec = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({
+        description: 'Represents a data specification that defines the structure, validation rules, and metadata for a dataset.'
+    })
+], DataSpec);
+let DataSpecList = class DataSpecList {
+};
+exports.DataSpecList = DataSpecList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [DataSpec], { description: 'List of data specifications.' }),
+    tslib_1.__metadata("design:type", Array)
+], DataSpecList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Total number of data specifications in the list.' }),
+    tslib_1.__metadata("design:type", Number)
+], DataSpecList.prototype, "total", void 0);
+exports.DataSpecList = DataSpecList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Represents a paginated list of data specifications.' })
+], DataSpecList);
+//# sourceMappingURL=data-spec.js.map

package/dist-server/service/data-spec/data-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-spec.js","sourceRoot":"","sources":["../../../server/service/data-spec/data-spec.ts"],"names":[],"mappings":";;;;AAAA,+CAAqD;AAErD,iDAAoD;AAK7C,IAAM,YAAY,GAAlB,MAAM,YAAY;CAkBxB,CAAA;AAlBY,oCAAY;AAEvB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;;0CACvD;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;;2CAC3D;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;;0CACrE;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;;iDAC5D;AAMpB;IAJC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,qEAAqE;KACnF,CAAC;;8CAC+B;uBAjBtB,YAAY;IAHxB,IAAA,yBAAU,EAAC;QACV,WAAW,EAAE,mGAAmG;KACjH,CAAC;GACW,YAAY,CAkBxB;AAMM,IAAM,QAAQ,GAAd,MAAM,QAAQ;CAepB,CAAA;AAfY,4BAAQ;AAEnB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;;sCACrE;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC;;6CAChF;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;;sCACrF;AAMZ;IAJC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,8EAA8E;KAC5F,CAAC;;2CACuB;mBAdd,QAAQ;IAJpB,IAAA,yBAAU,EAAC;QACV,WAAW,EACT,2GAA2G;KAC9G,CAAC;GACW,QAAQ,CAepB;AAGM,IAAM,YAAY,GAAlB,MAAM,YAAY;CAMxB,CAAA;AANY,oCAAY;AAEvB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;;2CAC1D;AAGjB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;;2CAC3E;uBALF,YAAY;IADxB,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;GACtE,YAAY,CAMxB","sourcesContent":["import { Field, Int, ObjectType } from 'type-graphql'\n\nimport { ScalarObject } from '@things-factory/shell'\n\n@ObjectType({\n  description: 'Represents a specification item that defines the structure and validation rules for a data field.'\n})\nexport class DataSpecItem {\n  @Field({ description: 'The data type of the specification item.' })\n  type: string\n\n  @Field({ description: 'The display label for the specification item.' })\n  label: string\n\n  @Field({ description: 'The unique name identifier for the specification item.' })\n  name: string\n\n  @Field({ nullable: true, description: 'Placeholder text for the input field.' })\n  placeholder?: string\n\n  @Field(type => ScalarObject, {\n    nullable: true,\n    description: 'Additional properties and configuration for the specification item.'\n  })\n  property?: { [key: string]: any }\n}\n\n@ObjectType({\n  description:\n    'Represents a data specification that defines the structure, validation rules, and metadata for a dataset.'\n})\nexport class DataSpec {\n  @Field({ description: 'The unique name identifier for the data specification.' })\n  name: string\n\n  @Field({ nullable: true, description: 'A description of the data specification and its purpose.' })\n  description: string\n\n  @Field({ nullable: true, description: 'Help text or documentation for the data specification.' })\n  help: string\n\n  @Field(type => [DataSpecItem], {\n    nullable: true,\n    description: 'The specification items that define the data structure and validation rules.'\n  })\n  specItems: DataSpecItem[]\n}\n\n@ObjectType({ description: 'Represents a paginated list of data specifications.' })\nexport class DataSpecList {\n  @Field(type => [DataSpec], { description: 'List of data specifications.' })\n  items: DataSpec[]\n\n  @Field(type => Int, { description: 'Total number of data specifications in the list.' })\n  total: number\n}\n"]}

package/dist-server/service/data-spec/index.d.ts

@@ -0,0 +1,4 @@
+import { DataSpec } from './data-spec.js';
+import { DataSpecQuery } from './data-spec-query.js';
+export declare const entities: (typeof DataSpec)[];
+export declare const resolvers: (typeof DataSpecQuery)[];

package/dist-server/service/data-spec/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const data_spec_js_1 = require("./data-spec.js");
+const data_spec_query_js_1 = require("./data-spec-query.js");
+exports.entities = [data_spec_js_1.DataSpec];
+exports.resolvers = [data_spec_query_js_1.DataSpecQuery];
+//# sourceMappingURL=index.js.map

package/dist-server/service/data-spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/data-spec/index.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,6DAAoD;AAEvC,QAAA,QAAQ,GAAG,CAAC,uBAAQ,CAAC,CAAA;AACrB,QAAA,SAAS,GAAG,CAAC,kCAAa,CAAC,CAAA","sourcesContent":["import { DataSpec } from './data-spec.js'\nimport { DataSpecQuery } from './data-spec-query.js'\n\nexport const entities = [DataSpec]\nexport const resolvers = [DataSpecQuery]\n"]}

package/dist-server/service/data-summary/data-summary-mutation.d.ts

@@ -0,0 +1,6 @@
+export declare class DataSummaryMutation {
+    generateLatestDataSummaries(dataSetId: string, context: ResolverContext): Promise<boolean>;
+    finalizeLatestDataCollection(dataSetId: string, context: ResolverContext): Promise<boolean>;
+    generateDataSummaries(dataSetId: string, date: string, period: string, context: ResolverContext): Promise<boolean>;
+    finalizeDataCollection(dataSetId: string, date: string, period: string, context: ResolverContext): Promise<boolean>;
+}

package/dist-server/service/data-summary/data-summary-mutation.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSummaryMutation = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const data_summary_js_1 = require("./data-summary.js");
+const finalize_data_collection_js_1 = require("../../controllers/finalize-data-collection.js");
+let DataSummaryMutation = class DataSummaryMutation {
+    async generateLatestDataSummaries(dataSetId, context) {
+        return await (0, finalize_data_collection_js_1.finalizeLatestDataCollection)(dataSetId, context);
+    }
+    async finalizeLatestDataCollection(dataSetId, context) {
+        return await (0, finalize_data_collection_js_1.finalizeLatestDataCollection)(dataSetId, context);
+    }
+    async generateDataSummaries(dataSetId, date, period, context) {
+        return await (0, finalize_data_collection_js_1.finalizeDataCollection)(dataSetId, date, period, context);
+    }
+    async finalizeDataCollection(dataSetId, date, period, context) {
+        return await (0, finalize_data_collection_js_1.finalizeDataCollection)(dataSetId, date, period, context);
+    }
+};
+exports.DataSummaryMutation = DataSummaryMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, {
+        description: 'Deprecated. Use finalizeLatestDataCollection',
+        deprecationReason: 'This resolver has been replaced by finalizeLatestDataCollection'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryMutation.prototype, "generateLatestDataSummaries", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, {
+        description: 'Finalizes and generates the latest data summaries for the specified dataset. This operation aggregates collected data into summary records for reporting and analysis.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryMutation.prototype, "finalizeLatestDataCollection", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, {
+        description: 'Deprecated. Use finalizeDataCollection',
+        deprecationReason: 'This resolver has been replaced by finalizeDataCollection'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('date')),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('period')),
+    tslib_1.__param(3, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryMutation.prototype, "generateDataSummaries", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, {
+        description: 'Finalizes data collection for a specific period and generates summary records. This operation processes all collected data within the specified time range.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('date')),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('period')),
+    tslib_1.__param(3, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryMutation.prototype, "finalizeDataCollection", null);
+exports.DataSummaryMutation = DataSummaryMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(data_summary_js_1.DataSummary)
+], DataSummaryMutation);
+//# sourceMappingURL=data-summary-mutation.js.map

package/dist-server/service/data-summary/data-summary-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-summary-mutation.js","sourceRoot":"","sources":["../../../server/service/data-summary/data-summary-mutation.ts"],"names":[],"mappings":";;;;AAAA,+CAAsE;AAEtE,uDAA+C;AAC/C,+FAAoH;AAG7G,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAMxB,AAAN,KAAK,CAAC,2BAA2B,CACb,SAAiB,EAC5B,OAAwB;QAE/B,OAAO,MAAM,IAAA,0DAA4B,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC/D,CAAC;IAOK,AAAN,KAAK,CAAC,4BAA4B,CACd,SAAiB,EAC5B,OAAwB;QAE/B,OAAO,MAAM,IAAA,0DAA4B,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC/D,CAAC;IAOK,AAAN,KAAK,CAAC,qBAAqB,CACP,SAAiB,EACtB,IAAY,EACV,MAAc,EACtB,OAAwB;QAE/B,OAAO,MAAM,IAAA,oDAAsB,EAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACvE,CAAC;IAOK,AAAN,KAAK,CAAC,sBAAsB,CACR,SAAiB,EACtB,IAAY,EACV,MAAc,EACtB,OAAwB;QAE/B,OAAO,MAAM,IAAA,oDAAsB,EAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACvE,CAAC;CACF,CAAA;AApDY,kDAAmB;AAMxB;IALL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAC5B,WAAW,EAAE,8CAA8C;QAC3D,iBAAiB,EAAE,iEAAiE;KACrF,CAAC;IAEC,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;IAChB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;sEAGP;AAOK;IALL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAC5B,WAAW,EACT,wKAAwK;KAC3K,CAAC;IAEC,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;IAChB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;uEAGP;AAOK;IALL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAC5B,WAAW,EAAE,wCAAwC;QACrD,iBAAiB,EAAE,2DAA2D;KAC/E,CAAC;IAEC,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;IAChB,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IACX,mBAAA,IAAA,kBAAG,EAAC,QAAQ,CAAC,CAAA;IACb,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gEAGP;AAOK;IALL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAC5B,WAAW,EACT,6JAA6J;KAChK,CAAC;IAEC,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;IAChB,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IACX,mBAAA,IAAA,kBAAG,EAAC,QAAQ,CAAC,CAAA;IACb,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;iEAGP;8BAnDU,mBAAmB;IAD/B,IAAA,uBAAQ,EAAC,6BAAW,CAAC;GACT,mBAAmB,CAoD/B","sourcesContent":["import { Resolver, Mutation, Arg, Ctx, Directive } from 'type-graphql'\n\nimport { DataSummary } from './data-summary.js'\nimport { finalizeDataCollection, finalizeLatestDataCollection } from '../../controllers/finalize-data-collection.js'\n\n@Resolver(DataSummary)\nexport class DataSummaryMutation {\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, {\n    description: 'Deprecated. Use finalizeLatestDataCollection',\n    deprecationReason: 'This resolver has been replaced by finalizeLatestDataCollection'\n  })\n  async generateLatestDataSummaries(\n    @Arg('dataSetId') dataSetId: string,\n    @Ctx() context: ResolverContext\n  ): Promise<boolean> {\n    return await finalizeLatestDataCollection(dataSetId, context)\n  }\n\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, {\n    description:\n      'Finalizes and generates the latest data summaries for the specified dataset. This operation aggregates collected data into summary records for reporting and analysis.'\n  })\n  async finalizeLatestDataCollection(\n    @Arg('dataSetId') dataSetId: string,\n    @Ctx() context: ResolverContext\n  ): Promise<boolean> {\n    return await finalizeLatestDataCollection(dataSetId, context)\n  }\n\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, {\n    description: 'Deprecated. Use finalizeDataCollection',\n    deprecationReason: 'This resolver has been replaced by finalizeDataCollection'\n  })\n  async generateDataSummaries(\n    @Arg('dataSetId') dataSetId: string,\n    @Arg('date') date: string,\n    @Arg('period') period: string,\n    @Ctx() context: ResolverContext\n  ): Promise<boolean> {\n    return await finalizeDataCollection(dataSetId, date, period, context)\n  }\n\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, {\n    description:\n      'Finalizes data collection for a specific period and generates summary records. This operation processes all collected data within the specified time range.'\n  })\n  async finalizeDataCollection(\n    @Arg('dataSetId') dataSetId: string,\n    @Arg('date') date: string,\n    @Arg('period') period: string,\n    @Ctx() context: ResolverContext\n  ): Promise<boolean> {\n    return await finalizeDataCollection(dataSetId, date, period, context)\n  }\n}\n"]}

package/dist-server/service/data-summary/data-summary-query.d.ts

@@ -0,0 +1,19 @@
+import { Domain, ListParam } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+import { DataItem } from '../data-set/data-item-type.js';
+import { DataSet } from '../data-set/data-set.js';
+import { DataSummary } from './data-summary.js';
+import { DataSummaryList, DynamicDataSummary } from './data-summary-type.js';
+export declare class DataSummaryQuery {
+    dataSummary(id: string, context: ResolverContext): Promise<DataSummary>;
+    dataSummaries(params: ListParam, context: ResolverContext): Promise<DataSummaryList>;
+    dataSummaryByPeriod(period: 'today' | 'this month' | '30 days' | 'this year' | '12 months' | 'date range' | 'month', dataSetName: string, dataKeys: string[] | null, params: ListParam, context: ResolverContext): Promise<DynamicDataSummary[]>;
+    dataSummariesByDataSetName(dataSetName: string, params: ListParam, context: ResolverContext): Promise<DataSummaryList>;
+    dataSummariesByDataSet(dataSetId: string, params: ListParam, context: ResolverContext): Promise<DataSummaryList>;
+    dataSummariesByDataKeySet(dataKeySetId: string, params: ListParam, context: ResolverContext): Promise<DataSummaryList>;
+    dataItems(dataSummary: DataSummary): Promise<DataItem[]>;
+    dataSet(dataSummary: DataSummary): Promise<DataSet>;
+    domain(dataSummary: DataSummary): Promise<Domain>;
+    updater(dataSummary: DataSummary): Promise<User>;
+    creator(dataSummary: DataSummary): Promise<User>;
+}

package/dist-server/service/data-summary/data-summary-query.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSummaryQuery = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const data_key_set_js_1 = require("../data-key-set/data-key-set.js");
+const data_item_type_js_1 = require("../data-set/data-item-type.js");
+const data_set_js_1 = require("../data-set/data-set.js");
+const data_summary_js_1 = require("./data-summary.js");
+const data_summary_type_js_1 = require("./data-summary-type.js");
+const query_data_summary_by_period_js_1 = require("../../controllers/query-data-summary-by-period.js");
+const domain_inheritance_js_1 = require("../../utils/domain-inheritance.js");
+let DataSummaryQuery = class DataSummaryQuery {
+    async dataSummary(id, context) {
+        const { domain } = context.state;
+        const domainIds = await (0, domain_inheritance_js_1.getDomainIdsWithAncestors)(domain);
+        return await (0, shell_1.getRepository)(data_summary_js_1.DataSummary).findOne({
+            where: { domain: { id: (0, typeorm_1.In)(domainIds) }, id }
+        });
+    }
+    async dataSummaries(params, context) {
+        const { domain } = context.state;
+        const domainIds = await (0, domain_inheritance_js_1.getDomainIdsWithAncestors)(domain);
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            domain: undefined,
+            params,
+            repository: (0, shell_1.getRepository)(data_summary_js_1.DataSummary),
+            searchables: ['name', 'description']
+        });
+        queryBuilder.andWhere(`${queryBuilder.alias}.domain IN (:...ancestorDomainIds)`, {
+            ancestorDomainIds: domainIds
+        });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async dataSummaryByPeriod(period, dataSetName, dataKeys, params, context) {
+        return await (0, query_data_summary_by_period_js_1.queryDataSummaryByPeriod)(period, dataSetName, dataKeys, params, context);
+    }
+    async dataSummariesByDataSetName(dataSetName, params, context) {
+        const { domain } = context.state;
+        const domainIds = await (0, domain_inheritance_js_1.getDomainIdsWithAncestors)(domain);
+        const dataSet = await (0, shell_1.getRepository)(data_set_js_1.DataSet).findOne({
+            where: { domain: { id: (0, typeorm_1.In)(domainIds) }, name: dataSetName },
+            relations: ['dataKeySet']
+        });
+        if (!dataSet) {
+            throw new Error(`dataSet not found by the given dataSetName(${dataSetName})`);
+        }
+        const dataKeyItems = dataSet.dataKeySet?.dataKeyItems || [];
+        const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`);
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            repository: (0, shell_1.getRepository)(data_summary_js_1.DataSummary),
+            params,
+            domain: undefined,
+            alias: 'summary',
+            searchables: ['name', 'description'].concat(searchables)
+        })
+            .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })
+            .innerJoin('summary.dataSet', 'ds', 'ds.id = :dataSetName', { dataSetName: dataSet.id });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async dataSummariesByDataSet(dataSetId, params, context) {
+        const { domain } = context.state;
+        const domainIds = await (0, domain_inheritance_js_1.getDomainIdsWithAncestors)(domain);
+        const dataSet = await (0, shell_1.getRepository)(data_set_js_1.DataSet).findOne({
+            where: { domain: { id: (0, typeorm_1.In)(domainIds) }, id: dataSetId },
+            relations: ['dataKeySet']
+        });
+        if (!dataSet) {
+            throw new Error(`dataSet not found by the given dataSetId(${dataSetId})`);
+        }
+        const dataKeyItems = dataSet.dataKeySet?.dataKeyItems || [];
+        const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`);
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            repository: (0, shell_1.getRepository)(data_summary_js_1.DataSummary),
+            params,
+            domain: undefined,
+            alias: 'summary',
+            searchables: ['name', 'description'].concat(searchables)
+        })
+            .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })
+            .innerJoin('summary.dataSet', 'ds', 'ds.id = :dataSetId', { dataSetId });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async dataSummariesByDataKeySet(dataKeySetId, params, context) {
+        const { domain } = context.state;
+        const domainIds = await (0, domain_inheritance_js_1.getDomainIdsWithAncestors)(domain);
+        const dataKeySet = await (0, shell_1.getRepository)(data_key_set_js_1.DataKeySet).findOneBy({ id: dataKeySetId });
+        const dataKeyItems = dataKeySet?.dataKeyItems || [];
+        const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`);
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            repository: (0, shell_1.getRepository)(data_summary_js_1.DataSummary),
+            params,
+            domain: undefined,
+            alias: 'summary',
+            searchables: ['name', 'description'].concat(searchables)
+        })
+            .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })
+            .innerJoin('summary.dataSet', 'ds', 'ds.dataKeySet = :dataKeySetId', { dataKeySetId });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async dataItems(dataSummary) {
+        const dataSet = dataSummary.dataSetId && (await (0, shell_1.getRepository)(data_set_js_1.DataSet).findOneBy({ id: dataSummary.dataSetId }));
+        return dataSet?.dataItems.filter(item => item.active) || [];
+    }
+    async dataSet(dataSummary) {
+        return dataSummary.dataSetId && (await (0, shell_1.getRepository)(data_set_js_1.DataSet).findOneBy({ id: dataSummary.dataSetId }));
+    }
+    async domain(dataSummary) {
+        return dataSummary.domainId && (await (0, shell_1.getRepository)(shell_1.Domain).findOneBy({ id: dataSummary.domainId }));
+    }
+    async updater(dataSummary) {
+        return dataSummary.updaterId && (await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: dataSummary.updaterId }));
+    }
+    async creator(dataSummary) {
+        return dataSummary.creatorId && (await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: dataSummary.creatorId }));
+    }
+};
+exports.DataSummaryQuery = DataSummaryQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => data_summary_js_1.DataSummary, {
+        nullable: true,
+        description: 'Retrieves a single data summary by its unique identifier. This query fetches aggregated statistical information about data samples including averages, counts, and other summary statistics for a specific time period.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummary", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => data_summary_type_js_1.DataSummaryList, {
+        description: 'Retrieves multiple data summaries with pagination and filtering support. This query allows searching summaries by name and description, and is used for listing and browsing aggregated statistical data across all datasets.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummaries", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(returns => [data_summary_type_js_1.DynamicDataSummary], {
+        description: 'Retrieves dynamically grouped data summaries for a specific time period and dataset. This query provides aggregated statistical information grouped by data keys, enabling trend analysis and performance monitoring across different dimensions.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('period')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('dataSetName')),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('dataKeys', type => [String], { nullable: true })),
+    tslib_1.__param(3, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(4, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Array, shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummaryByPeriod", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "data-summary", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => data_summary_type_js_1.DataSummaryList, {
+        description: "Retrieves data summaries that belong to a specific dataset by dataset name. This query filters summaries by dataset name and includes searchable fields based on the dataset's key configuration, enabling targeted statistical analysis within a particular dataset context."
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetName')),
+    tslib_1.__param(1, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummariesByDataSetName", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "data-summary", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => data_summary_type_js_1.DataSummaryList, {
+        description: "Retrieves data summaries that belong to a specific dataset by dataset ID. This query filters summaries by dataset ID and includes searchable fields based on the dataset's key configuration, enabling targeted statistical analysis within a particular dataset context."
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataSetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummariesByDataSet", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "data-summary", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => data_summary_type_js_1.DataSummaryList, {
+        description: 'Retrieves data summaries that belong to datasets using a specific data key set. This query filters summaries by key set ID and enables cross-dataset statistical analysis based on shared key configurations, useful for comparing aggregated data across related datasets.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('dataKeySetId')),
+    tslib_1.__param(1, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSummariesByDataKeySet", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [data_item_type_js_1.DataItem], {
+        description: 'Retrieves the data items (field definitions) associated with this data summary. These items define the structure and validation rules for the summary data, including field names, types, and constraints.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [data_summary_js_1.DataSummary]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataItems", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => data_set_js_1.DataSet, {
+        description: 'Retrieves the dataset that this data summary belongs to. This field resolver provides access to the dataset configuration and settings associated with the summary.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [data_summary_js_1.DataSummary]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "dataSet", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => shell_1.Domain),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [data_summary_js_1.DataSummary]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "domain", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [data_summary_js_1.DataSummary]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "updater", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [data_summary_js_1.DataSummary]),
+    tslib_1.__metadata("design:returntype", Promise)
+], DataSummaryQuery.prototype, "creator", null);
+exports.DataSummaryQuery = DataSummaryQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(data_summary_js_1.DataSummary)
+], DataSummaryQuery);
+//# sourceMappingURL=data-summary-query.js.map

package/dist-server/service/data-summary/data-summary-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-summary-query.js","sourceRoot":"","sources":["../../../server/service/data-summary/data-summary-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'\nimport { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { DataKeySet } from '../data-key-set/data-key-set.js'\nimport { DataItem } from '../data-set/data-item-type.js'\nimport { DataSet } from '../data-set/data-set.js'\nimport { DataSummary } from './data-summary.js'\nimport { DataSummaryList, DynamicDataSummary } from './data-summary-type.js'\nimport { queryDataSummaryByPeriod } from '../../controllers/query-data-summary-by-period.js'\nimport { getDomainIdsWithAncestors } from '../../utils/domain-inheritance.js'\n\n@Resolver(DataSummary)\nexport class DataSummaryQuery {\n  @Query(returns => DataSummary!, {\n    nullable: true,\n    description:\n      'Retrieves a single data summary by its unique identifier. This query fetches aggregated statistical information about data samples including averages, counts, and other summary statistics for a specific time period.'\n  })\n  async dataSummary(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<DataSummary> {\n    const { domain } = context.state\n    const domainIds = await getDomainIdsWithAncestors(domain)\n\n    return await getRepository(DataSummary).findOne({\n      where: { domain: { id: In(domainIds) }, id }\n    })\n  }\n\n  @Query(returns => DataSummaryList, {\n    description:\n      'Retrieves multiple data summaries with pagination and filtering support. This query allows searching summaries by name and description, and is used for listing and browsing aggregated statistical data across all datasets.'\n  })\n  async dataSummaries(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<DataSummaryList> {\n    const { domain } = context.state\n    const domainIds = await getDomainIdsWithAncestors(domain)\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      domain: undefined,\n      params,\n      repository: getRepository(DataSummary),\n      searchables: ['name', 'description']\n    })\n\n    queryBuilder.andWhere(`${queryBuilder.alias}.domain IN (:...ancestorDomainIds)`, {\n      ancestorDomainIds: domainIds\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  @Query(returns => [DynamicDataSummary], {\n    description:\n      'Retrieves dynamically grouped data summaries for a specific time period and dataset. This query provides aggregated statistical information grouped by data keys, enabling trend analysis and performance monitoring across different dimensions.'\n  })\n  async dataSummaryByPeriod(\n    @Arg('period') period: 'today' | 'this month' | '30 days' | 'this year' | '12 months' | 'date range' | 'month',\n    @Arg('dataSetName') dataSetName: string,\n    @Arg('dataKeys', type => [String], { nullable: true }) dataKeys: string[] | null,\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<DynamicDataSummary[]> {\n    return await queryDataSummaryByPeriod(period, dataSetName, dataKeys, params, context)\n  }\n\n  @Directive('@privilege(category: \"data-summary\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => DataSummaryList, {\n    description:\n      \"Retrieves data summaries that belong to a specific dataset by dataset name. This query filters summaries by dataset name and includes searchable fields based on the dataset's key configuration, enabling targeted statistical analysis within a particular dataset context.\"\n  })\n  async dataSummariesByDataSetName(\n    @Arg('dataSetName') dataSetName: string,\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<DataSummaryList> {\n    const { domain } = context.state\n    const domainIds = await getDomainIdsWithAncestors(domain)\n\n    const dataSet = await getRepository(DataSet).findOne({\n      where: { domain: { id: In(domainIds) }, name: dataSetName },\n      relations: ['dataKeySet']\n    })\n\n    if (!dataSet) {\n      throw new Error(`dataSet not found by the given dataSetName(${dataSetName})`)\n    }\n\n    const dataKeyItems = dataSet.dataKeySet?.dataKeyItems || []\n    const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`)\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(DataSummary),\n      params,\n      domain: undefined,\n      alias: 'summary',\n      searchables: ['name', 'description'].concat(searchables)\n    })\n      .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })\n      .innerJoin('summary.dataSet', 'ds', 'ds.id = :dataSetName', { dataSetName: dataSet.id })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  @Directive('@privilege(category: \"data-summary\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => DataSummaryList, {\n    description:\n      \"Retrieves data summaries that belong to a specific dataset by dataset ID. This query filters summaries by dataset ID and includes searchable fields based on the dataset's key configuration, enabling targeted statistical analysis within a particular dataset context.\"\n  })\n  async dataSummariesByDataSet(\n    @Arg('dataSetId') dataSetId: string,\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<DataSummaryList> {\n    const { domain } = context.state\n    const domainIds = await getDomainIdsWithAncestors(domain)\n\n    const dataSet = await getRepository(DataSet).findOne({\n      where: { domain: { id: In(domainIds) }, id: dataSetId },\n      relations: ['dataKeySet']\n    })\n\n    if (!dataSet) {\n      throw new Error(`dataSet not found by the given dataSetId(${dataSetId})`)\n    }\n\n    const dataKeyItems = dataSet.dataKeySet?.dataKeyItems || []\n    const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`)\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(DataSummary),\n      params,\n      domain: undefined,\n      alias: 'summary',\n      searchables: ['name', 'description'].concat(searchables)\n    })\n      .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })\n      .innerJoin('summary.dataSet', 'ds', 'ds.id = :dataSetId', { dataSetId })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  @Directive('@privilege(category: \"data-summary\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => DataSummaryList, {\n    description:\n      'Retrieves data summaries that belong to datasets using a specific data key set. This query filters summaries by key set ID and enables cross-dataset statistical analysis based on shared key configurations, useful for comparing aggregated data across related datasets.'\n  })\n  async dataSummariesByDataKeySet(\n    @Arg('dataKeySetId') dataKeySetId: string,\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<DataSummaryList> {\n    const { domain } = context.state\n    const domainIds = await getDomainIdsWithAncestors(domain)\n\n    const dataKeySet = await getRepository(DataKeySet).findOneBy({ id: dataKeySetId })\n    const dataKeyItems = dataKeySet?.dataKeyItems || []\n    const searchables = dataKeyItems.map((item, index) => `key0${index + 1}`)\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(DataSummary),\n      params,\n      domain: undefined,\n      alias: 'summary',\n      searchables: ['name', 'description'].concat(searchables)\n    })\n      .andWhere('summary.domain IN (:...ancestorDomainIds)', { ancestorDomainIds: domainIds })\n      .innerJoin('summary.dataSet', 'ds', 'ds.dataKeySet = :dataKeySetId', { dataKeySetId })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  @FieldResolver(type => [DataItem], {\n    description:\n      'Retrieves the data items (field definitions) associated with this data summary. These items define the structure and validation rules for the summary data, including field names, types, and constraints.'\n  })\n  async dataItems(@Root() dataSummary: DataSummary): Promise<DataItem[]> {\n    const dataSet = dataSummary.dataSetId && (await getRepository(DataSet).findOneBy({ id: dataSummary.dataSetId }))\n\n    return dataSet?.dataItems.filter(item => item.active) || []\n  }\n\n  @FieldResolver(type => DataSet, {\n    description:\n      'Retrieves the dataset that this data summary belongs to. This field resolver provides access to the dataset configuration and settings associated with the summary.'\n  })\n  async dataSet(@Root() dataSummary: DataSummary): Promise<DataSet> {\n    return dataSummary.dataSetId && (await getRepository(DataSet).findOneBy({ id: dataSummary.dataSetId }))\n  }\n\n  @FieldResolver(type => Domain)\n  async domain(@Root() dataSummary: DataSummary): Promise<Domain> {\n    return dataSummary.domainId && (await getRepository(Domain).findOneBy({ id: dataSummary.domainId }))\n  }\n\n  @FieldResolver(type => User)\n  async updater(@Root() dataSummary: DataSummary): Promise<User> {\n    return dataSummary.updaterId && (await getRepository(User).findOneBy({ id: dataSummary.updaterId }))\n  }\n\n  @FieldResolver(type => User)\n  async creator(@Root() dataSummary: DataSummary): Promise<User> {\n    return dataSummary.creatorId && (await getRepository(User).findOneBy({ id: dataSummary.creatorId }))\n  }\n}\n"]}

package/dist-server/service/data-summary/data-summary-type.d.ts

@@ -0,0 +1,33 @@
+import { DataSummary } from './data-summary.js';
+export declare class NewDataSummary {
+    name: string;
+    description?: string;
+}
+export declare class DataSummaryPatch {
+    id?: string;
+    name?: string;
+    description?: string;
+    cuFlag?: string;
+}
+export declare class DynamicDataSummary {
+    month?: string;
+    date?: string;
+    period?: string;
+    count?: number;
+    countOoc?: number;
+    countOos?: number;
+    key01?: string;
+    key02?: string;
+    key03?: string;
+    key04?: string;
+    key05?: string;
+    data01?: number;
+    data02?: number;
+    data03?: number;
+    data04?: number;
+    data05?: number;
+}
+export declare class DataSummaryList {
+    items: DataSummary[];
+    total: number;
+}