semantifold 0.9.0 → 0.10.0

package/build/src/publication.d.ts

@@ -1,4 +1,13 @@
 import path from "node:path";
+/**
+ * Queues one internal caller-owned currentness guard for the publisher's next transaction.
+ * The guard runs after every validator closes and immediately before the active-pointer commit.
+ * This helper is intentionally not part of the package root API.
+ * @param {GeneratedArtifactPublisher} publisher - Publisher instance.
+ * @param {() => Promise<void> | void} guard - Exact pre-commit guard.
+ * @returns {void}
+ */
+export declare function guardNextPublicationCommit(publisher: GeneratedArtifactPublisher, guard: () => Promise<void> | void): void;
 /**
  * Installs one internal, one-shot deterministic failure used by real-filesystem interruption specs.
  * This helper is intentionally not part of the package root API.
@@ -27,21 +36,24 @@ export declare class GeneratedArtifactPublisher {
      * @param {string} options.projectId - Stable lowercase project identity.
      * @param {string} options.projectRoot - Canonical absolute project root.
      * @param {string} options.publicationRoot - Canonical absolute publisher-owned directory beneath the project root.
-     * @param {readonly string[]} options.sourceRoots - Canonical absolute project source roots kept disjoint from publication.
+     * @param {readonly string[]} [options.sourceRoots] - Canonical absolute project source directories kept disjoint from publication.
+     * @param {readonly string[]} [options.sourceFiles] - Canonical absolute project source files kept disjoint from publication.
      */
     constructor(options: {
         projectId: string;
         projectRoot: string;
         publicationRoot: string;
-        sourceRoots: readonly string[];
+        sourceRoots?: readonly string[];
+        sourceFiles?: readonly string[];
     });
     /**
      * Stages, validates, and publishes one complete immutable project generation.
      * Calls on one publisher instance are serialized in invocation order.
      * @param {import("./semantic/types.js").PublicationRequest} request - Complete publication request.
+     * @param {import("./semantic/types.js").PublicationOptions} [options] - Transaction lifecycle controls.
      * @returns {Promise<import("./semantic/types.js").PublishedGeneration>} Committed immutable snapshot.
      */
-    publish(request: import("./semantic/types.js").PublicationRequest): Promise<import("./semantic/types.js").PublishedGeneration>;
+    publish(request: import("./semantic/types.js").PublicationRequest, options?: import("./semantic/types.js").PublicationOptions): Promise<import("./semantic/types.js").PublishedGeneration>;
     /**
      * Resolves the active pointer exactly once and verifies the referenced immutable generation.
      * @returns {Promise<import("./semantic/types.js").PublishedGeneration>} Verified pointer-once snapshot.
@@ -82,6 +94,16 @@ export type ValidatedPublicationTarget = {
      */
     validators: readonly import("./semantic/types.js").PublicationValidator[];
 };
+export type ValidatedPublicationRequest = {
+    /**
+     * - Snapshotted generation identity.
+     */
+    generationId: string;
+    /**
+     * - Snapshotted ordered targets.
+     */
+    targets: readonly ValidatedPublicationTarget[];
+};
 export type ActivePointer = {
     /**
      * - Schema discriminator.
@@ -104,7 +126,7 @@ export type ActivePointer = {
      */
     manifestHash: string;
 };
-export type PublicationJournal = {
+export type CandidatePublicationJournal = {
     /**
      * - Schema discriminator.
      */
@@ -126,6 +148,33 @@ export type PublicationJournal = {
      */
     tempPointer: string;
 };
+export type ReactivationPublicationJournal = {
+    /**
+     * - Schema discriminator.
+     */
+    schema: "SemantifoldPublicationJournal";
+    /**
+     * - Schema version.
+     */
+    version: 2;
+    /**
+     * - Retained-generation activation without candidate ownership.
+     */
+    operation: "reactivate";
+    /**
+     * - Project identity.
+     */
+    projectId: string;
+    /**
+     * - Retained generation identity.
+     */
+    generationId: string;
+    /**
+     * - Owned sibling temporary-pointer filename.
+     */
+    tempPointer: string;
+};
+export type PublicationJournal = CandidatePublicationJournal | ReactivationPublicationJournal;
 /**
  * @typedef ValidatedPublicationTarget
  * @property {string} id - Target identity.
@@ -135,6 +184,11 @@ export type PublicationJournal = {
  * @property {import("./semantic/types.js").PublicationTargetRole} role - Language-neutral target role.
  * @property {readonly import("./semantic/types.js").PublicationValidator[]} validators - Ordered validators.
  */
+/**
+ * @typedef ValidatedPublicationRequest
+ * @property {string} generationId - Snapshotted generation identity.
+ * @property {readonly ValidatedPublicationTarget[]} targets - Snapshotted ordered targets.
+ */
 /**
  * @typedef ActivePointer
  * @property {"SemantifoldActiveGeneration"} schema - Schema discriminator.
@@ -144,11 +198,21 @@ export type PublicationJournal = {
  * @property {string} manifestHash - SHA-256 generation-manifest hash.
  */
 /**
- * @typedef PublicationJournal
+ * @typedef CandidatePublicationJournal
  * @property {"SemantifoldPublicationJournal"} schema - Schema discriminator.
  * @property {1} version - Schema version.
  * @property {string} projectId - Project identity.
  * @property {string} generationId - Candidate generation identity.
  * @property {string} tempPointer - Owned sibling temporary-pointer filename.
  */
+/**
+ * @typedef ReactivationPublicationJournal
+ * @property {"SemantifoldPublicationJournal"} schema - Schema discriminator.
+ * @property {2} version - Schema version.
+ * @property {"reactivate"} operation - Retained-generation activation without candidate ownership.
+ * @property {string} projectId - Project identity.
+ * @property {string} generationId - Retained generation identity.
+ * @property {string} tempPointer - Owned sibling temporary-pointer filename.
+ */
+/** @typedef {CandidatePublicationJournal | ReactivationPublicationJournal} PublicationJournal */
 //# sourceMappingURL=publication.d.ts.map

package/build/src/publication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../src/publication.js"],"names":[],"mappings":"AAKA,OAAO,IAAI,MAAM,WAAW,CAAA;AA2B5B;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EALvC,0BAKuC,EAAE,QAAQ,EAJjD,aAAa,GAAG,wBAAwB,GAAG,uBAAuB,GAAG,gBAAgB,GAAG,uBAIvC,EAAE,KAAK,EAHxD,KAGwD,GAFtD,IAAI,CAOhB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAJ3C,0BAI2C,EAAE,QAAQ,EAHrD,CAAC,SAAS,EAAE,MAAM,KAAK,IAG8B,GAFnD,IAAI,CAOhB;AAED;;GAEG;AACH,qBAAa,0BAA0B;;IAYrC;;;;;;;OAOG;IACH,YAAY,OAAO,EALhB;QAAwB,SAAS,EAAzB,MAAM,CACd;QAAwB,WAAW,EAA3B,MAAM,CACd;QAAwB,eAAe,EAA/B,MAAM,CACd;QAAmC,WAAW,EAAtC,SAAS,MAAM,EAAE,CAC3B;KACkB,EA0ClB;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAHJ,OAAO,qBAAqB,EAAE,kBAG1B,GAFF,OAAO,CAAC,OAAO,qBAAqB,EAAE,mBAAmB,CAAC,CAsBtE;IAED;;;OAGG;IACG,aAAa,IAFN,OAAO,CAAC,OAAO,qBAAqB,EAAE,mBAAmB,CAAC,CAYtE;CA8KF;AAowCD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAJzC,OAIyC,EAAE,QAAQ,EAHnD,OAAO,IAAI,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,KAGmB,GAFjD,KAAK,IAAI,MAAM,CAQ3B;AA2LE,YAAS,0BAA0B,GACnC;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAA+D,WAAW,EAA/D,OAAO,qBAAqB,EAAE,oBAAoB,CAC7D;;;;IAAmB,gBAAgB,EAAxB,MAAM,CACjB;;;;IAAmB,eAAe,EAAvB,MAAM,CACjB;;;;IAAgE,IAAI,EAAzD,OAAO,qBAAqB,EAAE,qBAAqB,CAC9D;;;;IAA0E,UAAU,EAAzE,SAAS,OAAO,qBAAqB,EAAE,oBAAoB,EAAE,CAC1E;CAAA,CAAA;AAGE,YAAS,aAAa,GACtB;;;;IAA0C,MAAM,EAArC,6BAA6B,CACxC;;;;IAAc,OAAO,EAAV,CAAC,CACZ;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACnB;CAAA,CAAA;AAGE,YAAS,kBAAkB,GAC3B;;;;IAA4C,MAAM,EAAvC,+BAA+B,CAC1C;;;;IAAc,OAAO,EAAV,CAAC,CACZ;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,YAAY,EAApB,MAAM,CACjB;;;;IAAmB,WAAW,EAAnB,MAAM,CACnB;CAAA,CAAA;AA1BD;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG"}
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../src/publication.js"],"names":[],"mappings":"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"}