@things-factory/ops-master 10.1.34 → 10.1.36

package/dist-server/service/material/material-revision-resolver.d.ts

@@ -0,0 +1,54 @@
+import { MaterialDefinition } from './material-definition';
+import { MaterialDefinitionDraftContent } from './material-revision-service';
+export declare class MaterialDefinitionRevisionResolver {
+    publishMaterialDefinitionDraft(revisionId: string, editGeneration: number, context: ResolverContext): Promise<import("./material-revision").MaterialDefinitionPlan>;
+    materialDefinitionRevisions(materialId: string, context: ResolverContext): Promise<{
+        materialId: string;
+        name: string;
+        generation: number;
+        at: string;
+        schedule: {
+            state: string;
+            id: string;
+            domain: import("@things-factory/shell").Domain;
+            domainId: string;
+            material: MaterialDefinition;
+            materialId: string;
+            plan: import("./material-revision").MaterialDefinitionPlan;
+            planId: string;
+            revision: import("./material-revision").MaterialDefinitionRevision;
+            revisionId: string;
+            validFrom: Date;
+            validTo: Date | null;
+        }[];
+        revisions: {
+            state: string;
+            revisionNumber: number;
+            policy: import("..").MasterChangePolicy;
+            policyId: string;
+            id: string;
+            domain: import("@things-factory/shell").Domain;
+            domainId: string;
+            material: MaterialDefinition;
+            materialId: string;
+            baseRevision: import("./material-revision").MaterialDefinitionRevision | null;
+            baseRevisionId: string | null;
+            baseGeneration: number;
+            editGeneration: number;
+            description: string | null;
+            materialClassIds: string[];
+            properties: Record<string, unknown>[];
+            testSpecificationIds: string[];
+            effectiveFrom: Date;
+            reason: string;
+            creator: import("@things-factory/auth-base").User;
+            creatorId: string;
+            createdAt: Date;
+            frozenAt: Date | null;
+            contentHash: string | null;
+            activityInstanceId: string | null;
+        }[];
+    }>;
+    createMaterialDefinitionDraft(content: MaterialDefinitionDraftContent, materialId: string, name: string, baseRevisionId: string, context: ResolverContext): Promise<import("./material-revision").MaterialDefinitionRevision>;
+    editMaterialDefinitionDraft(revisionId: string, editGeneration: number, content: MaterialDefinitionDraftContent, context: ResolverContext): Promise<import("./material-revision").MaterialDefinitionRevision>;
+}

package/dist-server/service/material/material-revision-resolver.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaterialDefinitionRevisionResolver = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const material_definition_1 = require("./material-definition");
+const material_revision_service_1 = require("./material-revision-service");
+let MaterialDefinitionRevisionResolver = class MaterialDefinitionRevisionResolver {
+    async publishMaterialDefinitionDraft(revisionId, editGeneration, context) {
+        const { tx, domain, user } = context.state;
+        return (0, material_revision_service_1.publishUnregulatedMaterialDefinition)(tx, domain.id, user.id, revisionId, editGeneration);
+    }
+    async materialDefinitionRevisions(materialId, context) {
+        return (0, material_revision_service_1.materialDefinitionRevisionOverview)((0, shell_1.getRepository)(material_definition_1.MaterialDefinition).manager, context.state.domain.id, materialId);
+    }
+    async createMaterialDefinitionDraft(content, materialId, name, baseRevisionId, context) {
+        const { tx, domain, user } = context.state;
+        return (0, material_revision_service_1.createMaterialDefinitionDraft)(tx, domain.id, user.id, { materialId, name, baseRevisionId, content });
+    }
+    async editMaterialDefinitionDraft(revisionId, editGeneration, content, context) {
+        const { tx, domain, user } = context.state;
+        return (0, material_revision_service_1.editMaterialDefinitionDraft)(tx, domain.id, user.id, revisionId, editGeneration, content);
+    }
+};
+exports.MaterialDefinitionRevisionResolver = MaterialDefinitionRevisionResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('revisionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('editGeneration', () => type_graphql_1.Int)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Number, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MaterialDefinitionRevisionResolver.prototype, "publishMaterialDefinitionDraft", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('materialId')),
+    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)
+], MaterialDefinitionRevisionResolver.prototype, "materialDefinitionRevisions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('content', () => shell_1.ScalarObject)),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('materialId', () => String, { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('name', () => String, { nullable: true })),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('baseRevisionId', () => String, { nullable: true })),
+    tslib_1.__param(4, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MaterialDefinitionRevisionResolver.prototype, "createMaterialDefinitionDraft", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "ops-master", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(() => shell_1.ScalarObject),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('revisionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('editGeneration', () => type_graphql_1.Int)),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('content', () => shell_1.ScalarObject)),
+    tslib_1.__param(3, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Number, Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], MaterialDefinitionRevisionResolver.prototype, "editMaterialDefinitionDraft", null);
+exports.MaterialDefinitionRevisionResolver = MaterialDefinitionRevisionResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], MaterialDefinitionRevisionResolver);
+//# sourceMappingURL=material-revision-resolver.js.map

package/dist-server/service/material/material-revision-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-revision-resolver.js","sourceRoot":"","sources":["../../../server/service/material/material-revision-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Directive, Int, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { getRepository, ScalarObject, SpeakRefusals } from '@things-factory/shell'\nimport { MaterialDefinition } from './material-definition'\nimport { createMaterialDefinitionDraft, editMaterialDefinitionDraft, publishUnregulatedMaterialDefinition, materialDefinitionRevisionOverview, MaterialDefinitionDraftContent } from './material-revision-service'\n\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class MaterialDefinitionRevisionResolver {\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject)\n  async publishMaterialDefinitionDraft(@Arg('revisionId') revisionId: string, @Arg('editGeneration', () => Int) editGeneration: number, @Ctx() context: ResolverContext) {\n    const { tx, domain, user } = context.state\n    return publishUnregulatedMaterialDefinition(tx, domain.id, user.id, revisionId, editGeneration)\n  }\n  @Directive('@privilege(category: \"ops-master\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(() => ScalarObject)\n  async materialDefinitionRevisions(@Arg('materialId') materialId: string, @Ctx() context: ResolverContext) {\n    return materialDefinitionRevisionOverview(getRepository(MaterialDefinition).manager, context.state.domain.id, materialId)\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject)\n  async createMaterialDefinitionDraft(\n    @Arg('content', () => ScalarObject) content: MaterialDefinitionDraftContent,\n    @Arg('materialId', () => String, { nullable: true }) materialId: string,\n    @Arg('name', () => String, { nullable: true }) name: string,\n    @Arg('baseRevisionId', () => String, { nullable: true }) baseRevisionId: string,\n    @Ctx() context: ResolverContext\n  ) {\n    const { tx, domain, user } = context.state\n    return createMaterialDefinitionDraft(tx, domain.id, user.id, { materialId, name, baseRevisionId, content })\n  }\n\n  @Directive('@privilege(category: \"ops-master\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(() => ScalarObject)\n  async editMaterialDefinitionDraft(\n    @Arg('revisionId') revisionId: string,\n    @Arg('editGeneration', () => Int) editGeneration: number,\n    @Arg('content', () => ScalarObject) content: MaterialDefinitionDraftContent,\n    @Ctx() context: ResolverContext\n  ) {\n    const { tx, domain, user } = context.state\n    return editMaterialDefinitionDraft(tx, domain.id, user.id, revisionId, editGeneration, content)\n  }\n}\n"]}

package/dist-server/service/material/material-revision-service.d.ts

@@ -0,0 +1,144 @@
+import { EntityManager } from 'typeorm';
+import { Refusal } from '@things-factory/shell';
+import { MaterialDefinition } from './material-definition';
+import { MaterialDefinitionBasis, MaterialDefinitionPlan, MaterialDefinitionRevision, MaterialDefinitionSegment } from './material-revision';
+export declare class MaterialDefinitionRefusal extends Refusal {
+    constructor(code: string, detail?: string);
+}
+export declare function materialDefinitionSubmissionHash(revision: MaterialDefinitionRevision): string;
+/** Display values are a checked projection of the frozen revision, never a second editable source. */
+export declare function materialDefinitionApprovalInput(manager: EntityManager, domainId: string, revisionId: string): Promise<{
+    headline: string;
+    reason: string;
+    effectiveFrom: string;
+    before: {
+        revisionNumber: number;
+        detail: {
+            validFrom?: string;
+            validTo?: string;
+            revisionId: string;
+            createdAt: string;
+            frozenAt: string;
+            effectiveFrom: string;
+            reason: string;
+        };
+        description: string;
+        materialClassIds: string[];
+        properties: Record<string, unknown>[];
+        testSpecificationIds: string[];
+    };
+    after: {
+        revisionNumber: number;
+        detail: {
+            validFrom?: string;
+            validTo?: string;
+            revisionId: string;
+            createdAt: string;
+            frozenAt: string;
+            effectiveFrom: string;
+            reason: string;
+        };
+        description: string;
+        materialClassIds: string[];
+        properties: Record<string, unknown>[];
+        testSpecificationIds: string[];
+    };
+    revision: {
+        revisionId: string;
+        hash: string;
+        materialId: string;
+        baseGeneration: number;
+    };
+}>;
+export declare function assertMaterialDefinitionApprovalInput(manager: EntityManager, domainId: string, input: Record<string, unknown>): Promise<void>;
+export interface MaterialDefinitionDraftContent {
+    description?: string;
+    materialClassIds?: string[];
+    properties?: Record<string, unknown>[];
+    testSpecificationIds?: string[];
+    effectiveFrom: Date | string;
+    reason: string;
+}
+export declare function createMaterialDefinitionDraft(manager: EntityManager, domainId: string, creatorId: string, asked: {
+    materialId?: string;
+    name?: string;
+    baseRevisionId?: string;
+    content: MaterialDefinitionDraftContent;
+}): Promise<MaterialDefinitionRevision>;
+export declare function editMaterialDefinitionDraft(manager: EntityManager, domainId: string, actorId: string, revisionId: string, expectedEditGeneration: number, input: MaterialDefinitionDraftContent): Promise<MaterialDefinitionRevision>;
+/** Product calls this in the same transaction as issuing its worklist approval. */
+export declare function freezeMaterialDefinitionDraft(manager: EntityManager, domainId: string, actorId: string, revisionId: string, expectedEditGeneration: number): Promise<MaterialDefinitionRevision>;
+export declare function bindMaterialDefinitionApproval(manager: EntityManager, domainId: string, revisionId: string, activityInstanceId: string): Promise<void>;
+/** Internal completion callback only. Never expose this as an approved=true mutation. */
+export declare function publishMaterialDefinitionRevision(manager: EntityManager, domainId: string, revisionId: string, decision: {
+    activityInstanceId: string;
+    approverId: string;
+    submissionHash: string;
+}): Promise<MaterialDefinitionPlan>;
+export declare function publishUnregulatedMaterialDefinition(manager: EntityManager, domainId: string, actorId: string, revisionId: string, editGeneration: number): Promise<MaterialDefinitionPlan>;
+export declare function resolveMaterialDefinition(manager: EntityManager, domainId: string, materialId: string, businessTime: Date | string, knownAt?: Date | string): Promise<{
+    revision: MaterialDefinitionRevision;
+    plan: MaterialDefinitionPlan;
+    segment: MaterialDefinitionSegment;
+}>;
+/** Replay reads verify the captured digest too, not only the currently effective schedule. */
+export declare function materialDefinitionRevisionForBasis(manager: EntityManager, domainId: string, basis: MaterialDefinitionBasis): Promise<MaterialDefinitionRevision>;
+/** Must run inside the transaction that writes the business record. */
+export declare function captureMaterialDefinitionBasis(manager: EntityManager, domainId: string, materialId: string, recordKey: string, businessTime: Date | string): Promise<MaterialDefinitionBasis>;
+export declare function materialDefinitionRevisionOverview(manager: EntityManager, domainId: string, materialId: string, at?: Date): Promise<{
+    materialId: string;
+    name: string;
+    generation: number;
+    at: string;
+    schedule: {
+        state: string;
+        id: string;
+        domain: import("@things-factory/shell").Domain;
+        domainId: string;
+        material: MaterialDefinition;
+        materialId: string;
+        plan: MaterialDefinitionPlan;
+        planId: string;
+        revision: MaterialDefinitionRevision;
+        revisionId: string;
+        validFrom: Date;
+        validTo: Date | null;
+    }[];
+    revisions: {
+        state: string;
+        revisionNumber: number;
+        policy: import("../master-change-policy").MasterChangePolicy;
+        policyId: string;
+        id: string;
+        domain: import("@things-factory/shell").Domain;
+        domainId: string;
+        material: MaterialDefinition;
+        materialId: string;
+        baseRevision: MaterialDefinitionRevision | null;
+        baseRevisionId: string | null;
+        baseGeneration: number;
+        editGeneration: number;
+        description: string | null;
+        materialClassIds: string[];
+        properties: Record<string, unknown>[];
+        testSpecificationIds: string[];
+        effectiveFrom: Date;
+        reason: string;
+        creator: import("@things-factory/auth-base").User;
+        creatorId: string;
+        createdAt: Date;
+        frozenAt: Date | null;
+        contentHash: string | null;
+        activityInstanceId: string | null;
+    }[];
+}>;
+/** Read-time projection, never a clock-driven rewrite of the identity row. */
+export declare function effectiveMaterialDefinition(manager: EntityManager, domainId: string, material: MaterialDefinition, at?: Date): Promise<MaterialDefinition & {
+    revisionNumber: number;
+    description: string;
+    materialClassIds: string[];
+    properties: Record<string, unknown>[];
+    testSpecificationIds: string[];
+    effectiveStart: Date;
+    effectiveEnd: Date;
+}>;