@justscale/core 0.1.0

package/dist/process/primitives.js

@@ -0,0 +1,325 @@
+/**
+ * @justscale/process - Signal Primitives
+ *
+ * These functions provide the developer API for process control flow.
+ * The actual behavior is implemented through compiler transforms that convert
+ * calls to these functions into opcodes for the process runtime.
+ */
+// ============================================================================
+// Durable Iterator Protocol
+// ============================================================================
+/**
+ * Symbol for getting the current cursor from a durable iterator.
+ * Called by runtime before suspension to persist position.
+ */
+export const DurableCursor = Symbol.for('justscale:DurableCursor');
+/**
+ * Symbol for restoring an iterator from a saved cursor.
+ * Called by runtime on resume to continue iteration.
+ */
+export const FromCursor = Symbol.for('justscale:FromCursor');
+/**
+ * Wrapper that makes regular arrays durable.
+ * The cursor is simply the index.
+ */
+export class DurableArrayIterator {
+    items;
+    index;
+    constructor(items, initialCursor) {
+        this.items = items;
+        if (typeof initialCursor === 'number' && Number.isFinite(initialCursor)) {
+            // Floor non-integers, clamp to valid range [0, items.length]
+            // Upper bound is items.length (not length-1) to allow "done" position
+            const floored = Math.floor(initialCursor);
+            this.index = Math.max(0, Math.min(floored, items.length));
+        }
+        else {
+            // NaN, Infinity, strings, objects, etc. all reset to 0
+            this.index = 0;
+        }
+    }
+    [DurableCursor]() {
+        return this.index;
+    }
+    [FromCursor](cursor) {
+        return new DurableArrayIterator(this.items, cursor);
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+    async next() {
+        if (this.index >= this.items.length) {
+            return { done: true, value: undefined };
+        }
+        const value = this.items[this.index];
+        this.index++;
+        return { done: false, value };
+    }
+}
+/**
+ * Check if a value implements the durable iterator protocol.
+ */
+export function isDurableIterable(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        DurableCursor in value &&
+        FromCursor in value);
+}
+/**
+ * Create a durable iterator from an array.
+ * If a cursor is provided, resumes from that position.
+ */
+export function createDurableArrayIterator(items, cursor) {
+    return new DurableArrayIterator(items, cursor);
+}
+// ============================================================================
+// Signal Primitives
+// ============================================================================
+/** Symbol to identify signal placeholders at runtime */
+const SIGNAL_PLACEHOLDER = Symbol.for('@justscale/process/signal');
+/** Symbol to identify signal.all() placeholders at runtime. Cross-realm with tests. */
+const SIGNAL_ALL_PLACEHOLDER = Symbol.for('@justscale/process/signal.all');
+/** Symbol to identify signal.settled() placeholders at runtime. Cross-realm with tests. */
+const SIGNAL_SETTLED_PLACEHOLDER = Symbol.for('@justscale/process/signal.settled');
+/** Symbol to identify race placeholders at runtime. Cross-realm with tests. */
+const RACE_PLACEHOLDER = Symbol.for('@justscale/process/race');
+/** Symbol to identify delay placeholders at runtime. Cross-realm with tests. */
+const DELAY_PLACEHOLDER = Symbol.for('@justscale/process/delay');
+/**
+ * Wait for a signal inside a process, or use as a case discriminant in race().
+ *
+ * **Awaiting a signal (single arg):**
+ * When awaited inside a process handler, this suspends the process until
+ * the signal is emitted and returns the payload.
+ *
+ * **In a race switch (two args):**
+ * Pass the race result as first arg to narrow its type in the case branch.
+ *
+ * The compiler transforms this into appropriate opcodes.
+ *
+ * @example
+ * ```typescript
+ * // Simple wait
+ * const payload = await signal(orders.complete)
+ *
+ * // Race with narrowing - pass r to narrow its type
+ * const r = race()
+ * switch (r) {
+ *   case signal(r, orders.complete):
+ *     // r is narrowed to the payload type
+ *     console.log(r.orderId)
+ *     break
+ *   case delay.hours(r, 24):
+ *     // timeout
+ *     break
+ * }
+ * ```
+ */
+function signalImpl(...args) {
+    // Two distinct overloads, disambiguated by arity (not coalescing):
+    //   signal(signalDef)            - arg0 is the target
+    //   signal(racer, signalDef)     - arg1 is the target
+    // Passing `undefined` explicitly for the target is a caller bug, not a
+    // legitimate "fall back to the other arg" signal. We error loudly so
+    // race() misuse doesn't silently resolve to the race context itself.
+    let target;
+    if (args.length >= 2) {
+        if (args[0] === undefined) {
+            throw new TypeError('signal() target is undefined');
+        }
+        target = args[1];
+        if (target === undefined) {
+            throw new TypeError('signal() target is undefined');
+        }
+    }
+    else if (args.length === 1) {
+        target = args[0];
+        if (target === undefined) {
+            throw new TypeError('signal() target is undefined');
+        }
+    }
+    else {
+        throw new TypeError('signal() requires a target');
+    }
+    return {
+        [SIGNAL_PLACEHOLDER]: true,
+        signal: target,
+    };
+}
+function signalAll(signalsOrRacer, maybeSignals) {
+    const signals = maybeSignals ?? signalsOrRacer;
+    const isRace = maybeSignals !== undefined;
+    return {
+        [SIGNAL_ALL_PLACEHOLDER]: true,
+        signals,
+        isRace,
+    };
+}
+function signalSettled(signals) {
+    return {
+        [SIGNAL_SETTLED_PLACEHOLDER]: true,
+        signals,
+    };
+}
+export const signal = Object.assign(signalImpl, {
+    all: signalAll,
+    settled: signalSettled,
+});
+/**
+ * Create a race context for waiting on multiple signals simultaneously.
+ *
+ * Used with a switch statement to handle whichever signal arrives first.
+ * The compiler transforms this pattern into RACE_START and RACE_SUSPEND opcodes.
+ *
+ * @returns An unknown value that gets narrowed by signal()/delay() in switch cases
+ *
+ * @example
+ * ```typescript
+ * const r = race()
+ * switch (r) {
+ *   case signal(payment.received):
+ *     // r is the payload type: { txId: string }
+ *     return { status: 'paid', txId: r.txId }
+ *
+ *   case signal(payment.failed):
+ *     return { status: 'failed', reason: r.reason }
+ *
+ *   case delay.hours(r, 24):
+ *     return { status: 'timeout' }
+ * }
+ * ```
+ */
+export function race() {
+    return {
+        [RACE_PLACEHOLDER]: true,
+    };
+}
+function createDelayMethod(unit) {
+    const multipliers = {
+        seconds: 1000,
+        minutes: 60 * 1000,
+        hours: 60 * 60 * 1000,
+        days: 24 * 60 * 60 * 1000,
+    };
+    const multiplier = multipliers[unit];
+    return function (nOrRacer, maybeN) {
+        const n = maybeN ?? nOrRacer;
+        // Validate delay duration
+        if (typeof n !== 'number' || !Number.isFinite(n)) {
+            throw new Error(`delay.${unit}() requires a finite number, got ${n}`);
+        }
+        if (n < 0) {
+            throw new Error(`delay.${unit}() requires a non-negative number, got ${n}`);
+        }
+        return {
+            [DELAY_PLACEHOLDER]: true,
+            duration: { ms: n * multiplier },
+            unit,
+        };
+    };
+}
+export const delay = {
+    seconds: createDelayMethod('seconds'),
+    minutes: createDelayMethod('minutes'),
+    hours: createDelayMethod('hours'),
+    days: createDelayMethod('days'),
+};
+// ============================================================================
+// Scope Primitive
+// ============================================================================
+/** Symbol to identify scope placeholders at runtime. Cross-realm with tests. */
+const SCOPE_PLACEHOLDER = Symbol.for('@justscale/process/scope');
+function scopeImpl(...args) {
+    if (args.length >= 2) {
+        const [first, second] = args;
+        // Signal-first form: scope(signal, entities, ?idFn)
+        if (typeof first === 'object' && first !== null && 'then' in first) {
+            return {
+                [SCOPE_PLACEHOLDER]: true,
+                type: 'signal',
+                signal: first,
+                entities: second,
+                idFn: args[2],
+            };
+        }
+        // Entities-first form: scope(entities, handler) or scope(entities, idFn/alias, handler)
+        if (typeof second === 'function') {
+            return {
+                [SCOPE_PLACEHOLDER]: true,
+                type: 'handler',
+                entities: first,
+                handler: second,
+            };
+        }
+        if (args.length >= 3 && typeof args[2] === 'function') {
+            return {
+                [SCOPE_PLACEHOLDER]: true,
+                type: 'handler',
+                entities: first,
+                idFnOrAlias: second,
+                handler: args[2],
+            };
+        }
+    }
+    throw new Error('Invalid scope() arguments');
+}
+export const scope = scopeImpl;
+/** @internal Check if a value is a scope placeholder */
+export function isScopePlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        SCOPE_PLACEHOLDER in value);
+}
+// ============================================================================
+// Internal: Runtime Detection Helpers
+// ============================================================================
+/** @internal Check if a value is a signal placeholder */
+export function isSignalPlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        SIGNAL_PLACEHOLDER in value);
+}
+/** @internal Check if a value is a race placeholder */
+export function isRacePlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        RACE_PLACEHOLDER in value);
+}
+/** @internal Check if a value is a delay placeholder */
+export function isDelayPlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        DELAY_PLACEHOLDER in value);
+}
+/** @internal Check if a value is a signal.all placeholder */
+export function isSignalAllPlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        SIGNAL_ALL_PLACEHOLDER in value);
+}
+/** @internal Check if a value is a signal.settled placeholder */
+export function isSignalSettledPlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        SIGNAL_SETTLED_PLACEHOLDER in value);
+}
+// ============================================================================
+// Stream Primitive
+// ============================================================================
+/** Symbol to identify stream placeholders at runtime. Cross-realm with tests. */
+const STREAM_PLACEHOLDER = Symbol.for('@justscale/process/stream');
+// Implementation
+function streamImpl(racer, target) {
+    return {
+        [STREAM_PLACEHOLDER]: true,
+        stream: target,
+    };
+}
+export const stream = streamImpl;
+/** @internal Check if a value is a stream placeholder */
+export function isStreamPlaceholder(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        STREAM_PLACEHOLDER in value);
+}
+//# sourceMappingURL=primitives.js.map

package/dist/process/primitives.js.map

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

package/dist/process/serialization.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Processable Protocol — unified serialization for durable processes,
+ * channels, signals, and cluster transport.
+ *
+ * Types that implement `Processable<T>` via `Symbol.process` get automatic
+ * serialization everywhere the framework persists or transmits data.
+ *
+ * - Proto types: codegen adds `[Symbol.process]` automatically
+ * - Framework builtins (Reference, Date, Map, Set, BigInt): implemented internally
+ * - User types: opt-in via `static [Symbol.process] = { name, serialize, deserialize }`
+ * - Plain types: JSON fallback (existing behavior)
+ */
+export declare function registerProcessType<T>(descriptor: ProcessDescriptor<T>): void;
+export declare function getProcessDescriptor(name: string): ProcessDescriptor | undefined;
+export declare function getProcessRegistry(): ReadonlyMap<string, ProcessDescriptor>;
+/**
+ * Runtime check: does this value (instance or schema) implement Processable?
+ */
+export declare function isProcessable(value: unknown): value is {
+    [Symbol.process]: ProcessDescriptor;
+};
+/**
+ * Check if a constructor/schema has the Processable protocol.
+ * Works with both plain objects and class constructors (static [Symbol.process]).
+ */
+export declare function hasProcessDescriptor(schema: unknown): schema is Processable;
+/**
+ * Auto-register a Processable type in the registry.
+ * Call this when a Processable type is first encountered at runtime.
+ */
+export declare function ensureRegistered(schema: Processable): void;
+/**
+ * Find the ProcessDescriptor for a value.
+ * Checks instance directly, then constructor (for class instances).
+ */
+export declare function findProcessDescriptor(value: unknown): ProcessDescriptor | undefined;
+/**
+ * Encode a value using its Processable descriptor for JSON-safe storage.
+ * Recursively walks plain objects and arrays to encode nested Processables.
+ * Returns the original value unchanged if it's not Processable and contains none.
+ *
+ * Throws if a Locked<T> value is passed — lock guarantees must not cross a
+ * wire. Unlock the value and send only the underlying reference.
+ *
+ * Throws with path context when a descriptor's serialize call fails.
+ */
+export declare function encodeProcessable(value: unknown, seen?: Set<unknown>, path?: string): unknown;
+/**
+ * Decode a value that may have been encoded via encodeProcessable.
+ * Recursively walks plain objects and arrays to decode nested Processables.
+ * Returns the original value unchanged if it wasn't encoded.
+ *
+ * When a descriptor has a `validate` function, the raw payload is checked
+ * before deserialize is called. A failing validation throws with a clear
+ * error, preventing type-confusion from mismatched __$p tags.
+ */
+export declare function decodeProcessable(value: unknown): unknown;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/process/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/process/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CA2B7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAE3E;AAcD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAE9F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CAE3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAG1D;AAmCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAUnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,GAAG,CAAC,OAAO,CAAa,EAC9B,IAAI,SAAW,GACd,OAAO,CA0CT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6CzD"}

package/dist/process/serialization.js

@@ -0,0 +1,220 @@
+/**
+ * Processable Protocol — unified serialization for durable processes,
+ * channels, signals, and cluster transport.
+ *
+ * Types that implement `Processable<T>` via `Symbol.process` get automatic
+ * serialization everywhere the framework persists or transmits data.
+ *
+ * - Proto types: codegen adds `[Symbol.process]` automatically
+ * - Framework builtins (Reference, Date, Map, Set, BigInt): implemented internally
+ * - User types: opt-in via `static [Symbol.process] = { name, serialize, deserialize }`
+ * - Plain types: JSON fallback (existing behavior)
+ */
+// Register Symbol.process on the global Symbol object (idempotent)
+;
+Symbol.process ??= Symbol.for('@justscale/process');
+/**
+ * Runtime type registry — maps descriptor names to their ProcessDescriptor.
+ * Used during deserialization to look up the right deserializer by name.
+ */
+const registry = new Map();
+export function registerProcessType(descriptor) {
+    const { name } = descriptor;
+    if (name === '') {
+        throw new Error('[Processable] Descriptor name must not be empty — a codegen bug emitting "" would silently pollute the registry');
+    }
+    if (name !== name.trim()) {
+        throw new Error(`[Processable] Descriptor name '${name}' has leading or trailing whitespace — this is almost certainly a bug`);
+    }
+    if (name === PAYLOAD_TAG) {
+        throw new Error(`[Processable] Descriptor name '${PAYLOAD_TAG}' conflicts with the envelope tag key and is reserved`);
+    }
+    if (registry.has(name)) {
+        const existing = registry.get(name);
+        if (existing !== descriptor) {
+            throw new Error(`[Processable] Duplicate registration for '${name}' — each processable type must have a unique name`);
+        }
+        return;
+    }
+    registry.set(name, descriptor);
+}
+export function getProcessDescriptor(name) {
+    return registry.get(name);
+}
+export function getProcessRegistry() {
+    return registry;
+}
+function checkProcessDescriptor(value) {
+    if (value == null)
+        return false;
+    const desc = value[Symbol.process];
+    return (desc != null &&
+        typeof desc === 'object' &&
+        typeof desc.name === 'string' &&
+        typeof desc.serialize === 'function' &&
+        typeof desc.deserialize === 'function');
+}
+/**
+ * Runtime check: does this value (instance or schema) implement Processable?
+ */
+export function isProcessable(value) {
+    return checkProcessDescriptor(value);
+}
+/**
+ * Check if a constructor/schema has the Processable protocol.
+ * Works with both plain objects and class constructors (static [Symbol.process]).
+ */
+export function hasProcessDescriptor(schema) {
+    return checkProcessDescriptor(schema);
+}
+/**
+ * Auto-register a Processable type in the registry.
+ * Call this when a Processable type is first encountered at runtime.
+ */
+export function ensureRegistered(schema) {
+    const descriptor = schema[Symbol.process];
+    registerProcessType(descriptor);
+}
+// ============================================================================
+// Payload Encoding/Decoding
+// ============================================================================
+/** Tag for Processable-encoded payloads (signals, channels) */
+const PAYLOAD_TAG = '__$p';
+/**
+ * Wire-format version. Increment this only when the envelope structure changes
+ * in a way that older decoders cannot handle. Currently:
+ *   version 1 — { __$p: name, __$v: 1, d: payload }
+ *
+ * Envelopes without __$v are treated as version 1 for backwards compatibility
+ * (any data encoded before versioning was introduced still decodes correctly).
+ */
+const ENVELOPE_VERSION = 1;
+/** Property key used by Lock<T> to carry lock metadata (defined in lock/types.ts). */
+const LOCK_KEY = '__lock';
+/**
+ * Returns true when the value looks like a Lock<T> — it carries a __lock
+ * metadata object and a Symbol.dispose slot, both assigned by LockServiceImpl.
+ */
+function isLockedValue(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        LOCK_KEY in value &&
+        Symbol.dispose in value);
+}
+/**
+ * Find the ProcessDescriptor for a value.
+ * Checks instance directly, then constructor (for class instances).
+ */
+export function findProcessDescriptor(value) {
+    if (value == null || typeof value !== 'object')
+        return undefined;
+    const desc = value[Symbol.process];
+    if (desc && typeof desc.serialize === 'function')
+        return desc;
+    const ctor = value.constructor;
+    if (ctor && ctor !== Object && ctor !== Array) {
+        const ctorDesc = ctor[Symbol.process];
+        if (ctorDesc && typeof ctorDesc.serialize === 'function')
+            return ctorDesc;
+    }
+    return undefined;
+}
+/**
+ * Encode a value using its Processable descriptor for JSON-safe storage.
+ * Recursively walks plain objects and arrays to encode nested Processables.
+ * Returns the original value unchanged if it's not Processable and contains none.
+ *
+ * Throws if a Locked<T> value is passed — lock guarantees must not cross a
+ * wire. Unlock the value and send only the underlying reference.
+ *
+ * Throws with path context when a descriptor's serialize call fails.
+ */
+export function encodeProcessable(value, seen = new Set(), path = '<root>') {
+    if (isLockedValue(value)) {
+        throw new Error(`[Processable] Cannot encode a Locked<T> value at path "${path}" — ` +
+            'lock guarantees do not survive serialization. Unlock the value and ' +
+            'send only the underlying reference or plain data.');
+    }
+    const descriptor = findProcessDescriptor(value);
+    if (descriptor) {
+        let serialized;
+        try {
+            serialized = descriptor.serialize(value);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`[Processable] encode failed at path "${path}": ${msg}`, { cause: err });
+        }
+        return { [PAYLOAD_TAG]: descriptor.name, __$v: ENVELOPE_VERSION, d: serialized };
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            throw new TypeError(`[Processable] cycle at ${path}`);
+        }
+        seen.add(value);
+        const result = value.map((item, i) => encodeProcessable(item, seen, `${path}[${i}]`));
+        seen.delete(value);
+        return result;
+    }
+    if (value !== null && typeof value === 'object') {
+        if (seen.has(value)) {
+            throw new TypeError(`[Processable] cycle at ${path}`);
+        }
+        seen.add(value);
+        const result = {};
+        for (const key of Object.keys(value)) {
+            result[key] = encodeProcessable(value[key], seen, `${path}.${key}`);
+        }
+        seen.delete(value);
+        return result;
+    }
+    return value;
+}
+/**
+ * Decode a value that may have been encoded via encodeProcessable.
+ * Recursively walks plain objects and arrays to decode nested Processables.
+ * Returns the original value unchanged if it wasn't encoded.
+ *
+ * When a descriptor has a `validate` function, the raw payload is checked
+ * before deserialize is called. A failing validation throws with a clear
+ * error, preventing type-confusion from mismatched __$p tags.
+ */
+export function decodeProcessable(value) {
+    if (value != null &&
+        typeof value === 'object' &&
+        PAYLOAD_TAG in value &&
+        typeof value[PAYLOAD_TAG] === 'string') {
+        const encoded = value;
+        const name = encoded[PAYLOAD_TAG];
+        const version = '__$v' in encoded ? encoded.__$v : 1;
+        if (version !== ENVELOPE_VERSION) {
+            throw new Error(`[Processable] Unsupported envelope version ${version} for '${name}' — ` +
+                `this runtime expects version ${ENVELOPE_VERSION}. ` +
+                'Update both encoder and decoder when bumping the version.');
+        }
+        const descriptor = getProcessDescriptor(name);
+        if (descriptor) {
+            if (typeof descriptor.validate === 'function' && !descriptor.validate(encoded.d)) {
+                throw new Error(`[Processable] Payload shape validation failed for descriptor '${name}' — ` +
+                    'the envelope\'s payload does not match the expected shape. ' +
+                    'This indicates a corrupted or forged __$p tag.');
+            }
+            return descriptor.deserialize(encoded.d);
+        }
+        throw new Error(`[Processable] Unknown descriptor '${name}' — type is not registered. ` +
+            `Call registerProcessType({ name: '${name}', ... }) before deserializing. ` +
+            'If you want permissive behaviour, catch this error and handle unknown descriptors yourself.');
+    }
+    if (Array.isArray(value)) {
+        return value.map(decodeProcessable);
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const key of Object.keys(value)) {
+            result[key] = decodeProcessable(value[key]);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/process/serialization.js.map

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