@twin.org/auditable-item-graph-service 0.9.2 → 0.10.0

package/dist/es/entities/auditableItemGraphVertex.js

@@ -1,5 +1,3 @@
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 import { JsonLdTypes } from "@twin.org/data-json-ld";
 import { entity, property, SortDirection } from "@twin.org/entity";
 /**
@@ -22,6 +20,10 @@ let AuditableItemGraphVertex = class AuditableItemGraphVertex {
      * The date/time of when the vertex was last modified.
      */
     dateModified;
+    /**
+     * How the mutations of the vertex are recorded, when absent the vertex behaves as audited.
+     */
+    auditMode;
     /**
      * Combined alias index for the vertex used for querying.
      */
@@ -72,6 +74,10 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], AuditableItemGraphVertex.prototype, "dateModified", void 0);
+__decorate([
+    property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertex.prototype, "auditMode", void 0);
 __decorate([
     property({ type: "string", isSecondary: true, optional: true }),
     __metadata("design:type", String)
@@ -101,7 +107,7 @@ __decorate([
     __metadata("design:type", Number)
 ], AuditableItemGraphVertex.prototype, "version", void 0);
 AuditableItemGraphVertex = __decorate([
-    entity()
+    entity({ version: 1 })
 ], AuditableItemGraphVertex);
 export { AuditableItemGraphVertex };
 //# sourceMappingURL=auditableItemGraphVertex.js.map

package/dist/es/entities/auditableItemGraphVertex.js.map

@@ -1 +1 @@
-{"version":3,"file":"auditableItemGraphVertex.js","sourceRoot":"","sources":["../../../src/entities/auditableItemGraphVertex.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,WAAW,EAA0B,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKnE;;GAEG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACpC;;OAEG;IAEI,EAAE,CAAU;IAEnB;;OAEG;IAEI,oBAAoB,CAAU;IAErC;;OAEG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAOI,YAAY,CAAU;IAE7B;;OAEG;IAEI,UAAU,CAAU;IAE3B;;OAEG;IAEI,iBAAiB,CAAU;IAElC;;OAEG;IAEI,gBAAgB,CAAqB;IAE5C;;OAEG;IAEI,OAAO,CAA6B;IAE3C;;OAEG;IAEI,SAAS,CAAgC;IAEhD;;OAEG;IAEI,KAAK,CAA4B;IAExC;;OAEG;IAEI,OAAO,CAAU;CACxB,CAAA;AAlEO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;oDAC3B;AAMZ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;sEACQ;AAM9B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;6DAC/D;AAWrB;IANN,QAAQ,CAAC;QACT,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,aAAa,CAAC,UAAU;QACvC,QAAQ,EAAE,IAAI;KACd,CAAC;;8DAC2B;AAMtB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DACrC;AAMpB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mEAC9B;AAM3B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kEACtC;AAMrC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACrB;AAMpC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACvC;AAMzC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDAC3C;AAMjC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACtB;AAtEZ,wBAAwB;IADpC,MAAM,EAAE;GACI,wBAAwB,CAuEpC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { JsonLdTypes, type IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\nimport type { AuditableItemGraphAlias } from \"./auditableItemGraphAlias.js\";\nimport type { AuditableItemGraphEdge } from \"./auditableItemGraphEdge.js\";\nimport type { AuditableItemGraphResource } from \"./auditableItemGraphResource.js\";\n\n/**\n * Class describing the auditable item graph vertex.\n */\n@entity()\nexport class AuditableItemGraphVertex {\n\t/**\n\t * The id of the vertex.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic id!: string;\n\n\t/**\n\t * The identity of the organization which controls the vertex.\n\t */\n\t@property({ type: \"string\" })\n\tpublic organizationIdentity!: string;\n\n\t/**\n\t * The date/time of when the vertex was created.\n\t */\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * The date/time of when the vertex was last modified.\n\t */\n\t@property({\n\t\ttype: \"string\",\n\t\tformat: \"date-time\",\n\t\tsortDirection: SortDirection.Descending,\n\t\toptional: true\n\t})\n\tpublic dateModified?: string;\n\n\t/**\n\t * Combined alias index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic aliasIndex?: string;\n\n\t/**\n\t * Combined resource type index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic resourceTypeIndex?: string;\n\n\t/**\n\t * Object to associate with the vertex as JSON-LD.\n\t */\n\t@property({ type: \"object\", itemTypeRef: JsonLdTypes.NodeObject, optional: true })\n\tpublic annotationObject?: IJsonLdNodeObject;\n\n\t/**\n\t * Alternative aliases that can be used to identify the vertex.\n\t */\n\t@property({ type: \"array\", itemType: \"string\", optional: true })\n\tpublic aliases?: AuditableItemGraphAlias[];\n\n\t/**\n\t * The resources attached to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphResource\", optional: true })\n\tpublic resources?: AuditableItemGraphResource[];\n\n\t/**\n\t * Edges connected to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphEdge\", optional: true })\n\tpublic edges?: AuditableItemGraphEdge[];\n\n\t/**\n\t * The current version of the vertex, incremented on each changeset.\n\t */\n\t@property({ type: \"integer\", optional: true })\n\tpublic version?: number;\n}\n"]}
+{"version":3,"file":"auditableItemGraphVertex.js","sourceRoot":"","sources":["../../../src/entities/auditableItemGraphVertex.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAA0B,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKnE;;GAEG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACpC;;OAEG;IAEI,EAAE,CAAU;IAEnB;;OAEG;IAEI,oBAAoB,CAAU;IAErC;;OAEG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAOI,YAAY,CAAU;IAE7B;;OAEG;IAEI,SAAS,CAA+B;IAE/C;;OAEG;IAEI,UAAU,CAAU;IAE3B;;OAEG;IAEI,iBAAiB,CAAU;IAElC;;OAEG;IAEI,gBAAgB,CAAqB;IAE5C;;OAEG;IAEI,OAAO,CAA6B;IAE3C;;OAEG;IAEI,SAAS,CAAgC;IAEhD;;OAEG;IAEI,KAAK,CAA4B;IAExC;;OAEG;IAEI,OAAO,CAAU;CACxB,CAAA;AAxEO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;oDAC3B;AAMZ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;sEACQ;AAM9B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;6DAC/D;AAWrB;IANN,QAAQ,CAAC;QACT,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,aAAa,CAAC,UAAU;QACvC,QAAQ,EAAE,IAAI;KACd,CAAC;;8DAC2B;AAMtB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACE;AAMxC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DACrC;AAMpB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mEAC9B;AAM3B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kEACtC;AAMrC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACrB;AAMpC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACvC;AAMzC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uDAC3C;AAMjC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACtB;AA5EZ,wBAAwB;IADpC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;GACV,wBAAwB,CA6EpC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { AuditableItemGraphAuditMode } from \"@twin.org/auditable-item-graph-models\";\nimport { JsonLdTypes, type IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\nimport type { AuditableItemGraphAlias } from \"./auditableItemGraphAlias.js\";\nimport type { AuditableItemGraphEdge } from \"./auditableItemGraphEdge.js\";\nimport type { AuditableItemGraphResource } from \"./auditableItemGraphResource.js\";\n\n/**\n * Class describing the auditable item graph vertex.\n */\n@entity({ version: 1 })\nexport class AuditableItemGraphVertex {\n\t/**\n\t * The id of the vertex.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic id!: string;\n\n\t/**\n\t * The identity of the organization which controls the vertex.\n\t */\n\t@property({ type: \"string\" })\n\tpublic organizationIdentity!: string;\n\n\t/**\n\t * The date/time of when the vertex was created.\n\t */\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * The date/time of when the vertex was last modified.\n\t */\n\t@property({\n\t\ttype: \"string\",\n\t\tformat: \"date-time\",\n\t\tsortDirection: SortDirection.Descending,\n\t\toptional: true\n\t})\n\tpublic dateModified?: string;\n\n\t/**\n\t * How the mutations of the vertex are recorded, when absent the vertex behaves as audited.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic auditMode?: AuditableItemGraphAuditMode;\n\n\t/**\n\t * Combined alias index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic aliasIndex?: string;\n\n\t/**\n\t * Combined resource type index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic resourceTypeIndex?: string;\n\n\t/**\n\t * Object to associate with the vertex as JSON-LD.\n\t */\n\t@property({ type: \"object\", itemTypeRef: JsonLdTypes.NodeObject, optional: true })\n\tpublic annotationObject?: IJsonLdNodeObject;\n\n\t/**\n\t * Alternative aliases that can be used to identify the vertex.\n\t */\n\t@property({ type: \"array\", itemType: \"string\", optional: true })\n\tpublic aliases?: AuditableItemGraphAlias[];\n\n\t/**\n\t * The resources attached to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphResource\", optional: true })\n\tpublic resources?: AuditableItemGraphResource[];\n\n\t/**\n\t * Edges connected to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphEdge\", optional: true })\n\tpublic edges?: AuditableItemGraphEdge[];\n\n\t/**\n\t * The current version of the vertex, incremented on each changeset.\n\t */\n\t@property({ type: \"integer\", optional: true })\n\tpublic version?: number;\n}\n"]}

package/dist/es/entities/auditableItemGraphVertexV0.js

@@ -0,0 +1,107 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { JsonLdTypes } from "@twin.org/data-json-ld";
+import { entity, property, SortDirection } from "@twin.org/entity";
+/**
+ * Class describing the auditable item graph vertex, version 0.
+ */
+let AuditableItemGraphVertexV0 = class AuditableItemGraphVertexV0 {
+    /**
+     * The id of the vertex.
+     */
+    id;
+    /**
+     * The identity of the organization which controls the vertex.
+     */
+    organizationIdentity;
+    /**
+     * The date/time of when the vertex was created.
+     */
+    dateCreated;
+    /**
+     * The date/time of when the vertex was last modified.
+     */
+    dateModified;
+    /**
+     * Combined alias index for the vertex used for querying.
+     */
+    aliasIndex;
+    /**
+     * Combined resource type index for the vertex used for querying.
+     */
+    resourceTypeIndex;
+    /**
+     * Object to associate with the vertex as JSON-LD.
+     */
+    annotationObject;
+    /**
+     * Alternative aliases that can be used to identify the vertex.
+     */
+    aliases;
+    /**
+     * The resources attached to the vertex.
+     */
+    resources;
+    /**
+     * Edges connected to the vertex.
+     */
+    edges;
+    /**
+     * The current version of the vertex, incremented on each changeset.
+     */
+    version;
+};
+__decorate([
+    property({ type: "string", isPrimary: true }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "id", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "organizationIdentity", void 0);
+__decorate([
+    property({ type: "string", format: "date-time", sortDirection: SortDirection.Descending }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "dateCreated", void 0);
+__decorate([
+    property({
+        type: "string",
+        format: "date-time",
+        sortDirection: SortDirection.Descending,
+        optional: true
+    }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "dateModified", void 0);
+__decorate([
+    property({ type: "string", isSecondary: true, optional: true }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "aliasIndex", void 0);
+__decorate([
+    property({ type: "string", isSecondary: true, optional: true }),
+    __metadata("design:type", String)
+], AuditableItemGraphVertexV0.prototype, "resourceTypeIndex", void 0);
+__decorate([
+    property({ type: "object", itemTypeRef: JsonLdTypes.NodeObject, optional: true }),
+    __metadata("design:type", Object)
+], AuditableItemGraphVertexV0.prototype, "annotationObject", void 0);
+__decorate([
+    property({ type: "array", itemType: "string", optional: true }),
+    __metadata("design:type", Array)
+], AuditableItemGraphVertexV0.prototype, "aliases", void 0);
+__decorate([
+    property({ type: "array", itemTypeRef: "AuditableItemGraphResource", optional: true }),
+    __metadata("design:type", Array)
+], AuditableItemGraphVertexV0.prototype, "resources", void 0);
+__decorate([
+    property({ type: "array", itemTypeRef: "AuditableItemGraphEdge", optional: true }),
+    __metadata("design:type", Array)
+], AuditableItemGraphVertexV0.prototype, "edges", void 0);
+__decorate([
+    property({ type: "integer", optional: true }),
+    __metadata("design:type", Number)
+], AuditableItemGraphVertexV0.prototype, "version", void 0);
+AuditableItemGraphVertexV0 = __decorate([
+    entity({ version: 0 })
+], AuditableItemGraphVertexV0);
+export { AuditableItemGraphVertexV0 };
+//# sourceMappingURL=auditableItemGraphVertexV0.js.map

package/dist/es/entities/auditableItemGraphVertexV0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditableItemGraphVertexV0.js","sourceRoot":"","sources":["../../../src/entities/auditableItemGraphVertexV0.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,WAAW,EAA0B,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKnE;;GAEG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACtC;;OAEG;IAEI,EAAE,CAAU;IAEnB;;OAEG;IAEI,oBAAoB,CAAU;IAErC;;OAEG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAOI,YAAY,CAAU;IAE7B;;OAEG;IAEI,UAAU,CAAU;IAE3B;;OAEG;IAEI,iBAAiB,CAAU;IAElC;;OAEG;IAEI,gBAAgB,CAAqB;IAE5C;;OAEG;IAEI,OAAO,CAA6B;IAE3C;;OAEG;IAEI,SAAS,CAAgC;IAEhD;;OAEG;IAEI,KAAK,CAA4B;IAExC;;OAEG;IAEI,OAAO,CAAU;CACxB,CAAA;AAlEO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;sDAC3B;AAMZ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;wEACQ;AAM9B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;+DAC/D;AAWrB;IANN,QAAQ,CAAC;QACT,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,aAAa,CAAC,UAAU;QACvC,QAAQ,EAAE,IAAI;KACd,CAAC;;gEAC2B;AAMtB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8DACrC;AAMpB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qEAC9B;AAM3B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oEACtC;AAMrC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACrB;AAMpC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;6DACvC;AAMzC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDAC3C;AAMjC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACtB;AAtEZ,0BAA0B;IADtC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;GACV,0BAA0B,CAuEtC","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { JsonLdTypes, type IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\nimport type { AuditableItemGraphAlias } from \"./auditableItemGraphAlias.js\";\nimport type { AuditableItemGraphEdge } from \"./auditableItemGraphEdge.js\";\nimport type { AuditableItemGraphResource } from \"./auditableItemGraphResource.js\";\n\n/**\n * Class describing the auditable item graph vertex, version 0.\n */\n@entity({ version: 0 })\nexport class AuditableItemGraphVertexV0 {\n\t/**\n\t * The id of the vertex.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic id!: string;\n\n\t/**\n\t * The identity of the organization which controls the vertex.\n\t */\n\t@property({ type: \"string\" })\n\tpublic organizationIdentity!: string;\n\n\t/**\n\t * The date/time of when the vertex was created.\n\t */\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * The date/time of when the vertex was last modified.\n\t */\n\t@property({\n\t\ttype: \"string\",\n\t\tformat: \"date-time\",\n\t\tsortDirection: SortDirection.Descending,\n\t\toptional: true\n\t})\n\tpublic dateModified?: string;\n\n\t/**\n\t * Combined alias index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic aliasIndex?: string;\n\n\t/**\n\t * Combined resource type index for the vertex used for querying.\n\t */\n\t@property({ type: \"string\", isSecondary: true, optional: true })\n\tpublic resourceTypeIndex?: string;\n\n\t/**\n\t * Object to associate with the vertex as JSON-LD.\n\t */\n\t@property({ type: \"object\", itemTypeRef: JsonLdTypes.NodeObject, optional: true })\n\tpublic annotationObject?: IJsonLdNodeObject;\n\n\t/**\n\t * Alternative aliases that can be used to identify the vertex.\n\t */\n\t@property({ type: \"array\", itemType: \"string\", optional: true })\n\tpublic aliases?: AuditableItemGraphAlias[];\n\n\t/**\n\t * The resources attached to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphResource\", optional: true })\n\tpublic resources?: AuditableItemGraphResource[];\n\n\t/**\n\t * Edges connected to the vertex.\n\t */\n\t@property({ type: \"array\", itemTypeRef: \"AuditableItemGraphEdge\", optional: true })\n\tpublic edges?: AuditableItemGraphEdge[];\n\n\t/**\n\t * The current version of the vertex, incremented on each changeset.\n\t */\n\t@property({ type: \"integer\", optional: true })\n\tpublic version?: number;\n}\n"]}

package/dist/es/index.js

@@ -8,6 +8,7 @@ export * from "./entities/auditableItemGraphEdge.js";
 export * from "./entities/auditableItemGraphPatch.js";
 export * from "./entities/auditableItemGraphResource.js";
 export * from "./entities/auditableItemGraphVertex.js";
+export * from "./entities/auditableItemGraphVertexV0.js";
 export * from "./models/IAuditableItemGraphServiceConfig.js";
 export * from "./models/IAuditableItemGraphServiceConstructorOptions.js";
 export * from "./restEntryPoints.js";

package/dist/es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./auditableItemGraphRoutes.js\";\nexport * from \"./auditableItemGraphService.js\";\nexport * from \"./entities/auditableItemGraphAlias.js\";\nexport * from \"./entities/auditableItemGraphChangeset.js\";\nexport * from \"./entities/auditableItemGraphEdge.js\";\nexport * from \"./entities/auditableItemGraphPatch.js\";\nexport * from \"./entities/auditableItemGraphResource.js\";\nexport * from \"./entities/auditableItemGraphVertex.js\";\nexport * from \"./models/IAuditableItemGraphServiceConfig.js\";\nexport * from \"./models/IAuditableItemGraphServiceConstructorOptions.js\";\nexport * from \"./restEntryPoints.js\";\nexport * from \"./schema.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./auditableItemGraphRoutes.js\";\nexport * from \"./auditableItemGraphService.js\";\nexport * from \"./entities/auditableItemGraphAlias.js\";\nexport * from \"./entities/auditableItemGraphChangeset.js\";\nexport * from \"./entities/auditableItemGraphEdge.js\";\nexport * from \"./entities/auditableItemGraphPatch.js\";\nexport * from \"./entities/auditableItemGraphResource.js\";\nexport * from \"./entities/auditableItemGraphVertex.js\";\nexport * from \"./entities/auditableItemGraphVertexV0.js\";\nexport * from \"./models/IAuditableItemGraphServiceConfig.js\";\nexport * from \"./models/IAuditableItemGraphServiceConstructorOptions.js\";\nexport * from \"./restEntryPoints.js\";\nexport * from \"./schema.js\";\n"]}

package/dist/es/schema.js

@@ -7,11 +7,13 @@ import { AuditableItemGraphEdge } from "./entities/auditableItemGraphEdge.js";
 import { AuditableItemGraphPatch } from "./entities/auditableItemGraphPatch.js";
 import { AuditableItemGraphResource } from "./entities/auditableItemGraphResource.js";
 import { AuditableItemGraphVertex } from "./entities/auditableItemGraphVertex.js";
+import { AuditableItemGraphVertexV0 } from "./entities/auditableItemGraphVertexV0.js";
 /**
  * Initialize the schema for the auditable item graph entity storage connector.
  */
 export function initSchema() {
     EntitySchemaFactory.register("AuditableItemGraphVertex", () => EntitySchemaHelper.getSchema(AuditableItemGraphVertex));
+    EntitySchemaFactory.register("AuditableItemGraphVertexV0", () => EntitySchemaHelper.getSchema(AuditableItemGraphVertexV0));
     EntitySchemaFactory.register("AuditableItemGraphAlias", () => EntitySchemaHelper.getSchema(AuditableItemGraphAlias));
     EntitySchemaFactory.register("AuditableItemGraphResource", () => EntitySchemaHelper.getSchema(AuditableItemGraphResource));
     EntitySchemaFactory.register("AuditableItemGraphEdge", () => EntitySchemaHelper.getSchema(AuditableItemGraphEdge));

package/dist/es/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAElF;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,6BAAqC,GAAG,EAAE,CACrE,kBAAkB,CAAC,SAAS,CAAC,wBAAwB,CAAC,CACtD,CAAC;IACF,mBAAmB,CAAC,QAAQ,4BAAoC,GAAG,EAAE,CACpE,kBAAkB,CAAC,SAAS,CAAC,uBAAuB,CAAC,CACrD,CAAC;IACF,mBAAmB,CAAC,QAAQ,+BAAuC,GAAG,EAAE,CACvE,kBAAkB,CAAC,SAAS,CAAC,0BAA0B,CAAC,CACxD,CAAC;IACF,mBAAmB,CAAC,QAAQ,2BAAmC,GAAG,EAAE,CACnE,kBAAkB,CAAC,SAAS,CAAC,sBAAsB,CAAC,CACpD,CAAC;IACF,mBAAmB,CAAC,QAAQ,gCAAwC,GAAG,EAAE,CACxE,kBAAkB,CAAC,SAAS,CAAC,2BAA2B,CAAC,CACzD,CAAC;IACF,mBAAmB,CAAC,QAAQ,4BAAoC,GAAG,EAAE,CACpE,kBAAkB,CAAC,SAAS,CAAC,uBAAuB,CAAC,CACrD,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { AuditableItemGraphAlias } from \"./entities/auditableItemGraphAlias.js\";\nimport { AuditableItemGraphChangeset } from \"./entities/auditableItemGraphChangeset.js\";\nimport { AuditableItemGraphEdge } from \"./entities/auditableItemGraphEdge.js\";\nimport { AuditableItemGraphPatch } from \"./entities/auditableItemGraphPatch.js\";\nimport { AuditableItemGraphResource } from \"./entities/auditableItemGraphResource.js\";\nimport { AuditableItemGraphVertex } from \"./entities/auditableItemGraphVertex.js\";\n\n/**\n * Initialize the schema for the auditable item graph entity storage connector.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphVertex>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphVertex)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphAlias>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphAlias)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphResource>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphResource)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphEdge>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphEdge)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphChangeset>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphChangeset)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphPatch>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphPatch)\n\t);\n}\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAEtF;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,6BAAqC,GAAG,EAAE,CACrE,kBAAkB,CAAC,SAAS,CAAC,wBAAwB,CAAC,CACtD,CAAC;IACF,mBAAmB,CAAC,QAAQ,+BAAuC,GAAG,EAAE,CACvE,kBAAkB,CAAC,SAAS,CAAC,0BAA0B,CAAC,CACxD,CAAC;IACF,mBAAmB,CAAC,QAAQ,4BAAoC,GAAG,EAAE,CACpE,kBAAkB,CAAC,SAAS,CAAC,uBAAuB,CAAC,CACrD,CAAC;IACF,mBAAmB,CAAC,QAAQ,+BAAuC,GAAG,EAAE,CACvE,kBAAkB,CAAC,SAAS,CAAC,0BAA0B,CAAC,CACxD,CAAC;IACF,mBAAmB,CAAC,QAAQ,2BAAmC,GAAG,EAAE,CACnE,kBAAkB,CAAC,SAAS,CAAC,sBAAsB,CAAC,CACpD,CAAC;IACF,mBAAmB,CAAC,QAAQ,gCAAwC,GAAG,EAAE,CACxE,kBAAkB,CAAC,SAAS,CAAC,2BAA2B,CAAC,CACzD,CAAC;IACF,mBAAmB,CAAC,QAAQ,4BAAoC,GAAG,EAAE,CACpE,kBAAkB,CAAC,SAAS,CAAC,uBAAuB,CAAC,CACrD,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { AuditableItemGraphAlias } from \"./entities/auditableItemGraphAlias.js\";\nimport { AuditableItemGraphChangeset } from \"./entities/auditableItemGraphChangeset.js\";\nimport { AuditableItemGraphEdge } from \"./entities/auditableItemGraphEdge.js\";\nimport { AuditableItemGraphPatch } from \"./entities/auditableItemGraphPatch.js\";\nimport { AuditableItemGraphResource } from \"./entities/auditableItemGraphResource.js\";\nimport { AuditableItemGraphVertex } from \"./entities/auditableItemGraphVertex.js\";\nimport { AuditableItemGraphVertexV0 } from \"./entities/auditableItemGraphVertexV0.js\";\n\n/**\n * Initialize the schema for the auditable item graph entity storage connector.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphVertex>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphVertex)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphVertexV0>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphVertexV0)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphAlias>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphAlias)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphResource>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphResource)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphEdge>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphEdge)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphChangeset>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphChangeset)\n\t);\n\tEntitySchemaFactory.register(nameof<AuditableItemGraphPatch>(), () =>\n\t\tEntitySchemaHelper.getSchema(AuditableItemGraphPatch)\n\t);\n}\n"]}

package/dist/types/auditableItemGraphService.d.ts

@@ -43,6 +43,7 @@ export declare class AuditableItemGraphService implements IAuditableItemGraphCom
     /**
      * Create a new graph vertex.
      * @param vertex The vertex to create.
+     * @param vertex.auditMode How the mutations of the vertex are recorded, defaults to audited.
      * @param vertex.annotationObject The annotation object for the vertex as JSON-LD.
      * @param vertex.aliases Alternative aliases that can be used to identify the vertex.
      * @param vertex.resources The resources attached to the vertex.
@@ -55,6 +56,7 @@ export declare class AuditableItemGraphService implements IAuditableItemGraphCom
      * Concurrent updates for the same vertex are serialized via `Mutex` on the vertex id.
      * @param vertex The vertex to update.
      * @returns A promise that resolves when the vertex has been updated.
+     * @throws GeneralError If a bypass vertex is being switched back to audited.
      */
     update(vertex: IAuditableItemGraphVertex): Promise<void>;
     /**
@@ -62,6 +64,7 @@ export declare class AuditableItemGraphService implements IAuditableItemGraphCom
      * Serialized with `update` via `Mutex` on the same vertex id within this instance.
      * @param partial The partial vertex update.
      * @returns A promise that resolves when the partial update has been applied.
+     * @throws GeneralError If a bypass vertex is being switched back to audited.
      */
     updatePartial(partial: IAuditableItemGraphPartialVertex): Promise<void>;
     /**
@@ -109,7 +112,7 @@ export declare class AuditableItemGraphService implements IAuditableItemGraphCom
      * @param id The id of the vertex.
      * @param version The version number to retrieve.
      * @returns The vertex reconstructed at that version.
-     * @throws NotFoundError if the vertex or version is not found.
+     * @throws NotFoundError if the vertex or version is not found, a bypass vertex never has versions.
      */
     getVersion(id: string, version: number): Promise<IAuditableItemGraphVertex>;
     /**
@@ -118,7 +121,8 @@ export declare class AuditableItemGraphService implements IAuditableItemGraphCom
      * @param options Additional options for the operation.
      * @param options.after Only return versions created after this ISO 8601 timestamp (exclusive).
      * @param options.before Only return versions created before this ISO 8601 timestamp (exclusive).
-     * @returns The list of vertex versions.
+     * @returns The list of vertex versions, a bypass vertex returns a single baseline entry for its
+     * current state when that falls within the requested range.
      * @throws NotFoundError if the vertex is not found.
      */
     getVersions(id: string, options?: {

package/dist/types/entities/auditableItemGraphVertex.d.ts

@@ -1,3 +1,4 @@
+import type { AuditableItemGraphAuditMode } from "@twin.org/auditable-item-graph-models";
 import { type IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { AuditableItemGraphAlias } from "./auditableItemGraphAlias.js";
 import type { AuditableItemGraphEdge } from "./auditableItemGraphEdge.js";
@@ -22,6 +23,10 @@ export declare class AuditableItemGraphVertex {
      * The date/time of when the vertex was last modified.
      */
     dateModified?: string;
+    /**
+     * How the mutations of the vertex are recorded, when absent the vertex behaves as audited.
+     */
+    auditMode?: AuditableItemGraphAuditMode;
     /**
      * Combined alias index for the vertex used for querying.
      */

package/dist/types/entities/auditableItemGraphVertexV0.d.ts

@@ -0,0 +1,53 @@
+import { type IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { AuditableItemGraphAlias } from "./auditableItemGraphAlias.js";
+import type { AuditableItemGraphEdge } from "./auditableItemGraphEdge.js";
+import type { AuditableItemGraphResource } from "./auditableItemGraphResource.js";
+/**
+ * Class describing the auditable item graph vertex, version 0.
+ */
+export declare class AuditableItemGraphVertexV0 {
+    /**
+     * The id of the vertex.
+     */
+    id: string;
+    /**
+     * The identity of the organization which controls the vertex.
+     */
+    organizationIdentity: string;
+    /**
+     * The date/time of when the vertex was created.
+     */
+    dateCreated: string;
+    /**
+     * The date/time of when the vertex was last modified.
+     */
+    dateModified?: string;
+    /**
+     * Combined alias index for the vertex used for querying.
+     */
+    aliasIndex?: string;
+    /**
+     * Combined resource type index for the vertex used for querying.
+     */
+    resourceTypeIndex?: string;
+    /**
+     * Object to associate with the vertex as JSON-LD.
+     */
+    annotationObject?: IJsonLdNodeObject;
+    /**
+     * Alternative aliases that can be used to identify the vertex.
+     */
+    aliases?: AuditableItemGraphAlias[];
+    /**
+     * The resources attached to the vertex.
+     */
+    resources?: AuditableItemGraphResource[];
+    /**
+     * Edges connected to the vertex.
+     */
+    edges?: AuditableItemGraphEdge[];
+    /**
+     * The current version of the vertex, incremented on each changeset.
+     */
+    version?: number;
+}

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export * from "./entities/auditableItemGraphEdge.js";
 export * from "./entities/auditableItemGraphPatch.js";
 export * from "./entities/auditableItemGraphResource.js";
 export * from "./entities/auditableItemGraphVertex.js";
+export * from "./entities/auditableItemGraphVertexV0.js";
 export * from "./models/IAuditableItemGraphServiceConfig.js";
 export * from "./models/IAuditableItemGraphServiceConstructorOptions.js";
 export * from "./restEntryPoints.js";

package/docs/changelog.md

@@ -1,5 +1,92 @@
 # Changelog
 
+## [0.10.0](https://github.com/iotaledger/twin-auditable-item-graph/compare/auditable-item-graph-service-v0.10.0...auditable-item-graph-service-v0.10.0) (2026-09-16)
+
+
+### Features
+
+* release to production ([0ce06f7](https://github.com/iotaledger/twin-auditable-item-graph/commit/0ce06f7825aa72d04b7a2ffd8c98cb56290b9d16))
+* release to production ([#110](https://github.com/iotaledger/twin-auditable-item-graph/issues/110)) ([3117da3](https://github.com/iotaledger/twin-auditable-item-graph/commit/3117da373b462d1c8dcb7e1416bcb223f2a28664))
+* release to production ([#113](https://github.com/iotaledger/twin-auditable-item-graph/issues/113)) ([4efe407](https://github.com/iotaledger/twin-auditable-item-graph/commit/4efe40774803f01eb70043b8cfd607e8c050bc64))
+* release to production ([#129](https://github.com/iotaledger/twin-auditable-item-graph/issues/129)) ([34417f9](https://github.com/iotaledger/twin-auditable-item-graph/commit/34417f9914b84379ea3df9017bc55cf770e938df))
+* release to production ([#137](https://github.com/iotaledger/twin-auditable-item-graph/issues/137)) ([959187f](https://github.com/iotaledger/twin-auditable-item-graph/commit/959187f5dc6d7677edec9ce89d56735cefdebf50))
+* release to production [skip ci] ([#146](https://github.com/iotaledger/twin-auditable-item-graph/issues/146)) ([2da3164](https://github.com/iotaledger/twin-auditable-item-graph/commit/2da3164d4e06fc0b40ca46433b9ef286786d822e))
+
+
+### Bug Fixes
+
+* tests ([3875814](https://github.com/iotaledger/twin-auditable-item-graph/commit/387581441464c41c0bffb7ca4f45200d05a7d91f))
+
+## [0.9.3-next.1](https://github.com/iotaledger/twin-auditable-item-graph/compare/auditable-item-graph-service-v0.9.3-next.0...auditable-item-graph-service-v0.9.3-next.1) (2026-09-04)
+
+
+### Features
+
+* add context id features ([#30](https://github.com/iotaledger/twin-auditable-item-graph/issues/30)) ([a35d37c](https://github.com/iotaledger/twin-auditable-item-graph/commit/a35d37c0db62a240adde493965c0a9f7971fec45))
+* add data types with fully qualified name ([93e1ee7](https://github.com/iotaledger/twin-auditable-item-graph/commit/93e1ee7c0f7bad81f003787f797f363864e201af))
+* add event-driven telemetry metrics ([#63](https://github.com/iotaledger/twin-auditable-item-graph/issues/63)) ([8fe6cdd](https://github.com/iotaledger/twin-auditable-item-graph/commit/8fe6cdd0d56496402b766c151f002f475ddb8c0e))
+* add health provider ([#132](https://github.com/iotaledger/twin-auditable-item-graph/issues/132)) ([5183025](https://github.com/iotaledger/twin-auditable-item-graph/commit/51830259fe6480cd56d1aeade0b1889f2c59f711))
+* add optional audit mode ([#140](https://github.com/iotaledger/twin-auditable-item-graph/issues/140)) ([95e8fba](https://github.com/iotaledger/twin-auditable-item-graph/commit/95e8fba664611fb9bc6ab18dea6020a2a4e40792))
+* add unique flag for alias, and exact match option for id query ([33dbd19](https://github.com/iotaledger/twin-auditable-item-graph/commit/33dbd19cabd9fbfaba81032f1d1a6527584c3f5a))
+* add validate-locales ([e76e6f6](https://github.com/iotaledger/twin-auditable-item-graph/commit/e76e6f6b3ec9c447a04315d353442e32233601d3))
+* add versions ([#60](https://github.com/iotaledger/twin-auditable-item-graph/issues/60)) ([5c36f94](https://github.com/iotaledger/twin-auditable-item-graph/commit/5c36f94b1155c01dddbc8d62f3f65d599916c521))
+* add vertex validation ([#54](https://github.com/iotaledger/twin-auditable-item-graph/issues/54)) ([d3ef124](https://github.com/iotaledger/twin-auditable-item-graph/commit/d3ef1241f60956dc296e22d063f188921255d68c))
+* additional query conditions ([#100](https://github.com/iotaledger/twin-auditable-item-graph/issues/100)) ([4fc6b7a](https://github.com/iotaledger/twin-auditable-item-graph/commit/4fc6b7afd7a854806537954fcd334619304da49c))
+* changeset endpoints ([#44](https://github.com/iotaledger/twin-auditable-item-graph/issues/44)) ([7c854de](https://github.com/iotaledger/twin-auditable-item-graph/commit/7c854de39b247d6f24cd94a04a9f99fa9edde51d))
+* configurable timeout for mutex ([5178789](https://github.com/iotaledger/twin-auditable-item-graph/commit/5178789ba160bca95221ce26bf87d7bd8c0c8619))
+* enhanced rest testing ([#119](https://github.com/iotaledger/twin-auditable-item-graph/issues/119)) ([11f5653](https://github.com/iotaledger/twin-auditable-item-graph/commit/11f5653d297066983b5787429a262eca6a6f3fa7))
+* eslint migration to flat config ([1b42a3a](https://github.com/iotaledger/twin-auditable-item-graph/commit/1b42a3a27bd6e32d7816de406b92b6332472edf6))
+* id optional in edge updates ([6b63fe3](https://github.com/iotaledger/twin-auditable-item-graph/commit/6b63fe34553104843ae15aa5066775f5872859e9))
+* improve JSON schemas ([bec8dc1](https://github.com/iotaledger/twin-auditable-item-graph/commit/bec8dc1f270c6c9710623a192b984cf46f8a5613))
+* improved versioning ([#66](https://github.com/iotaledger/twin-auditable-item-graph/issues/66)) ([1b497cd](https://github.com/iotaledger/twin-auditable-item-graph/commit/1b497cdc88eec9b6707b097283773e109baae3aa))
+* mutex on remove proof operation ([d3697a0](https://github.com/iotaledger/twin-auditable-item-graph/commit/d3697a010997c2f9da1d13922a321be002ee27d3))
+* only set dateModified after update ([#4](https://github.com/iotaledger/twin-auditable-item-graph/issues/4)) ([43ea6e5](https://github.com/iotaledger/twin-auditable-item-graph/commit/43ea6e5f2d0b9181a80f0bf2935db64b3263839a))
+* organization identifiers ([#88](https://github.com/iotaledger/twin-auditable-item-graph/issues/88)) ([c58d35b](https://github.com/iotaledger/twin-auditable-item-graph/commit/c58d35bd5b878da0fa02862797c70b61e4f2a469))
+* remove hosting component ([#91](https://github.com/iotaledger/twin-auditable-item-graph/issues/91)) ([d6180a8](https://github.com/iotaledger/twin-auditable-item-graph/commit/d6180a89a741314d81b44a9664aaff708c2d0ffa))
+* remove unused namespace ([ff1a3b4](https://github.com/iotaledger/twin-auditable-item-graph/commit/ff1a3b4e414fe2ee311a03027456ee40fbb580d7))
+* replace nextItem property with Link header ([#39](https://github.com/iotaledger/twin-auditable-item-graph/issues/39)) ([b29a333](https://github.com/iotaledger/twin-auditable-item-graph/commit/b29a333ca78ca2091e54e3e6f4355f84c350007d))
+* rest enhancements ([1e51050](https://github.com/iotaledger/twin-auditable-item-graph/commit/1e51050af4c1a92f1f127054fe4c9da5e8cb591e))
+* typescript 6 update ([2483c31](https://github.com/iotaledger/twin-auditable-item-graph/commit/2483c3171cff4c5ecedc83d958ab551291a4a487))
+* update background task service ([e483ddb](https://github.com/iotaledger/twin-auditable-item-graph/commit/e483ddbc948f035334f92b8342248caa6abbe441))
+* update contexts ([#35](https://github.com/iotaledger/twin-auditable-item-graph/issues/35)) ([cdf0989](https://github.com/iotaledger/twin-auditable-item-graph/commit/cdf0989fe4677a88b757e97e752b7d4c29013a7e))
+* update contexts and namespaces ([#33](https://github.com/iotaledger/twin-auditable-item-graph/issues/33)) ([5dadb99](https://github.com/iotaledger/twin-auditable-item-graph/commit/5dadb99773d410aceacaba7ed92c1ccb8b46516b))
+* update dependencies ([482c97e](https://github.com/iotaledger/twin-auditable-item-graph/commit/482c97e16109e504cb495084ef51e860a7f86669))
+* update dependencies ([6986689](https://github.com/iotaledger/twin-auditable-item-graph/commit/698668957a1fcb7f85ce2f117914d5980043924f))
+* update edges to use targetId instead of id ([6c5d0e3](https://github.com/iotaledger/twin-auditable-item-graph/commit/6c5d0e31b6e2ea74bfa2f3344e4be628e5f237af))
+* update framework core ([88ad4e6](https://github.com/iotaledger/twin-auditable-item-graph/commit/88ad4e6421132c3c6c45579b078d982a26f16990))
+* update immutable proof usage ([#73](https://github.com/iotaledger/twin-auditable-item-graph/issues/73)) ([a5181d1](https://github.com/iotaledger/twin-auditable-item-graph/commit/a5181d172cbc492c7cc964d22724cc10c46fc52e))
+* update naming ([39210c4](https://github.com/iotaledger/twin-auditable-item-graph/commit/39210c45baddd3cd48805140a1c0049f3004653f))
+* update schemas ([b00bcac](https://github.com/iotaledger/twin-auditable-item-graph/commit/b00bcac6551fa524e8871e1b573a712ed0f30943))
+* use new hosting url for cursor links ([809cdc6](https://github.com/iotaledger/twin-auditable-item-graph/commit/809cdc623491bad91000d0b0f740e40dc019198d))
+* use new nameof operators ([3921c4c](https://github.com/iotaledger/twin-auditable-item-graph/commit/3921c4c9ac53e42459e45f10d9e702afb2797a23))
+* use shared store mechanism ([#10](https://github.com/iotaledger/twin-auditable-item-graph/issues/10)) ([da035e5](https://github.com/iotaledger/twin-auditable-item-graph/commit/da035e5eb8f157482b4eb2bdbc689c6c0647ff7d))
+* use standard list json ld types ([8f53836](https://github.com/iotaledger/twin-auditable-item-graph/commit/8f53836d4c83a98d64d7f5fe0531bb9af09464ae))
+* uuidv7 ([#46](https://github.com/iotaledger/twin-auditable-item-graph/issues/46)) ([d0179f8](https://github.com/iotaledger/twin-auditable-item-graph/commit/d0179f81290e0beae2f1c398a028aca6dd754023))
+
+
+### Bug Fixes
+
+* aig concurrent resource regression tests ([#77](https://github.com/iotaledger/twin-auditable-item-graph/issues/77)) ([82b8725](https://github.com/iotaledger/twin-auditable-item-graph/commit/82b872585686e070dde0a0c8493ded6e40a7a1d9))
+* context usage ([9c8f64d](https://github.com/iotaledger/twin-auditable-item-graph/commit/9c8f64d342e9fb40d3514b87fd547a824ce50676))
+* gate immutable proof on vertex organizationIdentity in AIG ([#81](https://github.com/iotaledger/twin-auditable-item-graph/issues/81)) ([0e67b6f](https://github.com/iotaledger/twin-auditable-item-graph/commit/0e67b6fb3511ca903667e11da3bdbcecdad7b21d))
+* implement removeProof on AuditableItemGraphRestClient and expose DELETE /:id/proof route ([#85](https://github.com/iotaledger/twin-auditable-item-graph/issues/85)) ([ed74458](https://github.com/iotaledger/twin-auditable-item-graph/commit/ed74458aff9bc8606b75657a7bff15af4884189e))
+* incremental edge merge and per-vertex update queue ([#70](https://github.com/iotaledger/twin-auditable-item-graph/issues/70)) ([91eb51d](https://github.com/iotaledger/twin-auditable-item-graph/commit/91eb51d135d2e609eebce90de099670f08eb20ca))
+* only include alias in index if not deleted ([#6](https://github.com/iotaledger/twin-auditable-item-graph/issues/6)) ([5da3c41](https://github.com/iotaledger/twin-auditable-item-graph/commit/5da3c419fafa2afefd34b1c570d103012b888a75))
+* query fixed ordering ([#124](https://github.com/iotaledger/twin-auditable-item-graph/issues/124)) ([f28d46d](https://github.com/iotaledger/twin-auditable-item-graph/commit/f28d46dae9bd2706c0cb1562b992757b1f5012ec))
+* query params force coercion ([2dd9afe](https://github.com/iotaledger/twin-auditable-item-graph/commit/2dd9afe9ec37e2a91c110317fe289f7495c187a0))
+* query resource type property name ([b684b31](https://github.com/iotaledger/twin-auditable-item-graph/commit/b684b3108e1e16852ee319e47edd0e40d5a2fe99))
+* support new compactArrays flag ([2809b2b](https://github.com/iotaledger/twin-auditable-item-graph/commit/2809b2b83a946a850ad8f87f390fc00265a3fe7d))
+* update tests with new deterministic background tasks ([#8](https://github.com/iotaledger/twin-auditable-item-graph/issues/8)) ([a96721c](https://github.com/iotaledger/twin-auditable-item-graph/commit/a96721c28128781f9cbd983d013dcf4c5542158c))
+* use async getStore in tests ([0a911c0](https://github.com/iotaledger/twin-auditable-item-graph/commit/0a911c0c2c8a92e89d284e8651c0ef44736dc396))
+* use async getStore in tests ([8d2969b](https://github.com/iotaledger/twin-auditable-item-graph/commit/8d2969b45fdeef849456cfbf898c580b23ce676c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/auditable-item-graph-models bumped from 0.9.3-next.0 to 0.9.3-next.1
+
 ## [0.9.2](https://github.com/iotaledger/twin-auditable-item-graph/compare/auditable-item-graph-service-v0.9.2...auditable-item-graph-service-v0.9.2) (2026-08-24)
 
 

package/docs/examples.md

@@ -116,6 +116,38 @@ console.log(queryResult.entries.itemListElement?.length ?? 0); // 3
 await service.removeVerifiable('aig:018f5a6cfd9444d58c7c2d4df1fd0a23');
 ```
 
+Vertices which only need their current state can opt out of versioning with `auditMode`. Bypass is a
+terminal mode; switching an audited vertex to bypass compacts its history and removes the associated
+proofs, and a bypass vertex can never return to audited.
+
+```typescript
+import { AuditableItemGraphAuditMode } from '@twin.org/auditable-item-graph-models';
+import { AuditableItemGraphService } from '@twin.org/auditable-item-graph-service';
+
+const service = new AuditableItemGraphService();
+
+const lookupId = await service.create({
+  auditMode: AuditableItemGraphAuditMode.Bypass,
+  aliases: [{ id: 'currency-rates', aliasFormat: 'lookupRef' }]
+});
+
+// Overwrites the stored state in place, no changeset is written.
+await service.updatePartial({
+  id: lookupId,
+  annotationObject: { '@context': 'https://schema.org', type: 'Thing', name: 'Rates 2026-03-10' }
+});
+
+const changesets = await service.getChangesets(lookupId);
+
+console.log(changesets.changesets.itemListElement?.length ?? 0); // 0
+
+// Archive an existing audited vertex by compacting it to its current state.
+await service.updatePartial({
+  id: 'aig:018f5a6cfd9444d58c7c2d4df1fd0a23',
+  auditMode: AuditableItemGraphAuditMode.Bypass
+});
+```
+
 ## AuditableItemGraphVertex
 
 ```typescript

package/docs/open-api/spec.json

@@ -1924,6 +1924,9 @@
 						"type": "string",
 						"description": "The identity of the organization which controls the vertex."
 					},
+					"auditMode": {
+						"$ref": "https://schema.twindev.org/aig/AuditableItemGraphAuditMode"
+					},
 					"annotationObject": {
 						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
 					},
@@ -1950,11 +1953,11 @@
 					},
 					"verified": {
 						"type": "boolean",
-						"description": "Is the vertex verified, will only be populated when verification is requested."
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
 					},
 					"version": {
 						"type": "number",
-						"description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version."
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
 					}
 				},
 				"required": [
@@ -1998,16 +2001,19 @@
 						"type": "string",
 						"description": "The identity of the organization which controls the vertex."
 					},
+					"auditMode": {
+						"$ref": "https://schema.twindev.org/aig/AuditableItemGraphAuditMode"
+					},
 					"annotationObject": {
 						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
 					},
 					"verified": {
 						"type": "boolean",
-						"description": "Is the vertex verified, will only be populated when verification is requested."
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
 					},
 					"version": {
 						"type": "number",
-						"description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version."
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
 					},
 					"type": {
 						"const": "AuditableItemGraphVertex",
@@ -2067,6 +2073,9 @@
 						"type": "string",
 						"description": "The identity of the organization which controls the vertex."
 					},
+					"auditMode": {
+						"$ref": "https://schema.twindev.org/aig/AuditableItemGraphAuditMode"
+					},
 					"annotationObject": {
 						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
 					},
@@ -2093,11 +2102,11 @@
 					},
 					"verified": {
 						"type": "boolean",
-						"description": "Is the vertex verified, will only be populated when verification is requested."
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
 					},
 					"version": {
 						"type": "number",
-						"description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version."
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
 					}
 				},
 				"required": [

package/docs/reference/classes/AuditableItemGraphService.md

@@ -163,6 +163,10 @@ The vertex to update.
 
 A promise that resolves when the vertex has been updated.
 
+#### Throws
+
+GeneralError If a bypass vertex is being switched back to audited.
+
 #### Implementation of
 
 `IAuditableItemGraphComponent.update`
@@ -190,6 +194,10 @@ The partial vertex update.
 
 A promise that resolves when the partial update has been applied.
 
+#### Throws
+
+GeneralError If a bypass vertex is being switched back to audited.
+
 #### Implementation of
 
 `IAuditableItemGraphComponent.updatePartial`
@@ -362,7 +370,7 @@ The vertex reconstructed at that version.
 
 #### Throws
 
-NotFoundError if the vertex or version is not found.
+NotFoundError if the vertex or version is not found, a bypass vertex never has versions.
 
 #### Implementation of
 
@@ -404,7 +412,8 @@ Only return versions created before this ISO 8601 timestamp (exclusive).
 
 `Promise`\<`IAuditableItemGraphVertexVersionList`\>
 
-The list of vertex versions.
+The list of vertex versions, a bypass vertex returns a single baseline entry for its
+current state when that falls within the requested range.
 
 #### Throws
 

package/docs/reference/classes/AuditableItemGraphVertex.md

@@ -46,6 +46,14 @@ The date/time of when the vertex was last modified.
 
 ***
 
+### auditMode? {#auditmode}
+
+> `optional` **auditMode?**: `AuditableItemGraphAuditMode`
+
+How the mutations of the vertex are recorded, when absent the vertex behaves as audited.
+
+***
+
 ### aliasIndex? {#aliasindex}
 
 > `optional` **aliasIndex?**: `string`