@futdevpro/nts-dynamo 1.15.264 → 1.15.266

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LifecycleCleanup_MongoStore = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_util_1 = require("node:util");
+const lifecycle_cleanup_state_type_enum_1 = require("./_enums/lifecycle-cleanup-state.type-enum");
+const DYNTS_LIFECYCLE_CLEANUP_COLLECTION = 'dynts_lifecycle_cleanup_runs';
+const dynts_hashPattern = /^[a-f0-9]{64}$/u;
+const dynts_identifierPattern = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/u;
+/** Durable Mongo gate, lease and progress store for explicitly invoked lifecycle cleanup. */
+class DyNTS_LifecycleCleanup_MongoStore {
+    connection;
+    maxOperationTimeMs;
+    leaseDurationMs;
+    readiness;
+    /** Uses one product connection so gate transitions and product mutations can share a transaction. */
+    constructor(settings) {
+        if (!settings?.connection
+            || !Number.isSafeInteger(settings.maxOperationTimeMs)
+            || settings.maxOperationTimeMs < 1
+            || settings.maxOperationTimeMs > 60_000
+            || !Number.isSafeInteger(settings.leaseDurationMs)
+            || settings.leaseDurationMs < 1_000
+            || settings.leaseDurationMs > 300_000) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|INVALID_SETTINGS');
+        }
+        this.connection = settings.connection;
+        this.maxOperationTimeMs = settings.maxOperationTimeMs;
+        this.leaseDurationMs = settings.leaseDurationMs;
+    }
+    /** Creates and verifies the strict content-free progress collection before product transactions begin. */
+    async ensureReady() {
+        this.readiness ??= (async () => {
+            await this.connection.db.createCollection(DYNTS_LIFECYCLE_CLEANUP_COLLECTION, {
+                validator: this.validator(),
+                validationLevel: 'strict',
+                validationAction: 'error',
+                maxTimeMS: this.maxOperationTimeMs,
+            }).catch((error) => {
+                if (!this.isMongoCode(error, 48)) {
+                    throw error;
+                }
+            });
+            const collection = await this.connection.db.listCollections({ name: DYNTS_LIFECYCLE_CLEANUP_COLLECTION }, { nameOnly: false, maxTimeMS: this.maxOperationTimeMs }).next();
+            if (!(0, node_util_1.isDeepStrictEqual)(collection?.options?.validator, this.validator())
+                || collection?.options?.validationLevel !== 'strict'
+                || collection?.options?.validationAction !== 'error') {
+                throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|SCHEMA_MIGRATION_REQUIRED');
+            }
+        })().catch((error) => {
+            this.readiness = undefined;
+            if (error instanceof Error
+                && error.message === 'DyNTS|LIFECYCLE_CLEANUP_STORE|SCHEMA_MIGRATION_REQUIRED') {
+                throw error;
+            }
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|NOT_READY', { cause: error });
+        });
+        await this.readiness;
+    }
+    /** Inserts the immutable plan/deadline gate or acknowledges its exact replay. */
+    async schedule(value, session) {
+        this.request(value, ['scopeHash', 'cleanupId', 'planChecksum', 'stageCount', 'eligibleAtMs']);
+        this.transaction(session);
+        const key = this.key(value);
+        const previous = await this.collection().findOne({ _id: key }, { session: session, maxTimeMS: this.maxOperationTimeMs });
+        if (previous) {
+            this.assertExact(previous, value);
+            if (previous.eligibleAtMs !== value.eligibleAtMs) {
+                throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|SCHEDULE_CONFLICT');
+            }
+            return this.scheduleReceipt(previous, false);
+        }
+        const initial = {
+            _id: key,
+            contractVersion: 'dynts-lifecycle-cleanup-store/1',
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: value.planChecksum,
+            stageCount: value.stageCount,
+            eligibleAtMs: value.eligibleAtMs,
+            state: lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.scheduled,
+            stageIndex: 0,
+            fencingToken: 0,
+            lockId: '',
+            leaseExpiresAtMs: 0,
+            evaluatedAtMs: 0,
+            selectedRecordCount: 0,
+            deletedRecordCount: 0,
+            lastResultChecksum: '',
+            scheduledAtMs: 0,
+            updatedAtMs: 0,
+            completedAtMs: 0,
+        };
+        await this.collection().insertOne(initial, { session: session, maxTimeMS: this.maxOperationTimeMs });
+        const written = await this.collection().findOneAndUpdate({ _id: key, scheduledAtMs: 0 }, [{ $set: {
+                    scheduledAtMs: { $convert: { input: '$$NOW', to: 'double' } },
+                    updatedAtMs: { $convert: { input: '$$NOW', to: 'double' } },
+                } }], {
+            session: session,
+            maxTimeMS: this.maxOperationTimeMs,
+            returnDocument: 'after',
+            includeResultMetadata: false,
+        });
+        return this.scheduleReceipt(this.document(written), true);
+    }
+    /** Deletes only a scheduled gate; an acquired or completed cleanup makes restore fail closed. */
+    async cancel(value, session) {
+        this.request(value, ['scopeHash', 'cleanupId', 'planChecksum', 'stageCount']);
+        this.transaction(session);
+        const key = this.key(value);
+        const result = await this.collection().deleteOne({
+            _id: key,
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: value.planChecksum,
+            stageCount: value.stageCount,
+            state: lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.scheduled,
+        }, { session: session, maxTimeMS: this.maxOperationTimeMs });
+        if (result.deletedCount === 1) {
+            return Object.freeze({
+                contractVersion: 'dynts-lifecycle-cleanup-cancellation-receipt/1',
+                scopeHash: value.scopeHash,
+                cleanupId: value.cleanupId,
+                wasDeleted: true,
+            });
+        }
+        const current = await this.collection().findOne({ _id: key }, { session: session, maxTimeMS: this.maxOperationTimeMs });
+        if (current) {
+            this.assertExact(current, value);
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|RESTORE_FORBIDDEN');
+        }
+        return Object.freeze({
+            contractVersion: 'dynts-lifecycle-cleanup-cancellation-receipt/1',
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            wasDeleted: false,
+        });
+    }
+    /** Acquires one DB-time lease or reports not-due, busy or terminal state without waiting. */
+    async claim(value) {
+        this.request(value, ['scopeHash', 'cleanupId', 'planChecksum', 'stageCount']);
+        const key = this.key(value);
+        const lockId = (0, node_crypto_1.randomUUID)();
+        const claimed = await this.collection().findOneAndUpdate({
+            _id: key,
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: value.planChecksum,
+            stageCount: value.stageCount,
+            state: { $in: [
+                    lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.scheduled,
+                    lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.active,
+                ] },
+            $expr: { $and: [
+                    { $lte: ['$eligibleAtMs', { $convert: { input: '$$NOW', to: 'double' } }] },
+                    { $lte: ['$leaseExpiresAtMs', { $convert: { input: '$$NOW', to: 'double' } }] },
+                ] },
+        }, [{ $set: {
+                    state: lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.active,
+                    lockId: { $literal: lockId },
+                    fencingToken: { $add: ['$fencingToken', 1] },
+                    evaluatedAtMs: { $convert: { input: '$$NOW', to: 'double' } },
+                    leaseExpiresAtMs: { $add: [
+                            { $convert: { input: '$$NOW', to: 'double' } },
+                            this.leaseDurationMs,
+                        ] },
+                    updatedAtMs: { $convert: { input: '$$NOW', to: 'double' } },
+                } }], {
+            maxTimeMS: this.maxOperationTimeMs,
+            returnDocument: 'after',
+            includeResultMetadata: false,
+        });
+        if (claimed) {
+            return this.claimReceipt(this.document(claimed), lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.executed);
+        }
+        const current = await this.collection().findOne({ _id: key }, { maxTimeMS: this.maxOperationTimeMs });
+        if (!current) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|NOT_SCHEDULED');
+        }
+        this.assertExact(current, value);
+        if (current.state === lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.complete) {
+            return this.claimReceipt(current, lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.complete);
+        }
+        return this.claimReceipt(current, current.state === lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.scheduled
+            ? lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.notDue
+            : lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.busy);
+    }
+    /** Commits callback mutations and progress together, guarded by stage and fencing token. */
+    async commit(value, session) {
+        this.commitRequest(value);
+        this.transaction(session);
+        const advances = value.result.isComplete;
+        const completes = advances && value.stageIndex + 1 === value.stageCount;
+        const committed = await this.collection().findOneAndUpdate({
+            _id: this.key(value),
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: value.planChecksum,
+            stageCount: value.stageCount,
+            state: lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.active,
+            stageIndex: value.stageIndex,
+            fencingToken: value.fencingToken,
+            $expr: { $gt: [
+                    '$leaseExpiresAtMs',
+                    { $convert: { input: '$$NOW', to: 'double' } },
+                ] },
+        }, [{ $set: {
+                    state: completes
+                        ? lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.complete
+                        : lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type.active,
+                    stageIndex: advances ? value.stageIndex + 1 : value.stageIndex,
+                    lockId: '',
+                    leaseExpiresAtMs: 0,
+                    selectedRecordCount: { $add: ['$selectedRecordCount', value.result.selectedRecordCount] },
+                    deletedRecordCount: { $add: ['$deletedRecordCount', value.result.deletedRecordCount] },
+                    lastResultChecksum: { $literal: value.result.resultChecksum },
+                    updatedAtMs: { $convert: { input: '$$NOW', to: 'double' } },
+                    completedAtMs: completes ? { $convert: { input: '$$NOW', to: 'double' } } : 0,
+                } }], {
+            session: session,
+            maxTimeMS: this.maxOperationTimeMs,
+            returnDocument: 'after',
+            includeResultMetadata: false,
+        });
+        if (!committed) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|FENCE_LOST');
+        }
+        return this.claimReceipt(this.document(committed), completes
+            ? lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.complete
+            : lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupInvocationCode_Type.executed);
+    }
+    collection() {
+        return this.connection.db.collection(DYNTS_LIFECYCLE_CLEANUP_COLLECTION);
+    }
+    key(value) {
+        return `${value.scopeHash}:${value.cleanupId}`;
+    }
+    request(value, expectedKeys) {
+        if (!this.exactRecord(value, expectedKeys)
+            || !dynts_hashPattern.test(value?.scopeHash)
+            || !dynts_hashPattern.test(value?.cleanupId)
+            || !dynts_hashPattern.test(value?.planChecksum)
+            || !Number.isSafeInteger(value?.stageCount)
+            || value.stageCount < 1
+            || value.stageCount > 128) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|INVALID_REQUEST');
+        }
+    }
+    commitRequest(value) {
+        this.request(value, [
+            'scopeHash', 'cleanupId', 'planChecksum', 'stageCount', 'stageIndex', 'fencingToken', 'result',
+        ]);
+        if (!Number.isSafeInteger(value?.stageIndex)
+            || value.stageIndex < 0
+            || value.stageIndex >= value.stageCount
+            || !Number.isSafeInteger(value.fencingToken)
+            || value.fencingToken < 1
+            || value.result?.contractVersion !== 'dynts-lifecycle-cleanup-stage-result/1'
+            || !this.exactRecord(value.result, [
+                'contractVersion', 'stage', 'isComplete', 'selectedRecordCount', 'deletedRecordCount', 'resultChecksum',
+            ])
+            || !dynts_identifierPattern.test(value.result.stage)
+            || typeof value.result.isComplete !== 'boolean'
+            || !Number.isSafeInteger(value.result.selectedRecordCount)
+            || value.result.selectedRecordCount < 0
+            || !Number.isSafeInteger(value.result.deletedRecordCount)
+            || value.result.deletedRecordCount < 0
+            || value.result.deletedRecordCount > value.result.selectedRecordCount
+            || !dynts_hashPattern.test(value.result.resultChecksum)) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|INVALID_COMMIT');
+        }
+    }
+    exactRecord(value, expectedKeys) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return false;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        const keys = Reflect.ownKeys(value);
+        return (prototype === Object.prototype || prototype === null)
+            && keys.length === expectedKeys.length
+            && keys.every((key) => {
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                return typeof key === 'string'
+                    && expectedKeys.includes(key)
+                    && !!descriptor
+                    && 'value' in descriptor
+                    && descriptor.enumerable === true;
+            });
+    }
+    transaction(session) {
+        if (!session?.inTransaction()) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|TRANSACTION_REQUIRED');
+        }
+    }
+    assertExact(value, request) {
+        const document = this.document(value);
+        if (document.scopeHash !== request.scopeHash
+            || document.cleanupId !== request.cleanupId
+            || document.planChecksum !== request.planChecksum
+            || document.stageCount !== request.stageCount) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|IDENTITY_CONFLICT');
+        }
+    }
+    document(value) {
+        if (!value) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|INVALID_DOCUMENT');
+        }
+        if (value.contractVersion !== 'dynts-lifecycle-cleanup-store/1'
+            || !dynts_hashPattern.test(value.scopeHash)
+            || !dynts_hashPattern.test(value.cleanupId)
+            || !dynts_hashPattern.test(value.planChecksum)
+            || !Number.isSafeInteger(value.stageCount)
+            || value.stageCount < 1
+            || value.stageCount > 128
+            || !Number.isSafeInteger(value.eligibleAtMs)
+            || value.eligibleAtMs < 0
+            || !Object.values(lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type).includes(value.state)
+            || !Number.isSafeInteger(value.stageIndex)
+            || value.stageIndex < 0
+            || value.stageIndex > value.stageCount
+            || !Number.isSafeInteger(value.fencingToken)
+            || value.fencingToken < 0
+            || typeof value.lockId !== 'string'
+            || !this.time(value.leaseExpiresAtMs)
+            || !this.time(value.evaluatedAtMs)
+            || !Number.isSafeInteger(value.selectedRecordCount)
+            || value.selectedRecordCount < 0
+            || !Number.isSafeInteger(value.deletedRecordCount)
+            || value.deletedRecordCount < 0
+            || value.deletedRecordCount > value.selectedRecordCount
+            || (value.lastResultChecksum !== '' && !dynts_hashPattern.test(value.lastResultChecksum))
+            || !this.time(value.scheduledAtMs)
+            || !this.time(value.updatedAtMs)
+            || !this.time(value.completedAtMs)) {
+            throw new Error('DyNTS|LIFECYCLE_CLEANUP_STORE|INVALID_DOCUMENT');
+        }
+        return value;
+    }
+    time(value) {
+        return Number.isSafeInteger(value) && value >= 0;
+    }
+    scheduleReceipt(value, wasCreated) {
+        return Object.freeze({
+            contractVersion: 'dynts-lifecycle-cleanup-schedule-receipt/1',
+            scopeHash: value.scopeHash,
+            cleanupId: value.cleanupId,
+            planChecksum: value.planChecksum,
+            eligibleAtMs: value.eligibleAtMs,
+            wasCreated: wasCreated,
+        });
+    }
+    claimReceipt(value, code) {
+        const document = this.document(value);
+        return Object.freeze({
+            contractVersion: 'dynts-lifecycle-cleanup-claim/1',
+            scopeHash: document.scopeHash,
+            cleanupId: document.cleanupId,
+            code: code,
+            state: document.state,
+            planChecksum: document.planChecksum,
+            stageIndex: document.stageIndex,
+            evaluatedAtMs: document.evaluatedAtMs,
+            fencingToken: document.fencingToken,
+            selectedRecordCount: document.selectedRecordCount,
+            deletedRecordCount: document.deletedRecordCount,
+            lastResultChecksum: document.lastResultChecksum,
+        });
+    }
+    validator() {
+        return { $jsonSchema: {
+                bsonType: 'object',
+                additionalProperties: false,
+                required: [
+                    '_id', 'contractVersion', 'scopeHash', 'cleanupId', 'planChecksum', 'stageCount', 'eligibleAtMs',
+                    'state', 'stageIndex', 'fencingToken', 'lockId', 'leaseExpiresAtMs', 'evaluatedAtMs',
+                    'selectedRecordCount', 'deletedRecordCount', 'lastResultChecksum', 'scheduledAtMs', 'updatedAtMs',
+                    'completedAtMs',
+                ],
+                properties: {
+                    _id: { bsonType: 'string' },
+                    contractVersion: { enum: ['dynts-lifecycle-cleanup-store/1'] },
+                    scopeHash: { bsonType: 'string', pattern: '^[a-f0-9]{64}$' },
+                    cleanupId: { bsonType: 'string', pattern: '^[a-f0-9]{64}$' },
+                    planChecksum: { bsonType: 'string', pattern: '^[a-f0-9]{64}$' },
+                    stageCount: { bsonType: ['int', 'long', 'double'], minimum: 1, maximum: 128 },
+                    eligibleAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    state: { enum: Object.values(lifecycle_cleanup_state_type_enum_1.DyNTS_LifecycleCleanupState_Type) },
+                    stageIndex: { bsonType: ['int', 'long', 'double'], minimum: 0, maximum: 128 },
+                    fencingToken: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    lockId: { bsonType: 'string' },
+                    leaseExpiresAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    evaluatedAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    selectedRecordCount: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    deletedRecordCount: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    lastResultChecksum: { bsonType: 'string' },
+                    scheduledAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    updatedAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                    completedAtMs: { bsonType: ['int', 'long', 'double'], minimum: 0 },
+                },
+            } };
+    }
+    isMongoCode(error, code) {
+        if (typeof error !== 'object' || error === null) {
+            return false;
+        }
+        return Object.getOwnPropertyDescriptor(error, 'code')?.value === code;
+    }
+}
+exports.DyNTS_LifecycleCleanup_MongoStore = DyNTS_LifecycleCleanup_MongoStore;
+//# sourceMappingURL=lifecycle-cleanup.mongo-store.js.map

package/build/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-cleanup.mongo-store.js","sourceRoot":"","sources":["../../../src/_modules/lifecycle-cleanup/lifecycle-cleanup.mongo-store.ts"],"names":[],"mappings":"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"}

package/build/_modules/media-gen/_models/meshy-settings.interface.d.ts

@@ -0,0 +1,19 @@
+/** The HTTP call the Meshy adapter makes - injectable, so specs assert the requests without a network or a key. */
+export type DyNTS_Meshy_Fetch = (url: string, init: RequestInit) => Promise<Response>;
+/**
+ * Settings of the Meshy image-to-3D adapter. Every field is optional; what is left out falls back to the environment
+ * (read at call time) or to the defaults the master-prompter donor runs in production.
+ */
+export interface DyNTS_Meshy_Settings {
+    /** API key. Falls back to `MESHY_API_KEY`. */
+    apiKey?: string;
+    /** HTTP implementation. Defaults to the global `fetch`. */
+    fetchImpl?: DyNTS_Meshy_Fetch;
+    /** Wait between two status checks. Default 3000 ms (the donor's production value). */
+    pollIntervalMs?: number;
+    /** Give up on a task after this long. Default 15 minutes (the donor's production value). */
+    timeoutMs?: number;
+    /** The wait itself - injectable, so specs do not sleep. Defaults to a timer. */
+    sleep?: (ms: number) => Promise<void>;
+}
+//# sourceMappingURL=meshy-settings.interface.d.ts.map

package/build/_modules/media-gen/_models/meshy-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshy-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/meshy-settings.interface.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEtF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/build/_modules/media-gen/_models/meshy-settings.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=meshy-settings.interface.js.map

package/build/_modules/media-gen/_models/meshy-settings.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshy-settings.interface.js","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_models/meshy-settings.interface.ts"],"names":[],"mappings":""}

package/build/_modules/media-gen/_services/meshy-image-to-3d.control-service.d.ts

@@ -0,0 +1,49 @@
+import { DyFM_AI_Model3D_Request, DyFM_AI_Model3D_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_Meshy_Settings } from '../_models/meshy-settings.interface';
+import { DyNTS_MediaGen_Operation } from '../_models/media-gen-operation.type';
+import { DyNTS_MediaGen_ServiceBase } from './media-gen.service-base';
+/**
+ * Meshy image-to-3D adapter.
+ *
+ * Shapes verified against the provider's API reference (2026-09-15): `POST https://api.meshy.ai/openapi/v1/image-to-3d`
+ * with bearer auth, `image_url` as a public URL or a base64 data URI (.jpg / .jpeg / .png), the task id in `result`;
+ * `GET /openapi/v1/image-to-3d/:id` with `status` PENDING | IN_PROGRESS | SUCCEEDED | FAILED | CANCELED, `model_urls`
+ * keyed by format, and `task_error`.
+ *
+ * 🔴 MODERATION IS ENFORCED: every request sends `moderation: true` - the documented default is false, and the
+ * master-prompter donor turns it on for its compliance audit (no AI adult content; the input image and texture prompt
+ * are screened and the task does not generate on a hit). Nothing a caller passes can change it.
+ * The API reference states nothing about visibility, and API-generated models are private: there is no public flag
+ * to send.
+ *
+ * Only the requested formats are downloaded (default `glb`), without the auth header - the key must not travel to
+ * a CDN. The thumbnail URL stays in `rawResponse`: a failed preview download must not void a paid generation.
+ */
+export declare class DyNTS_Meshy_ImageTo3D_ControlService extends DyNTS_MediaGen_ServiceBase<DyFM_AI_Model3D_Request, DyFM_AI_Model3D_Response> {
+    static readonly baseUrl: string;
+    static readonly defaultPollIntervalMs: number;
+    static readonly defaultTimeoutMs: number;
+    static readonly defaultFormats: readonly string[];
+    /** The documented limit of `texture_prompt`. */
+    static readonly maxTexturePromptLength: number;
+    readonly provider: string;
+    readonly operations: readonly DyNTS_MediaGen_Operation[];
+    protected readonly settings: DyNTS_Meshy_Settings;
+    constructor(settings?: DyNTS_Meshy_Settings);
+    static getInstance(): DyNTS_Meshy_ImageTo3D_ControlService;
+    /** Reads a field of an unknown JSON value without assuming its shape. */
+    private static readField;
+    /**
+     * Builds a 3D model from one image: create the task, wait for it, download the requested formats.
+     */
+    generate(operation: DyNTS_MediaGen_Operation, request: DyFM_AI_Model3D_Request, issuer: string): Promise<DyFM_AI_Model3D_Response>;
+    /** Polls the task until SUCCEEDED; FAILED, CANCELED and the timeout are errors that carry the task id. */
+    private waitForTask;
+    /** Downloads each requested format from `model_urls`; a missing format is an error naming the ones produced. */
+    private downloadFormats;
+    /** Parses a JSON response, or throws with the status and the first 500 characters of the body. */
+    private readJson;
+    /** A refusal or failure, reported with this adapter's error settings. */
+    private failure;
+}
+//# sourceMappingURL=meshy-image-to-3d.control-service.d.ts.map

package/build/_modules/media-gen/_services/meshy-image-to-3d.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshy-image-to-3d.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/media-gen/_services/meshy-image-to-3d.control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGhH,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oCACX,SAAQ,0BAA0B,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;IAErF,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAiD;IAChF,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAQ;IACrD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAkB;IAC1D,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAa;IAC9D,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAO;IAErD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAW;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAqB;IAE7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAEtC,QAAQ,GAAE,oBAAyB;IAK/C,MAAM,CAAC,WAAW,IAAI,oCAAoC;IAI1D,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB;;OAEG;IACG,QAAQ,CACZ,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC;IA+DpC,0GAA0G;YAC5F,WAAW;IA+CzB,gHAAgH;YAClG,eAAe;IA4C7B,kGAAkG;YACpF,QAAQ;IAatB,yEAAyE;IACzE,OAAO,CAAC,OAAO;CAOhB"}