@teleporthq/teleport-plugin-next-workflows 0.43.61 → 0.43.63

package/dist/cjs/nodes/browser/browser-speech-recognition.js

@@ -0,0 +1,448 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserSpeechRecognition = void 0;
+const types_1 = require("../types");
+/**
+ * A long-lived dictation session, as opposed to `browser-speech-to-text`, which
+ * awaits the FIRST phrase, resolves, and offers no way to stop.
+ *
+ * The contract this node exists for:
+ *
+ *  - It RETURNS IMMEDIATELY. A workflow that awaited the transcript could not
+ *    also run a second workflow to stop the microphone, and the node would hold
+ *    the whole run open for as long as the visitor kept talking.
+ *  - Transcripts leave through CUSTOM EVENTS (`resultEventName`), dispatched on
+ *    the `workflow:custom:` channel that `event-custom-triggered` listens on. A
+ *    workflow bound to that event writes the text into a field, so every
+ *    app-visible effect still belongs to a workflow rather than to this handler.
+ *  - The session registry on `window` — not a page state — is the authority on
+ *    whether the microphone is live, so `action: "toggle"` cannot desync from
+ *    reality no matter how the UI state was left.
+ *
+ * Every exit path ends in exactly one `endEventName` dispatch, including the
+ * ones that never started (unsupported browser, `start()` throwing), so the UI
+ * that turned "listening" on always has something to turn it off again.
+ *
+ * ⛔ NOTHING here is reported as an `error`. The runtime's `isFatalNodeResult`
+ * treats any non-empty `error` string as a FAILED node and aborts the rest of
+ * the workflow — which would skip the very state write that puts the button
+ * back to idle, and would fire the error branch of any workflow that has one.
+ * A browser without the API, or a visitor who declines the microphone, is a
+ * normal outcome of asking, not a failure of the workflow, so it comes back as
+ * `reason` and the caller decides what to say about it.
+ */
+async function browser_speech_recognition(config, _context) {
+    const REGISTRY_KEY = '__teleportSpeechSessions';
+    const DEFAULT_MAX_DURATION_MS = 120000;
+    // Chrome ends a "continuous" session after a few seconds of silence, so a
+    // dictation of any length is really a chain of restarts. The cap is what
+    // stops a microphone that can never hear anything (muted device, wrong input)
+    // from restarting forever.
+    const MAX_CONSECUTIVE_RESTARTS = 60;
+    // A run shorter than this heard nothing at all; see `onend`.
+    const MIN_USEFUL_RUN_MS = 500;
+    const MAX_RAPID_RESTARTS = 5;
+    // Errors that mean "this will not work, stop trying" rather than "nothing was
+    // said just now". `no-speech` and `aborted` are ordinary and must NOT be here.
+    const FATAL_ERRORS = ['not-allowed', 'service-not-allowed', 'audio-capture', 'bad-grammar'];
+    // ⛔ These two strings are a CONTRACT with the builder repo, where they are
+    // `SPEECH_STOP_PHRASE_REASON` / `SPEECH_SUBMIT_PHRASE_REASON` and are what a
+    // workflow gates its follow-up branch on. The handler is emitted as a
+    // standalone string in a separate repo, so it cannot import them: instead
+    // both sides pin the literal in their own tests, and either one changing the
+    // spelling alone fails there.
+    const STOP_PHRASE_REASON = 'stop-phrase';
+    const SUBMIT_PHRASE_REASON = 'submit-phrase';
+    const win = typeof window === 'undefined' ? null : window;
+    if (!win) {
+        return {
+            listening: false,
+            supported: false,
+            action: 'unchanged',
+            sessionId: '',
+            reason: 'no-window',
+        };
+    }
+    const sessions = win[REGISTRY_KEY] || (win[REGISTRY_KEY] = {});
+    const sessionId = String(config.sessionId == null || config.sessionId === '' ? 'default' : config.sessionId);
+    const requested = config.action === 'start' || config.action === 'stop' ? config.action : 'toggle';
+    const resultEventName = typeof config.resultEventName === 'string' ? config.resultEventName : '';
+    const endEventName = typeof config.endEventName === 'string' ? config.endEventName : '';
+    // What the end event reports when THIS call is the thing that stops the
+    // session. A caller that stops for a reason of its own — a spoken "send that",
+    // a navigation, a closing panel — needs the end workflow to be able to tell
+    // that apart from the visitor clicking the microphone off, and the end event
+    // is the only place both arrive.
+    const stopReason = typeof config.stopReason === 'string' && config.stopReason ? config.stopReason : 'stopped';
+    const dispatch = (eventName, detail) => {
+        if (!eventName) {
+            return;
+        }
+        try {
+            win.dispatchEvent(new CustomEvent('workflow:custom:' + eventName, { detail }));
+        }
+        catch (e) {
+            /* a listener throwing must never take the session down with it */
+        }
+    };
+    const existing = sessions[sessionId];
+    const isListening = !!(existing && existing.active);
+    // ── stop ──────────────────────────────────────────────────────────────────
+    if (requested === 'stop' || (requested === 'toggle' && isListening)) {
+        if (!existing) {
+            return {
+                listening: false,
+                supported: true,
+                action: 'unchanged',
+                sessionId,
+                reason: '',
+            };
+        }
+        // Cleared BEFORE `.stop()` so the `onend` that follows finalizes instead of
+        // auto-restarting, and so a second click cannot stop the same session twice.
+        existing.active = false;
+        existing.reason = stopReason;
+        try {
+            existing.recognition.stop();
+        }
+        catch (e) {
+            // Already stopping, or never started. `onend` may therefore never fire,
+            // so finalize here instead of leaving the UI stuck on "listening".
+            if (existing.finalize) {
+                existing.finalize(stopReason, '');
+            }
+        }
+        return {
+            listening: false,
+            supported: true,
+            action: 'stopped',
+            sessionId,
+            reason: '',
+        };
+    }
+    // ── start ─────────────────────────────────────────────────────────────────
+    if (isListening) {
+        // `action: "start"` on a live session: leave it alone rather than replacing
+        // the recogniser, which would drop everything said so far.
+        return {
+            listening: true,
+            supported: true,
+            action: 'unchanged',
+            sessionId,
+            reason: '',
+        };
+    }
+    const SpeechRecognition = win.SpeechRecognition || win.webkitSpeechRecognition;
+    if (!SpeechRecognition) {
+        // Firefox, and every browser with the API behind a flag. The end event is
+        // still emitted so the caller's "listening" state is turned back off and it
+        // has a `reason` to explain the failure with.
+        dispatch(endEventName, {
+            sessionId,
+            text: typeof config.initialText === 'string' ? config.initialText : '',
+            transcript: '',
+            reason: 'unsupported',
+            error: '',
+            listening: false,
+        });
+        return {
+            listening: false,
+            supported: false,
+            action: 'unchanged',
+            sessionId,
+            reason: 'unsupported',
+        };
+    }
+    const baseText = typeof config.initialText === 'string' ? config.initialText : '';
+    const continuous = config.continuous !== false;
+    const interimResults = config.interimResults !== false;
+    const language = (typeof config.language === 'string' && config.language) ||
+        (win.document && win.document.documentElement && win.document.documentElement.lang) ||
+        'en-US';
+    const autoRestart = config.autoRestart !== false && continuous;
+    // Spoken commands. Normalised once, longest first: "stop listening" has to
+    // win over "stop", or the longer spelling leaves "listening" in the field.
+    const toPhraseList = (value) => (Array.isArray(value) ? value : [])
+        .map((entry) => String(entry == null ? '' : entry)
+        .toLowerCase()
+        .trim())
+        .filter(function (entry) {
+        return entry !== '';
+    })
+        .sort(function (a, b) {
+        return b.length - a.length;
+    });
+    const stopPhrases = toPhraseList(config.stopPhrases);
+    const submitPhrases = toPhraseList(config.submitPhrases);
+    const maxDurationMs = typeof config.maxDurationMs === 'number' && config.maxDurationMs > 0
+        ? config.maxDurationMs
+        : DEFAULT_MAX_DURATION_MS;
+    const session = {
+        active: true,
+        startedAt: 0,
+        rapidRestarts: 0,
+        baseText,
+        // Finals from recogniser runs that have already ended. Kept apart from the
+        // current run's finals because a restarted recogniser reports its own
+        // results from index 0 again, so the two cannot share one accumulator.
+        committedText: '',
+        currentFinalText: '',
+        lastEmitted: null,
+        restarts: 0,
+        reason: 'ended',
+        matchedPhrase: '',
+        error: '',
+        finished: false,
+        recognition: null,
+        timer: null,
+        finalize: null,
+    };
+    sessions[sessionId] = session;
+    // Every seam between two pieces of text needs the same rule: without it,
+    // "hello" typed then "there" spoken comes back as "hellothere".
+    const join = (head, tail) => {
+        if (!head) {
+            return tail;
+        }
+        if (!tail) {
+            return head;
+        }
+        return /\s$/.test(head) ? head + tail : head + ' ' + tail;
+    };
+    /** Everything recognised so far in this session, across restarts. */
+    const spokenSoFar = () => join(session.committedText, session.currentFinalText);
+    /** What the target field should now contain. */
+    const compose = (spoken) => join(session.baseText, spoken);
+    // ── spoken commands ───────────────────────────────────────────────────────
+    // A command is the LAST thing said, so matching is anchored to the end of the
+    // text and to a word boundary — "enclose" is not "close", and "how do I
+    // submit a return" is not a submit. Trailing punctuation is the recogniser's,
+    // never the visitor's: "send it." and "send it" are one instruction.
+    const trimCommandTail = (value) => value.replace(/[\s.,!?;:]+$/, '');
+    // ⛔ The MESSAGE keeps its own punctuation. Only the separator between it and
+    // the command goes — the pause comma the recogniser writes for "what time do
+    // you open, send it". Trimming the same set would turn a dictated question
+    // into a statement.
+    const trimSeparator = (value) => value.replace(/[\s,;:]+$/, '');
+    const matchPhraseAtEnd = (text, phrases) => {
+        const trimmed = trimCommandTail(text);
+        const lower = trimmed.toLowerCase();
+        for (let i = 0; i < phrases.length; i += 1) {
+            const phrase = phrases[i];
+            if (!phrase || lower.length < phrase.length) {
+                continue;
+            }
+            if (lower.slice(lower.length - phrase.length) !== phrase) {
+                continue;
+            }
+            const head = trimmed.slice(0, trimmed.length - phrase.length);
+            if (head !== '' && !/\s$/.test(head)) {
+                continue;
+            }
+            return { phrase, rest: trimSeparator(head) };
+        }
+        return null;
+    };
+    /**
+     * What the field should show, and what the visitor asked for.
+     *
+     * Stripping runs on EVERY update so the command word is never visible, and is
+     * self-correcting: an interim that revises itself puts the word back on the
+     * next one. Only a settled phrase ACTS, which is what stops a half-spoken
+     * sentence from firing.
+     */
+    const readCommand = (text, isFinal) => {
+        if (stopPhrases.length === 0 && submitPhrases.length === 0) {
+            return { text, action: '', phrase: '' };
+        }
+        let hit = matchPhraseAtEnd(text, submitPhrases);
+        let action = hit ? 'submit' : '';
+        if (!hit) {
+            hit = matchPhraseAtEnd(text, stopPhrases);
+            action = hit ? 'stop' : '';
+        }
+        if (!hit) {
+            return { text, action: '', phrase: '' };
+        }
+        // Nothing left to act on is a plain stop, never an empty submission.
+        if (action === 'submit' && hit.rest.trim() === '') {
+            action = 'stop';
+        }
+        return { text: hit.rest, action: isFinal ? action : '', phrase: hit.phrase };
+    };
+    const finalize = (reason, error, matchedPhrase) => {
+        if (session.finished) {
+            return;
+        }
+        session.finished = true;
+        session.active = false;
+        if (session.timer) {
+            clearTimeout(session.timer);
+            session.timer = null;
+        }
+        // ⛔ A session that has been REPLACED must die quietly. `onend` arrives a
+        // task after `.stop()`, so a click landing in that gap starts a fresh
+        // session under the same name — and the old one's end event would then turn
+        // the UI off while the new microphone is live.
+        const isCurrent = sessions[sessionId] === session;
+        if (!isCurrent) {
+            return;
+        }
+        delete sessions[sessionId];
+        // The command word is cut out here too, so the end event's text is the same
+        // thing the field was left showing.
+        const spoken = readCommand(spokenSoFar(), true);
+        dispatch(endEventName, {
+            sessionId,
+            text: compose(spoken.text),
+            transcript: spoken.text,
+            reason,
+            error,
+            matchedPhrase: matchedPhrase || '',
+            listening: false,
+        });
+    };
+    session.finalize = finalize;
+    const recognition = new SpeechRecognition();
+    session.recognition = recognition;
+    recognition.lang = language;
+    recognition.continuous = continuous;
+    recognition.interimResults = interimResults;
+    if (typeof config.maxAlternatives === 'number' && config.maxAlternatives > 0) {
+        recognition.maxAlternatives = config.maxAlternatives;
+    }
+    recognition.onresult = (event) => {
+        // ⛔ REBUILT from the whole result list, never appended from
+        // `event.resultIndex`. An engine is free to re-report a result that is
+        // already final (Chrome does when a later phrase revises an earlier one),
+        // and an append would then say the same sentence twice. Rebuilding is
+        // idempotent whatever the engine re-sends.
+        let currentFinal = '';
+        let interim = '';
+        const results = event.results || [];
+        for (let i = 0; i < results.length; i += 1) {
+            const result = results[i];
+            const alternative = result && result[0];
+            const text = alternative && alternative.transcript ? String(alternative.transcript).trim() : '';
+            if (result && result.isFinal) {
+                currentFinal = join(currentFinal, text);
+            }
+            else {
+                interim = join(interim, text);
+            }
+        }
+        session.currentFinalText = currentFinal;
+        const isFinal = !interim;
+        const spoken = readCommand(join(spokenSoFar(), interim), isFinal);
+        const composed = compose(spoken.text);
+        // The API re-emits an unchanged interim result several times a second;
+        // without this guard each one would run the consuming workflow again.
+        //
+        // ⛔ Finality is part of the key. The last interim of a phrase almost always
+        // has the SAME text as the final that follows it, so keying on the text
+        // alone swallowed the final event entirely — and a consumer that only acts
+        // on settled speech (a spoken command, a submit) would then never fire.
+        const emissionKey = composed + '\u0000' + (isFinal ? '1' : '0');
+        if (emissionKey !== session.lastEmitted) {
+            session.lastEmitted = emissionKey;
+            dispatch(resultEventName, {
+                sessionId,
+                text: composed,
+                transcript: spoken.text,
+                isFinal,
+                listening: true,
+            });
+        }
+        if (!spoken.action) {
+            return;
+        }
+        // A spoken command ends the session itself. The result event above went out
+        // first and carries the text with the command already cut out, so whatever
+        // writes it into the field has the final value before the end event lands.
+        session.active = false;
+        session.reason = spoken.action === 'submit' ? SUBMIT_PHRASE_REASON : STOP_PHRASE_REASON;
+        session.matchedPhrase = spoken.phrase;
+        try {
+            recognition.stop();
+        }
+        catch (e) {
+            finalize(session.reason, '', spoken.phrase);
+        }
+    };
+    recognition.onerror = (event) => {
+        const code = (event && event.error) || 'unknown';
+        session.error = code;
+        if (FATAL_ERRORS.indexOf(code) >= 0) {
+            session.active = false;
+            session.reason = code;
+        }
+    };
+    recognition.onend = () => {
+        // A run that ended almost as soon as it began never listened to anything —
+        // no microphone, or the speech service unreachable. Restarting those as fast
+        // as the browser allows is a tight loop, so they get a much shorter leash
+        // than the ordinary silence-timeout restarts they are counted apart from.
+        const ranFor = Date.now() - session.startedAt;
+        session.rapidRestarts = ranFor < MIN_USEFUL_RUN_MS ? session.rapidRestarts + 1 : 0;
+        const canRestart = session.active &&
+            autoRestart &&
+            session.restarts < MAX_CONSECUTIVE_RESTARTS &&
+            session.rapidRestarts < MAX_RAPID_RESTARTS &&
+            !(win.document && win.document.hidden);
+        if (!canRestart) {
+            finalize(session.active ? 'ended' : session.reason, session.error, session.matchedPhrase);
+            return;
+        }
+        // Bank this run's finals before the recogniser starts numbering from 0
+        // again, and drop the error that ended it — `no-speech` from a pause must
+        // not be reported as the reason the whole session eventually stopped.
+        session.committedText = spokenSoFar();
+        session.currentFinalText = '';
+        session.error = '';
+        session.restarts += 1;
+        session.startedAt = Date.now();
+        try {
+            recognition.start();
+        }
+        catch (e) {
+            finalize('ended', session.error);
+        }
+    };
+    session.startedAt = Date.now();
+    try {
+        recognition.start();
+    }
+    catch (e) {
+        // `InvalidStateError` from a recogniser the browser still considers running.
+        finalize('start-failed', e.message || 'start-failed');
+        return {
+            listening: false,
+            supported: true,
+            action: 'unchanged',
+            sessionId,
+            reason: 'start-failed',
+        };
+    }
+    session.timer = setTimeout(() => {
+        if (!session.active) {
+            return;
+        }
+        session.active = false;
+        session.reason = 'timeout';
+        try {
+            recognition.stop();
+        }
+        catch (e) {
+            finalize('timeout', '');
+        }
+    }, maxDurationMs);
+    return { listening: true, supported: true, action: 'started', sessionId, reason: '' };
+}
+exports.browserSpeechRecognition = {
+    nodeType: 'browser-speech-recognition',
+    executionEnv: 'client',
+    generateHandler() {
+        return (0, types_1.handlerToString)(browser_speech_recognition);
+    },
+};
+//# sourceMappingURL=browser-speech-recognition.js.map

package/dist/cjs/nodes/browser/browser-speech-recognition.js.map

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

package/dist/cjs/nodes/cache/page-revalidate.d.ts

@@ -0,0 +1,3 @@
+import { NodeHandlerGenerator } from '../types';
+export declare const pageRevalidate: NodeHandlerGenerator;
+//# sourceMappingURL=page-revalidate.d.ts.map

package/dist/cjs/nodes/cache/page-revalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-revalidate.d.ts","sourceRoot":"","sources":["../../../../src/nodes/cache/page-revalidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,UAAU,CAAA;AAqIhE,eAAO,MAAM,cAAc,EAAE,oBAM5B,CAAA"}

package/dist/cjs/nodes/cache/page-revalidate.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageRevalidate = void 0;
+const types_1 = require("../types");
+/**
+ * Rebuilds statically generated pages on the published site.
+ *
+ * This is the OTHER cache a published project serves from. `cache-invalidate`
+ * clears the data-API cache; a page built by `getStaticProps` keeps serving the
+ * HTML it was built with regardless, until its ISR window expires. So an admin
+ * who creates, edits or deletes a row watches the public URL stay wrong for the
+ * length of that window. Calling `res.revalidate(path)` re-runs `getStaticProps`
+ * for that path immediately.
+ *
+ * SERVER-classified deliberately, for the same two reasons as
+ * `cache-invalidate`: `res.revalidate` only exists inside a server route, and
+ * being server-side lands it in the SAME segment as the write it follows, so
+ * adding it to a CRUD workflow costs no extra round trip.
+ *
+ * It reaches the rebuild through the app's own `POST /api/tq-revalidate` rather
+ * than by importing anything: node handlers ship as runtime source and are
+ * re-bundled by webpack, which rewrites `require(` — so an internal HTTP call is
+ * the sanctioned way for a handler to reach server-side machinery, and it is
+ * also the only way to get at a `res` object with `revalidate` on it.
+ *
+ * ⛔ Never mark this node fire-and-forget. Its workflows navigate or refresh a
+ * page immediately afterwards, and that reload routinely wins the race against
+ * an unawaited rebuild — leaving the visitor looking at the stale page this was
+ * meant to replace.
+ *
+ * ⛔ It also must NEVER return `{ success: false }` or a string `error`. The
+ * runtime treats both as FATAL and halts the workflow (`isFatalNodeResult`), so
+ * a page that could not be rebuilt would abort an admin's save AFTER the row was
+ * already written — no success toast, no navigation, and an error for an action
+ * that worked. Outcomes are reported as `revalidated` plus a `warning`, and the
+ * page's own ISR window remains the safety net.
+ */
+async function page_revalidate(config, context) {
+    const configured = Array.isArray(config.paths)
+        ? config.paths
+        : config.paths === undefined || config.paths === null
+            ? []
+            : [config.paths];
+    // One level of flattening: a step that revalidates several rows at once (a
+    // bulk delete, say) resolves ONE reference to an array of slugs rather than
+    // configuring a path per row.
+    const flattened = [];
+    for (let i = 0; i < configured.length; i++) {
+        const entry = configured[i];
+        if (Array.isArray(entry)) {
+            for (let j = 0; j < entry.length; j++) {
+                flattened.push(entry[j]);
+            }
+            continue;
+        }
+        flattened.push(entry);
+    }
+    const paths = [];
+    for (let i = 0; i < flattened.length; i++) {
+        const raw = flattened[i];
+        if (raw === undefined || raw === null || typeof raw === 'object') {
+            continue;
+        }
+        const trimmed = String(raw).trim();
+        if (!trimmed) {
+            continue;
+        }
+        // `res.revalidate` only accepts a site-root-relative path, and a step whose
+        // path came from a database column often holds the bare slug.
+        const normalized = trimmed.charAt(0) === '/' ? trimmed : '/' + trimmed;
+        if (paths.indexOf(normalized) === -1) {
+            paths.push(normalized);
+        }
+    }
+    if (!paths.length) {
+        return {
+            revalidated: [],
+            warning: 'No page paths were configured on this step.',
+        };
+    }
+    const baseUrl = context.__baseUrl || '';
+    const __internalHeaders = context.__internalHeaders || {};
+    const __env = globalThis.process && globalThis.process.env;
+    const secret = __env ? __env.TQ_CACHE_SECRET : '';
+    if (!secret) {
+        // Reported rather than thrown: the write this follows already succeeded, and
+        // the page still refreshes on its own revalidate window.
+        return {
+            revalidated: [],
+            warning: 'TQ_CACHE_SECRET is not configured, so published pages will refresh on their own schedule.',
+        };
+    }
+    try {
+        const response = await fetch(baseUrl + '/api/tq-revalidate', {
+            method: 'POST',
+            headers: Object.assign({ 'Content-Type': 'application/json', 'x-tq-cache-secret': secret }, __internalHeaders),
+            body: JSON.stringify({ paths }),
+        });
+        const data = await response.json();
+        if (!response.ok || !data.ok) {
+            const warning = data.error || 'The published pages could not be refreshed; they will refresh on their own.';
+            return { revalidated: [], warning };
+        }
+        const revalidated = Array.isArray(data.revalidated) ? data.revalidated : [];
+        const failed = Array.isArray(data.failed) ? data.failed : [];
+        if (failed.length) {
+            return {
+                revalidated,
+                warning: 'Some pages could not be refreshed and will refresh on their own: ' + failed.join(', '),
+            };
+        }
+        return { revalidated };
+    }
+    catch (err) {
+        return { revalidated: [], warning: err.message };
+    }
+}
+exports.pageRevalidate = {
+    nodeType: 'page-revalidate',
+    executionEnv: 'server',
+    generateHandler() {
+        return (0, types_1.handlerToString)(page_revalidate);
+    },
+};
+//# sourceMappingURL=page-revalidate.js.map

package/dist/cjs/nodes/cache/page-revalidate.js.map

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

package/dist/cjs/nodes/cart/cart-add-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart-add-item.d.ts","sourceRoot":"","sources":["../../../../src/nodes/cart/cart-add-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,UAAU,CAAA;AAsHhE,eAAO,MAAM,WAAW,EAAE,oBAMzB,CAAA"}
+{"version":3,"file":"cart-add-item.d.ts","sourceRoot":"","sources":["../../../../src/nodes/cart/cart-add-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,UAAU,CAAA;AAmJhE,eAAO,MAAM,WAAW,EAAE,oBAWzB,CAAA"}