@things-factory/figure-library 10.1.121

package/dist-server/routes.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const env_1 = require("@things-factory/env");
+const shell_1 = require("@things-factory/shell");
+const figure_library_file_router_1 = require("./routers/figure-library-file-router");
+/* With subdomains the domain is in the host name; otherwise in the path, as figure-service and board-service do. */
+const isPathBaseDomain = !env_1.config.get('subdomain');
+process.on('bootstrap-module-domain-private-route', (app, domainPrivateRouter) => {
+    if (isPathBaseDomain) {
+        domainPrivateRouter.use(`/${(0, shell_1.getRoutePrefixForDomainType)()}/:domain`, figure_library_file_router_1.figureLibraryFileRouter.routes(), figure_library_file_router_1.figureLibraryFileRouter.allowedMethods());
+    }
+    else {
+        domainPrivateRouter.use('', figure_library_file_router_1.figureLibraryFileRouter.routes(), figure_library_file_router_1.figureLibraryFileRouter.allowedMethods());
+    }
+});
+//# sourceMappingURL=routes.js.map

package/dist-server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../server/routes.ts"],"names":[],"mappings":";;AAAA,6CAA4C;AAC5C,iDAAmE;AAEnE,qFAA8E;AAE9E,oHAAoH;AACpH,MAAM,gBAAgB,GAAG,CAAC,YAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AAEjD,OAAO,CAAC,EAAE,CAAC,uCAA8C,EAAE,CAAC,GAAG,EAAE,mBAAmB,EAAE,EAAE;IACtF,IAAI,gBAAgB,EAAE,CAAC;QACrB,mBAAmB,CAAC,GAAG,CAAC,IAAI,IAAA,mCAA2B,GAAE,UAAU,EAAE,oDAAuB,CAAC,MAAM,EAAE,EAAE,oDAAuB,CAAC,cAAc,EAAE,CAAC,CAAA;IAClJ,CAAC;SAAM,CAAC;QACN,mBAAmB,CAAC,GAAG,CAAC,EAAE,EAAE,oDAAuB,CAAC,MAAM,EAAE,EAAE,oDAAuB,CAAC,cAAc,EAAE,CAAC,CAAA;IACzG,CAAC;AACH,CAAC,CAAC,CAAA","sourcesContent":["import { config } from '@things-factory/env'\nimport { getRoutePrefixForDomainType } from '@things-factory/shell'\n\nimport { figureLibraryFileRouter } from './routers/figure-library-file-router'\n\n/* With subdomains the domain is in the host name; otherwise in the path, as figure-service and board-service do. */\nconst isPathBaseDomain = !config.get('subdomain')\n\nprocess.on('bootstrap-module-domain-private-route' as any, (app, domainPrivateRouter) => {\n  if (isPathBaseDomain) {\n    domainPrivateRouter.use(`/${getRoutePrefixForDomainType()}/:domain`, figureLibraryFileRouter.routes(), figureLibraryFileRouter.allowedMethods())\n  } else {\n    domainPrivateRouter.use('', figureLibraryFileRouter.routes(), figureLibraryFileRouter.allowedMethods())\n  }\n})\n"]}

package/dist-server/service/figure-library-release/figure-library-release.d.ts

@@ -0,0 +1,54 @@
+import { User } from '@things-factory/auth-base';
+import { Domain } from '@things-factory/shell';
+/** A file a release depends on, as its package listed it. */
+export interface FigureLibraryDependency {
+    hash: string;
+    role: string;
+    size: number;
+    contentType: string;
+}
+/**
+ * A released figure this board server imported (ADR-0114 결정 3).
+ *
+ * The release data is immutable: the server that authored it never changes a release, so a row is added once and never
+ * rewritten from a package. `formatSupported` · `checkedKernel` · `width` · `depth` are derived, recomputed when this
+ * server's kernel is another version than the one that checked them. There is no delete path.
+ */
+export declare class FigureLibraryRelease {
+    readonly id?: string;
+    domain?: Domain;
+    domainId?: string;
+    name: string;
+    description?: string;
+    ref: string;
+    namespace: string;
+    type: string;
+    version: number;
+    names?: Record<string, string>;
+    category?: string;
+    source: string;
+    contentHash: string;
+    assetFormat: string;
+    kernelVersion?: string;
+    metrics?: string;
+    topView?: string;
+    changes?: string;
+    formatSupported: boolean;
+    checkedKernel?: string;
+    width?: number;
+    depth?: number;
+    dependencies?: FigureLibraryDependency[];
+    deprecated: boolean;
+    supersededBy?: string;
+    sourceUrl?: string;
+    sourceDomain?: string;
+    packageName?: string;
+    releasedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

package/dist-server/service/figure-library-release/figure-library-release.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigureLibraryRelease = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+/**
+ * A released figure this board server imported (ADR-0114 결정 3).
+ *
+ * The release data is immutable: the server that authored it never changes a release, so a row is added once and never
+ * rewritten from a package. `formatSupported` · `checkedKernel` · `width` · `depth` are derived, recomputed when this
+ * server's kernel is another version than the one that checked them. There is no delete path.
+ */
+let FigureLibraryRelease = class FigureLibraryRelease {
+};
+exports.FigureLibraryRelease = FigureLibraryRelease;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'The domain that imported the release.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], FigureLibraryRelease.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((release) => release.domain),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Display name of the figure at this release.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Description of the figure at this release.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Release reference {namespace}/{type}@{version}.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "ref", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Namespace of the full name.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "namespace", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Type of the full name.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Release version.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureLibraryRelease.prototype, "version", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('simple-json', { nullable: true, default: null }),
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Display names by language.' }),
+    tslib_1.__metadata("design:type", Object)
+], FigureLibraryRelease.prototype, "names", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Category of the figure at this release.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "category", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ ...(0, shell_1.longTextColumn)() }),
+    (0, type_graphql_1.Field)({ description: 'The released source, as the authoring server released it.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "source", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ length: 64 }),
+    (0, type_graphql_1.Field)({ description: 'SHA-256 of the source. Same reference and hash is the same release.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "contentHash", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'The format the source declares (figure-asset-1).' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "assetFormat", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Kernel version that released it on the authoring server.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "kernelVersion", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, ...(0, shell_1.longTextColumn)() }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What the release measured, as JSON text.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "metrics", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, ...(0, shell_1.longTextColumn)() }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Top view of the release, as JSON text.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "topView", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, ...(0, shell_1.longTextColumn)() }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Contract changes against its previous release, as JSON text.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "changes", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Derived: whether this server kernel reads the source.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], FigureLibraryRelease.prototype, "formatSupported", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Derived: kernel version that checked the source here.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "checkedKernel", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Derived: authored width (size.x) in mm. Null when unread.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureLibraryRelease.prototype, "width", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Derived: authored depth (size.z) in mm. Null when unread.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureLibraryRelease.prototype, "depth", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)('simple-json', { nullable: true, default: null }),
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Files the release depends on: [{ hash, role, size, contentType }].' }),
+    tslib_1.__metadata("design:type", Array)
+], FigureLibraryRelease.prototype, "dependencies", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Retired at the authoring server.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], FigureLibraryRelease.prototype, "deprecated", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Full name to use instead of a retired figure.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "supersededBy", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Address of the figure server the package came from.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "sourceUrl", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Domain of the figure server the package came from.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "sourceDomain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'File name of the package it was imported from.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "packageName", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When the authoring server released it.' }),
+    tslib_1.__metadata("design:type", Date)
+], FigureLibraryRelease.prototype, "releasedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Creation timestamp (when it was imported).' }),
+    tslib_1.__metadata("design:type", Date)
+], FigureLibraryRelease.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last update timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], FigureLibraryRelease.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Soft-delete timestamp. Releases are not deleted.' }),
+    tslib_1.__metadata("design:type", Date)
+], FigureLibraryRelease.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'The user who imported it.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], FigureLibraryRelease.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((release) => release.creator),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'The user who last updated it.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], FigureLibraryRelease.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((release) => release.updater),
+    tslib_1.__metadata("design:type", String)
+], FigureLibraryRelease.prototype, "updaterId", void 0);
+exports.FigureLibraryRelease = FigureLibraryRelease = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_figure_library_release_1', (release) => [release.domain, release.ref], {
+        unique: true,
+        where: '"deleted_at" IS NULL'
+    }),
+    (0, typeorm_1.Index)('ix_figure_library_release_2', (release) => [release.domain, release.namespace, release.type]),
+    (0, type_graphql_1.ObjectType)({ description: 'A released figure imported into this board server, one row per release reference.' })
+], FigureLibraryRelease);
+//# sourceMappingURL=figure-library-release.js.map

package/dist-server/service/figure-library-release/figure-library-release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-library-release.js","sourceRoot":"","sources":["../../../server/service/figure-library-release/figure-library-release.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, Float, ID, Int, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain, longTextColumn } from '@things-factory/shell'\n\n/** A file a release depends on, as its package listed it. */\nexport interface FigureLibraryDependency {\n  hash: string\n  role: string\n  size: number\n  contentType: string\n}\n\n/**\n * A released figure this board server imported (ADR-0114 결정 3).\n *\n * The release data is immutable: the server that authored it never changes a release, so a row is added once and never\n * rewritten from a package. `formatSupported` · `checkedKernel` · `width` · `depth` are derived, recomputed when this\n * server's kernel is another version than the one that checked them. There is no delete path.\n */\n@Entity()\n@Index('ix_figure_library_release_1', (release: FigureLibraryRelease) => [release.domain, release.ref], {\n  unique: true,\n  where: '\"deleted_at\" IS NULL'\n})\n@Index('ix_figure_library_release_2', (release: FigureLibraryRelease) => [release.domain, release.namespace, release.type])\n@ObjectType({ description: 'A released figure imported into this board server, one row per release reference.' })\nexport class FigureLibraryRelease {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier.' })\n  readonly id?: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain that imported the release.' })\n  domain?: Domain\n\n  @RelationId((release: FigureLibraryRelease) => release.domain)\n  domainId?: string\n\n  @Column()\n  @Field({ description: 'Display name of the figure at this release.' })\n  name: string\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Description of the figure at this release.' })\n  description?: string\n\n  @Column()\n  @Field({ description: 'Release reference {namespace}/{type}@{version}.' })\n  ref: string\n\n  @Column()\n  @Field({ description: 'Namespace of the full name.' })\n  namespace: string\n\n  @Column()\n  @Field({ description: 'Type of the full name.' })\n  type: string\n\n  @Column()\n  @Field(type => Int, { description: 'Release version.' })\n  version: number\n\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Display names by language.' })\n  names?: Record<string, string>\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Category of the figure at this release.' })\n  category?: string\n\n  @Column({ ...longTextColumn() })\n  @Field({ description: 'The released source, as the authoring server released it.' })\n  source: string\n\n  @Column({ length: 64 })\n  @Field({ description: 'SHA-256 of the source. Same reference and hash is the same release.' })\n  contentHash: string\n\n  @Column()\n  @Field({ description: 'The format the source declares (figure-asset-1).' })\n  assetFormat: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Kernel version that released it on the authoring server.' })\n  kernelVersion?: string\n\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'What the release measured, as JSON text.' })\n  metrics?: string\n\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'Top view of the release, as JSON text.' })\n  topView?: string\n\n  @Column({ nullable: true, ...longTextColumn() })\n  @Field({ nullable: true, description: 'Contract changes against its previous release, as JSON text.' })\n  changes?: string\n\n  @Column({ default: false })\n  @Field({ description: 'Derived: whether this server kernel reads the source.' })\n  formatSupported: boolean\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Derived: kernel version that checked the source here.' })\n  checkedKernel?: string\n\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'Derived: authored width (size.x) in mm. Null when unread.' })\n  width?: number\n\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'Derived: authored depth (size.z) in mm. Null when unread.' })\n  depth?: number\n\n  @Column('simple-json', { nullable: true, default: null })\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Files the release depends on: [{ hash, role, size, contentType }].' })\n  dependencies?: FigureLibraryDependency[]\n\n  @Column({ default: false })\n  @Field({ description: 'Retired at the authoring server.' })\n  deprecated: boolean\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Full name to use instead of a retired figure.' })\n  supersededBy?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Address of the figure server the package came from.' })\n  sourceUrl?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Domain of the figure server the package came from.' })\n  sourceDomain?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'File name of the package it was imported from.' })\n  packageName?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'When the authoring server released it.' })\n  releasedAt?: Date\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp (when it was imported).' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp.' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft-delete timestamp. Releases are not deleted.' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who imported it.' })\n  creator?: User\n\n  @RelationId((release: FigureLibraryRelease) => release.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'The user who last updated it.' })\n  updater?: User\n\n  @RelationId((release: FigureLibraryRelease) => release.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/figure-library-resolver.d.ts

@@ -0,0 +1,20 @@
+import type { FileUpload } from 'graphql-upload/GraphQLUpload.js';
+import { ListParam } from '@things-factory/shell';
+import { FigureTypeMap, FigureTypeMapState } from './figure-type-map/figure-type-map';
+import { FigureTypeMapEntry } from './figure-type-map/figure-type-map-entry';
+import { FigureImportResult, FigureLibraryReleaseList, FigureTypeMapLineInput } from './figure-library-types';
+/**
+ * The library and the type map of a board server (ADR-0114). Reading is `figure-library` query; changing is its
+ * mutation. Boards ask `figureBlueprints` under `figure-published`, the door every figure consumer asks through.
+ */
+export declare class FigureLibraryResolver {
+    figureLibraryReleases(params: ListParam, context: ResolverContext): Promise<FigureLibraryReleaseList>;
+    figureTypeMaps(context: ResolverContext): Promise<FigureTypeMap[]>;
+    figureTypeMapEntries(version: number, context: ResolverContext): Promise<FigureTypeMapEntry[]>;
+    figureTypeMapCheck(context: ResolverContext): Promise<any>;
+    figureBoardRequirements(boardId: string, context: ResolverContext): Promise<any>;
+    figureBlueprints(types: string[], context: ResolverContext, map?: FigureTypeMapState): Promise<any>;
+    importFigurePackage(file: FileUpload, context: ResolverContext): Promise<FigureImportResult>;
+    saveFigureTypeMapCandidate(lines: FigureTypeMapLineInput[], context: ResolverContext, description?: string): Promise<FigureTypeMap>;
+    activateFigureTypeMap(version: number, context: ResolverContext): Promise<FigureTypeMap>;
+}

package/dist-server/service/figure-library-resolver.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigureLibraryResolver = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const GraphQLUpload_js_1 = tslib_1.__importDefault(require("graphql-upload/GraphQLUpload.js"));
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const figure_library_release_1 = require("./figure-library-release/figure-library-release");
+const figure_type_map_1 = require("./figure-type-map/figure-type-map");
+const figure_type_map_entry_1 = require("./figure-type-map/figure-type-map-entry");
+const figure_library_types_1 = require("./figure-library-types");
+const blueprints_1 = require("./library/blueprints");
+const import_1 = require("./library/import");
+const inspection_1 = require("./library/inspection");
+const type_map_1 = require("./library/type-map");
+/**
+ * A refusal in the asker's language as plain text: a board draws it on a canvas, not into HTML, so the values in it
+ * (a name with `/`) are not escaped.
+ */
+function plainTextOf(refusal, context) {
+    return context.t
+        ? context.t((0, shell_1.refusalKey)(refusal.code), { ...refusal.params, defaultValue: refusal.message, interpolation: { escapeValue: false } })
+        : refusal.message;
+}
+/** The most bytes one package upload may carry. */
+const PACKAGE_MAX_BYTES = 64 * 1024 * 1024;
+async function bytesOf(file) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of file.createReadStream()) {
+        size += chunk.length;
+        if (size > PACKAGE_MAX_BYTES)
+            throw new shell_1.Refusal('figure-package-too-large', { max: PACKAGE_MAX_BYTES }, 'a figure package is at most {max} bytes.');
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * The library and the type map of a board server (ADR-0114). Reading is `figure-library` query; changing is its
+ * mutation. Boards ask `figureBlueprints` under `figure-published`, the door every figure consumer asks through.
+ */
+let FigureLibraryResolver = class FigureLibraryResolver {
+    async figureLibraryReleases(params, context) {
+        const { domain, tx } = context.state;
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            repository: (0, shell_1.getRepository)(figure_library_release_1.FigureLibraryRelease, tx),
+            params,
+            domain,
+            alias: 'release',
+            searchables: ['ref', 'name', 'description', 'category']
+        });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        const manager = tx ?? (0, shell_1.getRepository)(figure_library_release_1.FigureLibraryRelease).manager;
+        for (const item of items)
+            await (0, inspection_1.freshen)(manager, item);
+        return { items, total };
+    }
+    async figureTypeMaps(context) {
+        const { domain } = context.state;
+        return await (0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).find({ where: { domain: { id: domain.id } }, order: { version: 'DESC' } });
+    }
+    async figureTypeMapEntries(version, context) {
+        const { domain } = context.state;
+        const map = await (0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).findOne({ where: { domain: { id: domain.id }, version } });
+        return map ? await (0, type_map_1.entriesOf)((0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).manager, map) : [];
+    }
+    async figureTypeMapCheck(context) {
+        const { domain } = context.state;
+        return await (0, inspection_1.typeMapCheck)((0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).manager, domain);
+    }
+    async figureBoardRequirements(boardId, context) {
+        const { domain } = context.state;
+        return await (0, inspection_1.boardRequirements)((0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).manager, domain, boardId);
+    }
+    async figureBlueprints(types, context, map) {
+        const { domain, user, unsafeIP, prohibitedPrivileges } = context.state;
+        const state = map === figure_type_map_1.FigureTypeMapState.CANDIDATE ? figure_type_map_1.FigureTypeMapState.CANDIDATE : figure_type_map_1.FigureTypeMapState.ACTIVE;
+        if (state === figure_type_map_1.FigureTypeMapState.CANDIDATE) {
+            const allowed = await (0, auth_base_1.checkPermission)({ category: 'figure-library', privilege: 'mutation', owner: true }, user, domain, unsafeIP, prohibitedPrivileges);
+            if (!allowed)
+                throw new shell_1.Refusal('figure-type-map-preview-denied', {}, 'previewing the candidate type map needs the right to change it.');
+        }
+        return await (0, blueprints_1.blueprintsOf)((0, shell_1.getRepository)(figure_type_map_1.FigureTypeMap).manager, domain, types, state, refusal => plainTextOf(refusal, context));
+    }
+    async importFigurePackage(file, context) {
+        const { domain, user, tx } = context.state;
+        const upload = await file;
+        (0, import_1.assertPackageName)(upload.filename);
+        return await (0, import_1.importFigurePackage)(tx, domain, user, await bytesOf(upload), upload.filename);
+    }
+    async saveFigureTypeMapCandidate(lines, context, description) {
+        const { domain, user, tx } = context.state;
+        return await (0, type_map_1.saveCandidate)(tx, domain, user, lines, description);
+    }
+    async activateFigureTypeMap(version, context) {
+        const { domain, user, tx } = context.state;
+        return await (0, type_map_1.activate)(tx, domain, user, version);
+    }
+};
+exports.FigureLibraryResolver = FigureLibraryResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => figure_library_types_1.FigureLibraryReleaseList, { description: 'Lists the releases imported into this domain.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)()),
+    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)
+], FigureLibraryResolver.prototype, "figureLibraryReleases", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => [figure_type_map_1.FigureTypeMap], { description: 'The type map releases of this domain, newest first.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "figureTypeMaps", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => [figure_type_map_entry_1.FigureTypeMapEntry], { description: 'The lines of one type map release, with the release each draws with.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('version', type => type_graphql_1.Int)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Number, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "figureTypeMapEntries", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'The check before activation: the candidate against the active map and every board of the domain. Null without a candidate.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "figureTypeMapCheck", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'What one board needs from the active type map: each figure, its status and node count.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('boardId')),
+    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)
+], FigureLibraryResolver.prototype, "figureBoardRequirements", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-published", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => graphql_scalars_1.GraphQLJSON, {
+        description: 'Figures a board asks for together by full name {namespace}/{type}, answered from one type map release: { release: { version, revision }, items: [{ type, ref, asset }], refused: [{ type, code, message }] }.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('types', type => [String], { description: 'Full figure names {namespace}/{type}. At most 500.' })),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('map', type => figure_type_map_1.FigureTypeMapState, { nullable: true, description: 'ACTIVE (default) or CANDIDATE for a preview.' })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "figureBlueprints", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => figure_library_types_1.FigureImportResult, { description: 'Imports a figure package into this domain library and its candidate type map.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('file', () => GraphQLUpload_js_1.default)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "importFigurePackage", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => figure_type_map_1.FigureTypeMap, { description: 'Replaces the lines of the candidate type map. Each save raises its revision.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('lines', type => [figure_library_types_1.FigureTypeMapLineInput])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('description', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "saveFigureTypeMapCandidate", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "figure-library", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Mutation)(returns => figure_type_map_1.FigureTypeMap, { description: 'Activates a type map release: the candidate, or an archived one to roll back.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('version', type => type_graphql_1.Int)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Number, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureLibraryResolver.prototype, "activateFigureTypeMap", null);
+exports.FigureLibraryResolver = FigureLibraryResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], FigureLibraryResolver);
+//# sourceMappingURL=figure-library-resolver.js.map

package/dist-server/service/figure-library-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-library-resolver.js","sourceRoot":"","sources":["../../server/service/figure-library-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Args, Ctx, Directive, Int, Mutation, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\n\nimport { checkPermission } from '@things-factory/auth-base'\nimport { getQueryBuilderFromListParams, getRepository, ListParam, Refusal, refusalKey, SpeakRefusals } from '@things-factory/shell'\n\nimport { FigureLibraryRelease } from './figure-library-release/figure-library-release'\nimport { FigureTypeMap, FigureTypeMapState } from './figure-type-map/figure-type-map'\nimport { FigureTypeMapEntry } from './figure-type-map/figure-type-map-entry'\nimport { FigureImportResult, FigureLibraryReleaseList, FigureTypeMapLineInput } from './figure-library-types'\nimport { blueprintsOf } from './library/blueprints'\nimport { assertPackageName, importFigurePackage } from './library/import'\nimport { boardRequirements, freshen, typeMapCheck } from './library/inspection'\nimport { activate, entriesOf, saveCandidate } from './library/type-map'\n\n/**\n * A refusal in the asker's language as plain text: a board draws it on a canvas, not into HTML, so the values in it\n * (a name with `/`) are not escaped.\n */\nfunction plainTextOf(refusal: Refusal, context: any): string {\n  return context.t\n    ? context.t(refusalKey(refusal.code), { ...refusal.params, defaultValue: refusal.message, interpolation: { escapeValue: false } })\n    : refusal.message\n}\n\n/** The most bytes one package upload may carry. */\nconst PACKAGE_MAX_BYTES = 64 * 1024 * 1024\n\nasync function bytesOf(file: FileUpload): Promise<Buffer> {\n  const chunks: Buffer[] = []\n  let size = 0\n  for await (const chunk of file.createReadStream()) {\n    size += chunk.length\n    if (size > PACKAGE_MAX_BYTES) throw new Refusal('figure-package-too-large', { max: PACKAGE_MAX_BYTES }, 'a figure package is at most {max} bytes.')\n    chunks.push(Buffer.from(chunk))\n  }\n  return Buffer.concat(chunks)\n}\n\n/**\n * The library and the type map of a board server (ADR-0114). Reading is `figure-library` query; changing is its\n * mutation. Boards ask `figureBlueprints` under `figure-published`, the door every figure consumer asks through.\n */\n@Resolver()\n@UseMiddleware(SpeakRefusals)\nexport class FigureLibraryResolver {\n  @Directive('@privilege(category: \"figure-library\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureLibraryReleaseList, { description: 'Lists the releases imported into this domain.' })\n  async figureLibraryReleases(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureLibraryReleaseList> {\n    const { domain, tx } = context.state\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(FigureLibraryRelease, tx),\n      params,\n      domain,\n      alias: 'release',\n      searchables: ['ref', 'name', 'description', 'category']\n    })\n    const [items, total] = await queryBuilder.getManyAndCount()\n    const manager = tx ?? getRepository(FigureLibraryRelease).manager\n    for (const item of items) await freshen(manager, item)\n    return { items, total }\n  }\n\n  @Directive('@privilege(category: \"figure-library\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureTypeMap], { description: 'The type map releases of this domain, newest first.' })\n  async figureTypeMaps(@Ctx() context: ResolverContext): Promise<FigureTypeMap[]> {\n    const { domain } = context.state\n    return await getRepository(FigureTypeMap).find({ where: { domain: { id: domain.id } }, order: { version: 'DESC' } })\n  }\n\n  @Directive('@privilege(category: \"figure-library\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureTypeMapEntry], { description: 'The lines of one type map release, with the release each draws with.' })\n  async figureTypeMapEntries(@Arg('version', type => Int) version: number, @Ctx() context: ResolverContext): Promise<FigureTypeMapEntry[]> {\n    const { domain } = context.state\n    const map = await getRepository(FigureTypeMap).findOne({ where: { domain: { id: domain.id }, version } })\n    return map ? await entriesOf(getRepository(FigureTypeMap).manager, map) : []\n  }\n\n  @Directive('@privilege(category: \"figure-library\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    nullable: true,\n    description: 'The check before activation: the candidate against the active map and every board of the domain. Null without a candidate.'\n  })\n  async figureTypeMapCheck(@Ctx() context: ResolverContext): Promise<any> {\n    const { domain } = context.state\n    return await typeMapCheck(getRepository(FigureTypeMap).manager, domain)\n  }\n\n  @Directive('@privilege(category: \"figure-library\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, { nullable: true, description: 'What one board needs from the active type map: each figure, its status and node count.' })\n  async figureBoardRequirements(@Arg('boardId') boardId: string, @Ctx() context: ResolverContext): Promise<any> {\n    const { domain } = context.state\n    return await boardRequirements(getRepository(FigureTypeMap).manager, domain, boardId)\n  }\n\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    description:\n      'Figures a board asks for together by full name {namespace}/{type}, answered from one type map release: { release: { version, revision }, items: [{ type, ref, asset }], refused: [{ type, code, message }] }.'\n  })\n  async figureBlueprints(\n    @Arg('types', type => [String], { description: 'Full figure names {namespace}/{type}. At most 500.' }) types: string[],\n    @Ctx() context: ResolverContext,\n    @Arg('map', type => FigureTypeMapState, { nullable: true, description: 'ACTIVE (default) or CANDIDATE for a preview.' })\n    map?: FigureTypeMapState\n  ): Promise<any> {\n    const { domain, user, unsafeIP, prohibitedPrivileges } = context.state\n    const state = map === FigureTypeMapState.CANDIDATE ? FigureTypeMapState.CANDIDATE : FigureTypeMapState.ACTIVE\n    if (state === FigureTypeMapState.CANDIDATE) {\n      const allowed = await checkPermission({ category: 'figure-library', privilege: 'mutation', owner: true }, user, domain, unsafeIP, prohibitedPrivileges)\n      if (!allowed) throw new Refusal('figure-type-map-preview-denied', {}, 'previewing the candidate type map needs the right to change it.')\n    }\n    return await blueprintsOf(getRepository(FigureTypeMap).manager, domain, types, state, refusal => plainTextOf(refusal, context))\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure-library\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureImportResult, { description: 'Imports a figure package into this domain library and its candidate type map.' })\n  async importFigurePackage(@Arg('file', () => GraphQLUpload) file: FileUpload, @Ctx() context: ResolverContext): Promise<FigureImportResult> {\n    const { domain, user, tx } = context.state\n    const upload = await file\n    assertPackageName(upload.filename)\n    return await importFigurePackage(tx, domain, user, await bytesOf(upload), upload.filename)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure-library\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureTypeMap, { description: 'Replaces the lines of the candidate type map. Each save raises its revision.' })\n  async saveFigureTypeMapCandidate(\n    @Arg('lines', type => [FigureTypeMapLineInput]) lines: FigureTypeMapLineInput[],\n    @Ctx() context: ResolverContext,\n    @Arg('description', { nullable: true }) description?: string\n  ): Promise<FigureTypeMap> {\n    const { domain, user, tx } = context.state\n    return await saveCandidate(tx, domain, user, lines, description)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure-library\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureTypeMap, { description: 'Activates a type map release: the candidate, or an archived one to roll back.' })\n  async activateFigureTypeMap(@Arg('version', type => Int) version: number, @Ctx() context: ResolverContext): Promise<FigureTypeMap> {\n    const { domain, user, tx } = context.state\n    return await activate(tx, domain, user, version)\n  }\n}\n"]}

package/dist-server/service/figure-library-types.d.ts

@@ -0,0 +1,23 @@
+import { FigureLibraryRelease } from './figure-library-release/figure-library-release';
+export declare class FigureLibraryReleaseList {
+    items: FigureLibraryRelease[];
+    total: number;
+}
+export declare class FigureTypeMapLineInput {
+    name: string;
+    releaseId: string;
+}
+export declare class FigureImportOutcome {
+    ref: string;
+    outcome: string;
+    code?: string;
+    differs?: string[];
+}
+export declare class FigureImportProblem {
+    code: string;
+    path?: string;
+}
+export declare class FigureImportResult {
+    problems: FigureImportProblem[];
+    outcomes: FigureImportOutcome[];
+}