@ductape/sdk 0.3.6 → 0.3.8

package/dist/context/execution-context.d.ts

@@ -20,6 +20,8 @@ export interface DuctapeAssetSpan {
     error_message?: string;
 }
 export interface DuctapeExecutionContext {
+    /** Probe internals are represented by one healthcheck observation, not API logs. */
+    healthcheck_probe?: boolean;
     workspace_id?: string;
     product_id?: string;
     product_tag?: string;

package/dist/context/execution-context.js

@@ -33,7 +33,7 @@ function runWithExecutionContext(context, fn) {
 function executionContextFields(context = currentExecutionContext()) {
     if (!context)
         return {};
-    const { session: _secretSession, baggage: _baggage, asset_span_sink: _assetSpanSink, kind: execution_kind } = context, fields = __rest(context, ["session", "baggage", "asset_span_sink", "kind"]);
+    const { session: _secretSession, baggage: _baggage, asset_span_sink: _assetSpanSink, healthcheck_probe: _healthcheckProbe, kind: execution_kind } = context, fields = __rest(context, ["session", "baggage", "asset_span_sink", "healthcheck_probe", "kind"]);
     return Object.assign(Object.assign({}, fields), { execution_kind });
 }
 async function withAssetSpan(asset, fn) {

package/dist/context/execution-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":"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"}

package/dist/features/features.service.d.ts

@@ -24,6 +24,20 @@ export declare class FeatureError extends Error {
  * Main Feature Service class
  * Provides unified interface for feature management and execution
  */
+export interface FeaturePublicationReceipt {
+    tag: string;
+    operation?: 'create' | 'update';
+    write: 'not_attempted' | 'unknown' | 'acknowledged';
+    verified: boolean;
+    compensation: 'not_needed' | 'retained' | 'unknown' | 'restored';
+}
+export declare class FeaturePublicationError extends Error {
+    readonly product: string;
+    readonly receipts: FeaturePublicationReceipt[];
+    readonly cause: unknown;
+    readonly code = "FEATURE_PUBLICATION_FAILED";
+    constructor(message: string, product: string, receipts: FeaturePublicationReceipt[], cause: unknown);
+}
 export declare class FeatureService {
     /** Service configuration */
     private config;
@@ -31,6 +45,8 @@ export declare class FeatureService {
     private productBuilders;
     /** Local feature configurations */
     private localConfigs;
+    private localKey;
+    private localFeatures;
     /** Feature API service for backend communication */
     private featureApiService;
     /** LogService instance for logging operations */
@@ -207,8 +223,9 @@ export declare class FeatureService {
     /** Compile several definitions without performing any remote writes. */
     compileMany(definitions: IDefineFeatureOptions<any, any>[]): Promise<IProductFeature[]>;
     /**
-     * Publish a definition set with read-back verification. If a write fails, newly
-     * created records are removed and pre-existing records are restored.
+     * Publish with content verification and best-effort restoration of existing records.
+     * New records are retained. Failures expose per-feature receipts on the error;
+     * this is not an atomic transaction, and rejected writes may have persisted.
      */
     publishMany(productTag: string, definitions: IDefineFeatureOptions<any, any>[], options?: {
         dryRun?: boolean;
@@ -216,6 +233,7 @@ export declare class FeatureService {
         product: string;
         dry_run: boolean;
         features: IProductFeature[];
+        receipts: FeaturePublicationReceipt[];
     }>;
     /**
      * Execute a feature

package/dist/features/features.service.js

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.featureService = exports.FeatureCompilationError = exports.FeatureService = exports.FeatureError = void 0;
+exports.featureService = exports.FeatureCompilationError = exports.FeatureService = exports.FeaturePublicationError = exports.FeatureError = void 0;
 const crypto_1 = require("crypto");
 const feature_control_flow_validator_1 = require("./feature-control-flow.validator");
 const functions_1 = require("../functions");
@@ -110,11 +110,26 @@ class FeatureError extends Error {
     }
 }
 exports.FeatureError = FeatureError;
-/**
- * Main Feature Service class
- * Provides unified interface for feature management and execution
- */
+class FeaturePublicationError extends Error {
+    constructor(message, product, receipts, cause) {
+        super(message);
+        this.product = product;
+        this.receipts = receipts;
+        this.cause = cause;
+        this.code = 'FEATURE_PUBLICATION_FAILED';
+        this.name = 'FeaturePublicationError';
+    }
+}
+exports.FeaturePublicationError = FeaturePublicationError;
 class FeatureService {
+    localKey(tag, product) {
+        return JSON.stringify([product !== null && product !== void 0 ? product : null, tag]);
+    }
+    localFeatures(product) {
+        return [...this.localConfigs.entries()]
+            .filter(([key]) => JSON.parse(key)[0] === (product !== null && product !== void 0 ? product : null))
+            .map(([, feature]) => feature);
+    }
     /**
      * Create a new FeatureService instance
      * @param config - Optional configuration for authentication and workspace context
@@ -443,7 +458,7 @@ class FeatureService {
             options: featureData.options,
             envs: featureData.envs,
         };
-        this.localConfigs.set(featureData.tag, localConfig);
+        this.localConfigs.set(this.localKey(featureData.tag, productTag), localConfig);
         console.log('[FeatureService] create SUCCESS', { productTag, tag: featureData.tag });
         return persisted;
     }
@@ -468,7 +483,7 @@ class FeatureService {
         if (!productTag) {
             const localCount = this.localConfigs.size;
             console.log('[FeatureService] fetchAll no productTag, returning local configs', { count: localCount });
-            return Array.from(this.localConfigs.values());
+            return this.localFeatures();
         }
         // Fetch from API using ProductBuilder
         try {
@@ -483,7 +498,7 @@ class FeatureService {
         catch (error) {
             // Fall back to local configs if API fails
             console.log('[FeatureService] fetchAll API failed, falling back to local', { productTag, error: (_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error });
-            return Array.from(this.localConfigs.values());
+            return this.localFeatures(productTag);
         }
     }
     /**
@@ -507,7 +522,7 @@ class FeatureService {
                 if (feature) {
                     const config = this.productFeatureToConfig(feature);
                     // Update local cache
-                    this.localConfigs.set(featureTag, config);
+                    this.localConfigs.set(this.localKey(featureTag, productTag), config);
                     console.log('[FeatureService] fetch SUCCESS from API', { featureTag, productTag, stepsCount: (_a = config.steps) === null || _a === void 0 ? void 0 : _a.length });
                     return config;
                 }
@@ -517,10 +532,10 @@ class FeatureService {
             catch (error) {
                 // Fall back to local config
                 console.log('[FeatureService] fetch API failed, trying local', { featureTag, productTag, error: (_b = error === null || error === void 0 ? void 0 : error.message) !== null && _b !== void 0 ? _b : error });
-                return this.localConfigs.get(featureTag) || null;
+                return this.localConfigs.get(this.localKey(featureTag, productTag)) || null;
             }
         }
-        const local = this.localConfigs.get(featureTag) || null;
+        const local = this.localConfigs.get(this.localKey(featureTag)) || null;
         console.log('[FeatureService] fetch from local only', { featureTag, found: !!local });
         return local;
     }
@@ -542,10 +557,10 @@ class FeatureService {
         const builder = await this.getProductBuilder(productTag);
         await builder.updateFeature(featureTag, updates);
         // Update local cache
-        const existing = this.localConfigs.get(featureTag);
+        const existing = this.localConfigs.get(this.localKey(featureTag, productTag));
         if (existing) {
             const updated = Object.assign(Object.assign({}, existing), { name: updates.name || existing.name, description: (_a = updates.description) !== null && _a !== void 0 ? _a : existing.description, input: (_b = updates.input) !== null && _b !== void 0 ? _b : existing.input, output: (_c = updates.output) !== null && _c !== void 0 ? _c : existing.output, steps: updates.steps || existing.steps, signals: (_d = updates.signals) !== null && _d !== void 0 ? _d : existing.signals, queries: (_e = updates.queries) !== null && _e !== void 0 ? _e : existing.queries, options: (_f = updates.options) !== null && _f !== void 0 ? _f : existing.options, envs: (_g = updates.envs) !== null && _g !== void 0 ? _g : existing.envs });
-            this.localConfigs.set(featureTag, updated);
+            this.localConfigs.set(this.localKey(featureTag, productTag), updated);
         }
         console.log('[FeatureService] update SUCCESS', { featureTag, productTag });
     }
@@ -563,7 +578,7 @@ class FeatureService {
         const builder = await this.getProductBuilder(productTag);
         await builder.deleteFeature(featureTag);
         // Remove from local cache
-        this.localConfigs.delete(featureTag);
+        this.localConfigs.delete(this.localKey(featureTag, productTag));
         console.log('[FeatureService] delete SUCCESS', { featureTag, productTag });
     }
     // ==================== CODE-FIRST API ====================
@@ -679,7 +694,7 @@ class FeatureService {
             options: schema.options,
             envs: schema.envs,
         };
-        this.localConfigs.set(schema.tag, localConfig);
+        this.localConfigs.set(this.localKey(schema.tag, options.product), localConfig);
         console.log('[FeatureService] define SUCCESS', { tag: options.tag, product: options.product });
         // Return the defined feature with compile method
         return {
@@ -699,34 +714,50 @@ class FeatureService {
         return Promise.all(definitions.map((definition) => new FeatureCompiler(definition).compileAsync()));
     }
     /**
-     * Publish a definition set with read-back verification. If a write fails, newly
-     * created records are removed and pre-existing records are restored.
+     * Publish with content verification and best-effort restoration of existing records.
+     * New records are retained. Failures expose per-feature receipts on the error;
+     * this is not an atomic transaction, and rejected writes may have persisted.
      */
     async publishMany(productTag, definitions, options = {}) {
         const schemas = await this.compileMany(definitions);
+        const receipts = schemas.map(schema => ({
+            tag: schema.tag, write: 'not_attempted', verified: false, compensation: 'not_needed',
+        }));
         if (options.dryRun)
-            return { product: productTag, dry_run: true, features: schemas };
+            return { product: productTag, dry_run: true, features: schemas, receipts };
         const builder = await this.getProductBuilder(productTag);
         const previous = new Map();
         const changed = [];
         try {
-            for (const schema of schemas) {
+            for (const [index, schema] of schemas.entries()) {
+                const receipt = receipts[index];
                 const existing = await builder.fetchFeature(schema.tag);
                 previous.set(schema.tag, existing);
+                receipt.operation = existing ? 'update' : 'create';
+                receipt.write = 'unknown';
+                receipt.compensation = existing ? 'not_needed' : 'retained';
+                changed.push(schema.tag);
                 if (existing)
                     await builder.updateFeature(schema.tag, schema);
                 else
                     await builder.createFeature(schema, true);
+                receipt.write = 'acknowledged';
                 const readBack = await builder.fetchFeature(schema.tag);
                 if (!readBack)
                     throw new Error(`Feature ${schema.tag} is missing after publish`);
-                changed.push(schema.tag);
+                if (this.computeFeatureFingerprint(readBack) !== this.computeFeatureFingerprint(schema)) {
+                    throw new Error(`Feature ${schema.tag} content differs after publish`);
+                }
+                receipt.verified = true;
+                this.localConfigs.set(this.localKey(schema.tag, productTag), this.productFeatureToConfig(readBack));
             }
-            return { product: productTag, dry_run: false, features: schemas };
+            return { product: productTag, dry_run: false, features: schemas, receipts };
         }
         catch (error) {
             for (const tag of changed.reverse()) {
                 const old = previous.get(tag);
+                const receipt = receipts.find(item => item.tag === tag);
+                this.localConfigs.delete(this.localKey(tag, productTag));
                 try {
                     // Restore definitions that existed before this publication attempt.
                     // Never delete a newly created definition as compensation: a
@@ -734,14 +765,22 @@ class FeatureService {
                     // the write is durable. Automatically tombstoning that record turns
                     // an observation failure into data loss and caused entire feature
                     // catalogues to disappear after repeated retries.
-                    if (old)
+                    if (old) {
+                        receipt.compensation = 'unknown';
                         await builder.updateFeature(tag, old);
+                        const restored = await builder.fetchFeature(tag);
+                        if (!restored || this.computeFeatureFingerprint(restored) !== this.computeFeatureFingerprint(old)) {
+                            throw new Error(`Feature ${tag} restoration could not be verified`);
+                        }
+                        receipt.compensation = 'restored';
+                        this.localConfigs.set(this.localKey(tag, productTag), this.productFeatureToConfig(restored));
+                    }
                 }
                 catch (rollbackError) {
                     console.error('[Ductape] Feature batch rollback failed', { product: productTag, tag, rollbackError });
                 }
             }
-            throw error;
+            throw new FeaturePublicationError(error instanceof Error ? error.message : String(error), productTag, receipts, error);
         }
     }
     // ==================== WORKFLOW EXECUTION ====================
@@ -779,7 +818,7 @@ class FeatureService {
         // Prefer locally cached feature (from a recent define()) so step conditions and full schema are preserved
         const builder = await this.getProductBuilder(options.product);
         console.log('[FeatureService] execute fetching feature', { tag: options.tag, product: options.product });
-        const localConfig = this.localConfigs.get(options.tag);
+        const localConfig = this.localConfigs.get(this.localKey(options.tag, options.product));
         let feature = localConfig
             ? Object.assign(Object.assign({}, localConfig), { tag: localConfig.tag, name: localConfig.name, steps: localConfig.steps }) : null;
         if (feature) {