@agent-teams/document-authoring 0.0.0

package/dist/application/model/document-planning.d.ts

@@ -0,0 +1,209 @@
+import type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentIdentityProjectionEntry, DocumentationCatalogSnapshotContract } from "./document-catalog.js";
+import type { DocumentParentMaterializationPlanV2 } from "./document-parent-materialization.js";
+export type DocumentJsonPrimitive = boolean | null | number | string;
+export interface DocumentJsonObject {
+    readonly [key: string]: DocumentJsonValue;
+}
+export type DocumentJsonValue = DocumentJsonPrimitive | readonly DocumentJsonValue[] | DocumentJsonObject;
+export interface DocumentIntent {
+    readonly schemaVersion: 1;
+    readonly type: string;
+    readonly id: string;
+    readonly title: string;
+    readonly owner: string;
+    readonly summary: string;
+    readonly slug?: string;
+    readonly destination?: string;
+    readonly related?: readonly string[];
+    readonly additionalMetadata?: Readonly<Record<string, DocumentJsonValue>>;
+}
+export type DocumentIdentityStrategy = {
+    readonly kind: "explicit";
+    readonly format: "adr-four-digits" | "open-decision-three-digits";
+} | {
+    readonly kind: "explicit";
+    readonly format: "qualified";
+    readonly grammar: {
+        readonly prefixSegments: readonly string[];
+        readonly minSuffixSegments: number;
+        readonly maxSuffixSegments: number;
+    };
+};
+export type DocumentPlacementStrategy = {
+    readonly kind: "collection";
+    readonly directory: string;
+    readonly filename: "numeric-id-slug" | "id-slug" | "slug" | "README.md";
+} | {
+    readonly kind: "qualified-leaf-index";
+    readonly root: string;
+    readonly requiredBasename: "README.md";
+} | {
+    readonly kind: "explicit";
+    readonly allowedRoots: readonly string[];
+    readonly requiredSegmentsInOrder: readonly string[];
+    readonly requiredBasename: "README.md";
+    readonly minimumSegmentsBeforeRequired: number;
+    readonly minimumSegmentsAfterRequired: number;
+};
+export interface DocumentArtifactType {
+    readonly allowedOwnerIds?: readonly string[];
+    readonly type: string;
+    readonly initialStatus: string;
+    readonly identity: DocumentIdentityStrategy;
+    readonly placement: DocumentPlacementStrategy;
+    readonly template: {
+        readonly kind: "fenced-markdown-body";
+        readonly path: string;
+    };
+    readonly heading: {
+        readonly kind: "id-colon-title" | "title";
+    };
+    readonly reachability: DocumentReachabilityStrategy;
+}
+export type DocumentReachabilityStrategy = {
+    readonly kind: "manual-fixed-index";
+    readonly indexPath: string;
+} | {
+    readonly kind: "manual-colocated-index";
+    readonly pathPrefix: "before-required-segments";
+    readonly indexBasename: "README.md";
+} | {
+    readonly kind: "not-required";
+};
+export type DocumentCatalogCollection = {
+    readonly kind: "frontmatter-readme";
+    readonly roots: readonly string[];
+} | {
+    readonly kind: "markdown-tree";
+    readonly root: string;
+};
+export interface DocumentPlanningProfileSnapshot {
+    readonly artifactTypes: readonly DocumentArtifactType[];
+    readonly collections: readonly DocumentCatalogCollection[];
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly excludedPrefixes: readonly string[];
+    readonly metadataSchemaPath: string;
+    readonly metadataSidecar?: {
+        readonly kind: "path-metadata-map";
+        readonly path: string;
+    };
+    readonly ownerCatalog: {
+        readonly contract: "foundation.owner-map/v1";
+        readonly path: string;
+    };
+    readonly projectId: string;
+    readonly schemaVersion?: 1 | 2 | 3;
+}
+export interface DocumentTemplateSnapshot {
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly source: string;
+}
+export interface DocumentCompilerIdentity {
+    readonly id: "@agent-teams/document-authoring" | "@agent-teams/engineering-foundation";
+    readonly version: string;
+    readonly buildIdentity: DocumentAuthorityDigest;
+}
+type DocumentDestinationObservation = {
+    readonly state: "absent";
+} | {
+    readonly state: "regular-file";
+    readonly bytes: Uint8Array;
+} | {
+    readonly state: "conflict";
+    readonly kind: "directory" | "portable-name-collision" | "special-file";
+};
+export interface DocumentPlanningStateSnapshot {
+    readonly destination: DocumentDestinationObservation;
+    readonly expectedParent: {
+        readonly path: string;
+        readonly state: "directory";
+        readonly ancestry: "real-directories";
+    };
+    readonly parentMaterialization?: DocumentParentMaterializationPlanV2;
+}
+export interface DocumentPlanDiagnostic {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "authority" | "input" | "planning" | "policy";
+    readonly subject: string;
+    readonly message: string;
+}
+export interface DocumentPlan {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly compiler: DocumentCompilerIdentity;
+    readonly projectId: string;
+    readonly intent: DocumentIntent;
+    readonly intentDigest: DocumentAuthorityDigest;
+    readonly authority: {
+        readonly profile: DocumentAuthorityEvidence;
+        readonly metadataSchema: DocumentAuthorityEvidence;
+        readonly ownerCatalog: DocumentAuthorityEvidence;
+        readonly template: DocumentAuthorityEvidence;
+    };
+    readonly selectedOwner: {
+        readonly id: string;
+        readonly membershipDigest: DocumentAuthorityDigest;
+    };
+    readonly identityProjection: {
+        readonly entryCount: number;
+        readonly digest: DocumentAuthorityDigest;
+    };
+    readonly referencedDocuments: readonly {
+        readonly id: string;
+        readonly path: string;
+        readonly projectionDigest: DocumentAuthorityDigest;
+    }[];
+    readonly destination: string;
+    readonly expectedParent: {
+        readonly path: string;
+        readonly state: "directory";
+        readonly ancestry: "real-directories";
+    };
+    readonly destinationPrecondition: {
+        readonly state: "absent";
+    };
+    readonly output: {
+        readonly digest: DocumentAuthorityDigest;
+        readonly size: number;
+        readonly mode: "0644";
+        readonly mediaType: "text/markdown; charset=utf-8";
+        readonly contentBase64: string;
+    };
+    readonly requiredAdapterCapabilities: readonly ["create-file-no-replace/v1"];
+    readonly diagnostics: readonly DocumentPlanDiagnostic[];
+    readonly planDigest: DocumentAuthorityDigest;
+}
+export type DocumentPlanV1 = DocumentPlan;
+export type DocumentPlanCommon = Omit<DocumentPlan, "protocolVersion" | "requiredAdapterCapabilities" | "schemaVersion">;
+export interface DocumentPlanV2 extends Omit<DocumentPlanCommon, "authority"> {
+    readonly authority: DocumentPlan["authority"] & {
+        readonly metadataSidecar?: DocumentAuthorityEvidence;
+        readonly profileSemanticDigest: DocumentAuthorityDigest;
+        readonly catalogPreimageSemanticDigest: DocumentAuthorityDigest;
+        readonly expectedCatalogPostimageSemanticDigest: DocumentAuthorityDigest;
+    };
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly parentMaterialization: DocumentParentMaterializationPlanV2;
+    readonly requiredAdapterCapabilities: readonly [
+        "create-directories-no-replace/v1",
+        "create-file-no-replace/v1"
+    ];
+}
+export type DocumentPlanContract = DocumentPlan | DocumentPlanV2;
+export interface DocumentPlanningCompilationInput {
+    readonly catalog: DocumentationCatalogSnapshotContract;
+    readonly compiler: DocumentCompilerIdentity;
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly intent: DocumentIntent;
+    readonly metadataSchema: DocumentAuthorityEvidence;
+    readonly ownerCatalog: DocumentAuthorityEvidence;
+    readonly profile: DocumentPlanningProfileSnapshot;
+    readonly state: DocumentPlanningStateSnapshot;
+    readonly template: DocumentTemplateSnapshot;
+    readonly output: string;
+    readonly profileSemanticDigest?: DocumentAuthorityDigest;
+}
+export {};
+//# sourceMappingURL=document-planning.d.ts.map

package/dist/application/model/document-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning.d.ts","sourceRoot":"","sources":["../../../src/application/model/document-planning.ts"],"names":[],"mappings":"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"}

package/dist/application/model/document-planning.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-planning.js.map

package/dist/application/model/document-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning.js","sourceRoot":"","sources":["../../../src/application/model/document-planning.ts"],"names":[],"mappings":""}

package/dist/application/model/document-receipt.d.ts

@@ -0,0 +1,101 @@
+import type { DocumentAuthorityDigest } from "./document-catalog.js";
+export type DocumentReceiptOutcome = "applied" | "already-applied" | "authority-stale" | "rejected" | "recovery-required" | "manual-recovery-required" | "failed-before-publication" | "cancelled";
+export interface DocumentReceiptDiagnostic {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "apply" | "authority" | "input" | "recovery";
+    readonly subject: string;
+    readonly message: string;
+}
+export interface DocumentCommitObservation {
+    readonly state: "committed" | "not-published" | "recovery-required" | "manual-recovery-required";
+    readonly publication: "none" | "preexisting-exact" | "published" | "unknown";
+    readonly atomicity: "not-applicable" | "single-file-atomic-create";
+    readonly recoverability: "not-required" | "preserved-for-recovery";
+}
+export interface DocumentReceiptBase {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly planDigest: DocumentAuthorityDigest;
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly destination: string;
+    readonly diagnostics: readonly DocumentReceiptDiagnostic[];
+    readonly receiptDigest: DocumentAuthorityDigest;
+}
+export type DocumentReceipt = (DocumentReceiptBase & {
+    readonly outcome: "applied";
+    readonly resultDigest: DocumentAuthorityDigest;
+    readonly commit: {
+        readonly state: "committed";
+        readonly publication: "published";
+        readonly atomicity: "single-file-atomic-create";
+        readonly recoverability: "not-required";
+    };
+}) | (DocumentReceiptBase & {
+    readonly outcome: "already-applied";
+    readonly resultDigest: DocumentAuthorityDigest;
+    readonly commit: {
+        readonly state: "committed";
+        readonly publication: "preexisting-exact";
+        readonly atomicity: "not-applicable";
+        readonly recoverability: "not-required";
+    };
+}) | (DocumentReceiptBase & {
+    readonly outcome: "authority-stale" | "rejected" | "failed-before-publication" | "cancelled";
+    readonly commit: {
+        readonly state: "not-published";
+        readonly publication: "none";
+        readonly atomicity: "not-applicable";
+        readonly recoverability: "not-required";
+    };
+}) | (DocumentReceiptBase & {
+    readonly outcome: "recovery-required";
+    readonly commit: {
+        readonly state: "recovery-required";
+        readonly publication: "none" | "published" | "unknown";
+        readonly atomicity: "not-applicable" | "single-file-atomic-create";
+        readonly recoverability: "preserved-for-recovery";
+    };
+}) | (DocumentReceiptBase & {
+    readonly outcome: "manual-recovery-required";
+    readonly commit: {
+        readonly state: "manual-recovery-required";
+        readonly publication: "none" | "published" | "unknown";
+        readonly atomicity: "not-applicable" | "single-file-atomic-create";
+        readonly recoverability: "preserved-for-recovery";
+    };
+});
+export interface DocumentReceiptV2 {
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly planDigest: DocumentAuthorityDigest;
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly destination: string;
+    readonly outcome: DocumentReceiptOutcome;
+    readonly resultDigest?: DocumentAuthorityDigest;
+    readonly commit: {
+        readonly state: "committed" | "not-published" | "recovery-required" | "manual-recovery-required";
+        readonly publication: "none" | "preexisting-exact" | "published" | "unknown";
+        readonly fileAtomicity: "not-applicable" | "single-file-atomic-create";
+        readonly recoverability: "not-required" | "preserved-for-recovery";
+    };
+    readonly directoryMaterialization: {
+        readonly state: "none-created" | "created-and-retained" | "preserved-unknown";
+        readonly plannedDirectories: readonly string[];
+        readonly observedCreatedDirectories: readonly string[];
+    };
+    readonly diagnostics: readonly DocumentReceiptDiagnostic[];
+    readonly receiptDigest: DocumentAuthorityDigest;
+}
+export type DocumentReceiptV1 = DocumentReceipt;
+export type DocumentReceiptContract = DocumentReceipt | DocumentReceiptV2;
+type WithoutReceiptDigest<T> = T extends unknown ? Omit<T, "receiptDigest"> : never;
+export type DocumentReceiptBody = WithoutReceiptDigest<DocumentReceiptContract>;
+export {};
+//# sourceMappingURL=document-receipt.d.ts.map

package/dist/application/model/document-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-receipt.d.ts","sourceRoot":"","sources":["../../../src/application/model/document-receipt.ts"],"names":[],"mappings":"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"}

package/dist/application/model/document-receipt.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-receipt.js.map

package/dist/application/model/document-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-receipt.js","sourceRoot":"","sources":["../../../src/application/model/document-receipt.ts"],"names":[],"mappings":""}

package/dist/application/model/document-transaction-inspection.d.ts

@@ -0,0 +1,66 @@
+export type DocumentTransactionInspectionDiagnostic = {
+    readonly code: "FOUNDATION_TRANSACTION_ACTIVE";
+    readonly message: string;
+} | {
+    readonly code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED";
+    readonly message: string;
+} | {
+    readonly code: "FOUNDATION_TRANSACTION_VERSION_MISMATCH";
+    readonly message: string;
+};
+export type DocumentTransactionInspectionV1 = {
+    readonly schemaVersion: 1;
+    readonly state: "idle";
+    readonly diagnostics: readonly [];
+} | {
+    readonly schemaVersion: 1;
+    readonly state: "recoverable";
+    readonly operationKind: "document-authoring";
+    readonly format: "document-authoring-envelope-v3";
+    readonly foundationVersion: string;
+    readonly foundationBuildIdentity: string;
+    readonly recovery: {
+        readonly commandId: "docs-recover";
+        readonly exactFoundationVersion: string;
+        readonly exactFoundationBuildIdentity: string;
+    };
+    readonly diagnostics: readonly DocumentTransactionInspectionDiagnostic[];
+} | {
+    readonly schemaVersion: 1;
+    readonly state: "manual-recovery-required";
+    readonly reason: string;
+    readonly operationKind?: "document-authoring" | "local-mode" | "scaffolding";
+    readonly transactionKind?: "corrupt" | "document" | "local-mode" | "scaffold" | "transition-residue" | "unknown" | "version-mismatch";
+    readonly foundationVersion?: string;
+    readonly foundationBuildIdentity?: string;
+    readonly format?: string;
+    readonly recovery?: {
+        readonly commandId: "detach" | "docs-recover" | "scaffold-recover";
+        readonly args: Readonly<Record<string, string>>;
+    };
+    readonly diagnostics: readonly DocumentTransactionInspectionDiagnostic[];
+};
+export type DocumentTransactionInspectionV2 = {
+    readonly schemaVersion: 2;
+    readonly state: "idle";
+    readonly diagnostics: readonly [];
+} | {
+    readonly schemaVersion: 2;
+    readonly state: "recoverable";
+    readonly operationKind: "document-authoring";
+    readonly format: "document-authoring-envelope-v3" | "document-authoring-envelope-v4";
+    readonly foundationVersion: string;
+    readonly foundationBuildIdentity: string;
+    readonly recovery: {
+        readonly commandId: "docs-recover";
+        readonly exactFoundationVersion: string;
+        readonly exactFoundationBuildIdentity: string;
+    };
+    readonly diagnostics: readonly DocumentTransactionInspectionDiagnostic[];
+} | (Omit<Extract<DocumentTransactionInspectionV1, {
+    readonly state: "manual-recovery-required";
+}>, "schemaVersion"> & {
+    readonly schemaVersion: 2;
+});
+export type DocumentTransactionInspection = DocumentTransactionInspectionV1 | DocumentTransactionInspectionV2;
+//# sourceMappingURL=document-transaction-inspection.d.ts.map

package/dist/application/model/document-transaction-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-inspection.d.ts","sourceRoot":"","sources":["../../../src/application/model/document-transaction-inspection.ts"],"names":[],"mappings":"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"}

package/dist/application/model/document-transaction-inspection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-transaction-inspection.js.map

package/dist/application/model/document-transaction-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-inspection.js","sourceRoot":"","sources":["../../../src/application/model/document-transaction-inspection.ts"],"names":[],"mappings":""}

package/dist/application/model/document-transaction.d.ts

@@ -0,0 +1,169 @@
+import type { DocumentAuthorityDigest } from "./document-catalog.js";
+import type { DocumentPhysicalIdentity } from "./document-physical-identity.js";
+import type { DocumentPlanV1, DocumentPlanV2 } from "./document-planning.js";
+import type { DocumentCreatedDirectoryEvidenceV2 } from "./document-parent-materialization.js";
+export interface DocumentOwnedTemporary {
+    readonly path: string;
+    readonly digest: DocumentAuthorityDigest;
+    readonly identity: DocumentPhysicalIdentity;
+}
+export interface DocumentJournalBase {
+    readonly schemaVersion: 2;
+    readonly plan: DocumentPlanV1;
+}
+export type DocumentTransactionJournal = (DocumentJournalBase & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "pending";
+    };
+}) | (DocumentJournalBase & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "preexisting";
+    };
+}) | (DocumentJournalBase & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "publishing";
+    };
+    readonly ownedTemporary: DocumentOwnedTemporary;
+}) | (DocumentJournalBase & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "published";
+    };
+    readonly publicationIdentity: DocumentPhysicalIdentity;
+});
+export interface DocumentTransactionEnvelopeBase {
+    readonly schemaVersion: 3;
+    readonly operationKind: "document-authoring";
+    readonly recoveryHandler: {
+        readonly id: "document-authoring" | "foundation.document-authoring";
+        readonly contractVersion: 2;
+    };
+    readonly foundation: {
+        readonly version: string;
+        readonly buildIdentity: DocumentAuthorityDigest;
+    };
+    readonly adapterContractVersion: 1;
+    readonly payloadKind: "document-authoring-journal/v2";
+    readonly payloadDigest: DocumentAuthorityDigest;
+    readonly envelopeDigest: DocumentAuthorityDigest;
+}
+export type DocumentTransactionEnvelopeV3 = (DocumentTransactionEnvelopeBase & {
+    readonly state: "PREPARED";
+    readonly journal: Extract<DocumentTransactionJournal, {
+        readonly destination: {
+            readonly state: "pending";
+        };
+    }> | Extract<DocumentTransactionJournal, {
+        readonly destination: {
+            readonly state: "preexisting";
+        };
+    }>;
+}) | (DocumentTransactionEnvelopeBase & {
+    readonly state: "PUBLISHING";
+    readonly journal: Extract<DocumentTransactionJournal, {
+        readonly destination: {
+            readonly state: "publishing";
+        };
+    }>;
+}) | (DocumentTransactionEnvelopeBase & {
+    readonly state: "PUBLISHED";
+    readonly journal: Extract<DocumentTransactionJournal, {
+        readonly destination: {
+            readonly state: "published";
+        };
+    }>;
+});
+export interface DocumentTransactionJournalV3Base {
+    readonly schemaVersion: 3;
+    readonly plan: DocumentPlanV2;
+    readonly parentMaterialization: {
+        readonly anchorIdentity: DocumentPhysicalIdentity;
+        readonly createdDirectories: readonly DocumentCreatedDirectoryEvidenceV2[];
+        readonly pendingDirectory?: string;
+    };
+}
+export type DocumentTransactionJournalV3 = (DocumentTransactionJournalV3Base & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "pending";
+    };
+}) | (DocumentTransactionJournalV3Base & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "preexisting";
+    };
+}) | (DocumentTransactionJournalV3Base & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "materializing";
+    };
+}) | (DocumentTransactionJournalV3Base & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "publishing";
+    };
+    readonly ownedTemporary: DocumentOwnedTemporary;
+}) | (DocumentTransactionJournalV3Base & {
+    readonly destination: {
+        readonly path: string;
+        readonly state: "published";
+    };
+    readonly publicationIdentity: DocumentPhysicalIdentity;
+});
+export interface DocumentTransactionEnvelopeV4Base {
+    readonly schemaVersion: 4;
+    readonly operationKind: "document-authoring";
+    readonly recoveryHandler: {
+        readonly id: "document-authoring" | "foundation.document-authoring";
+        readonly contractVersion: 3;
+    };
+    readonly foundation: {
+        readonly version: string;
+        readonly buildIdentity: DocumentAuthorityDigest;
+    };
+    readonly adapterContractVersion: 1;
+    readonly payloadKind: "document-authoring-journal/v3";
+    readonly payloadDigest: DocumentAuthorityDigest;
+    readonly envelopeDigest: DocumentAuthorityDigest;
+}
+export type DocumentTransactionEnvelopeV4 = (DocumentTransactionEnvelopeV4Base & {
+    readonly state: "PREPARED";
+    readonly journal: Extract<DocumentTransactionJournalV3, {
+        readonly destination: {
+            readonly state: "pending";
+        };
+    }> | Extract<DocumentTransactionJournalV3, {
+        readonly destination: {
+            readonly state: "preexisting";
+        };
+    }>;
+}) | (DocumentTransactionEnvelopeV4Base & {
+    readonly state: "MATERIALIZING";
+    readonly journal: Extract<DocumentTransactionJournalV3, {
+        readonly destination: {
+            readonly state: "materializing";
+        };
+    }>;
+}) | (DocumentTransactionEnvelopeV4Base & {
+    readonly state: "PUBLISHING";
+    readonly journal: Extract<DocumentTransactionJournalV3, {
+        readonly destination: {
+            readonly state: "publishing";
+        };
+    }>;
+}) | (DocumentTransactionEnvelopeV4Base & {
+    readonly state: "PUBLISHED";
+    readonly journal: Extract<DocumentTransactionJournalV3, {
+        readonly destination: {
+            readonly state: "published";
+        };
+    }>;
+});
+export type DocumentTransactionEnvelope = DocumentTransactionEnvelopeV3 | DocumentTransactionEnvelopeV4;
+type WithoutEnvelopeDigests<T> = T extends unknown ? Omit<T, "envelopeDigest" | "payloadDigest"> : never;
+export type DocumentTransactionEnvelopeBody = WithoutEnvelopeDigests<DocumentTransactionEnvelope>;
+export {};
+//# sourceMappingURL=document-transaction.d.ts.map

package/dist/application/model/document-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction.d.ts","sourceRoot":"","sources":["../../../src/application/model/document-transaction.ts"],"names":[],"mappings":"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"}

package/dist/application/model/document-transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-transaction.js.map

package/dist/application/model/document-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction.js","sourceRoot":"","sources":["../../../src/application/model/document-transaction.ts"],"names":[],"mappings":""}

package/dist/application/policies/assert-artifact-owner-allowed.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentArtifactType, DocumentIntent } from "../model/document-planning.js";
+export declare function assertArtifactOwnerAllowed(artifact: DocumentArtifactType, intent: DocumentIntent): void;
+//# sourceMappingURL=assert-artifact-owner-allowed.d.ts.map

package/dist/application/policies/assert-artifact-owner-allowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-artifact-owner-allowed.d.ts","sourceRoot":"","sources":["../../../src/application/policies/assert-artifact-owner-allowed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACf,MAAM,+BAA+B,CAAC;AAGvC,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,cAAc,GACrB,IAAI,CAUN"}

package/dist/application/policies/assert-artifact-owner-allowed.js

@@ -0,0 +1,8 @@
+import { DocumentPlanningError } from "../../document-planning-error.js";
+export function assertArtifactOwnerAllowed(artifact, intent) {
+    if (artifact.allowedOwnerIds !== undefined &&
+        !artifact.allowedOwnerIds.includes(intent.owner)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", `Document owner ${intent.owner} is not allowed for artifact type ${artifact.type}.`);
+    }
+}
+//# sourceMappingURL=assert-artifact-owner-allowed.js.map

package/dist/application/policies/assert-artifact-owner-allowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-artifact-owner-allowed.js","sourceRoot":"","sources":["../../../src/application/policies/assert-artifact-owner-allowed.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,MAAM,UAAU,0BAA0B,CACxC,QAA8B,EAC9B,MAAsB;IAEtB,IACE,QAAQ,CAAC,eAAe,KAAK,SAAS;QACtC,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAChD,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,iCAAiC,EACjC,kBAAkB,MAAM,CAAC,KAAK,qCAAqC,QAAQ,CAAC,IAAI,GAAG,CACpF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/application/policies/assert-v2-planning-profile.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentPlanningProfileSnapshot } from "../model/document-planning.js";
+export declare function assertV2PlanningProfile(profile: DocumentPlanningProfileSnapshot, requestedPolicy: "create-missing-real-directories" | undefined): void;
+//# sourceMappingURL=assert-v2-planning-profile.d.ts.map

package/dist/application/policies/assert-v2-planning-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-v2-planning-profile.d.ts","sourceRoot":"","sources":["../../../src/application/policies/assert-v2-planning-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAGrF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,+BAA+B,EACxC,eAAe,EAAE,iCAAiC,GAAG,SAAS,GAC7D,IAAI,CAON"}