@carmaclouds/core 2.3.1

package/dist/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY,CAAC,CAAC,GAAG,GAAG;IAC/B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,KAAK,CAAU;gBAEX,OAAO,GAAE,mBAAwB;IAgB7C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA2B1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAY/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAgBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/cache/CacheManager.js

@@ -0,0 +1,131 @@
+/**
+ * Generic Cache Manager for CarmaClouds
+ * Reduces database egress costs with configurable TTL caching
+ */
+export class CacheManager {
+    constructor(options = {}) {
+        this.cache = new Map();
+        this.expiryMs = options.expiryMs || 15 * 60 * 1000; // Default 15 minutes
+        this.debug = options.debug || false;
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            stores: 0,
+            invalidations: 0
+        };
+        // Auto-cleanup expired entries
+        const cleanupInterval = options.cleanupIntervalMs || 5 * 60 * 1000;
+        this.cleanupInterval = setInterval(() => this.cleanupExpired(), cleanupInterval);
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        // Check if expired
+        const now = Date.now();
+        if (now - entry.timestamp >= this.expiryMs) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            if (this.debug) {
+                console.log(`⏰ [Cache] Expired: ${key}`);
+            }
+            return null;
+        }
+        this.stats.hits++;
+        if (this.debug) {
+            const age = Math.floor((now - entry.timestamp) / 1000);
+            console.log(`✅ [Cache] Hit: ${key} (age: ${age}s)`);
+        }
+        return entry.data;
+    }
+    /**
+     * Store value in cache
+     */
+    set(key, data) {
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now()
+        });
+        this.stats.stores++;
+        if (this.debug) {
+            console.log(`📦 [Cache] Stored: ${key}`);
+        }
+    }
+    /**
+     * Check if key exists and is valid
+     */
+    has(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * Delete specific cache entry
+     */
+    delete(key) {
+        const deleted = this.cache.delete(key);
+        if (deleted) {
+            this.stats.invalidations++;
+            if (this.debug) {
+                console.log(`🗑️ [Cache] Invalidated: ${key}`);
+            }
+        }
+        return deleted;
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        if (this.debug) {
+            console.log(`🗑️ [Cache] Cleared ${size} entries`);
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const hitRate = this.stats.hits + this.stats.misses > 0
+            ? ((this.stats.hits / (this.stats.hits + this.stats.misses)) * 100).toFixed(2)
+            : '0';
+        return {
+            size: this.cache.size,
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            stores: this.stats.stores,
+            invalidations: this.stats.invalidations,
+            hitRate: `${hitRate}%`,
+            expiryMinutes: this.expiryMs / 60000
+        };
+    }
+    /**
+     * Cleanup expired cache entries
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp >= this.expiryMs) {
+                this.cache.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0 && this.debug) {
+            console.log(`🧹 [Cache] Cleaned up ${cleaned} expired entries`);
+        }
+    }
+    /**
+     * Destroy cache manager (cleanup interval)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        this.clear();
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @carmaclouds/core
+ * Shared utilities and types for CarmaClouds packages
+ *
+ * Note: This package contains both TypeScript and JavaScript modules.
+ * The TypeScript modules are exported below. The JavaScript modules
+ * (common/, lib/, modules/) are available in the package but not
+ * exported from the main entry point as they're primarily used by
+ * browser extensions via importScripts.
+ */
+export * from './types/character';
+export * from './ir';
+export * from './render';
+export * from './cache/CacheManager';
+export { CacheManager } from './cache/CacheManager';
+export * from './supabase/fields';
+export { FIELD_SETS } from './supabase/fields';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AAGzB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @carmaclouds/core
+ * Shared utilities and types for CarmaClouds packages
+ *
+ * Note: This package contains both TypeScript and JavaScript modules.
+ * The TypeScript modules are exported below. The JavaScript modules
+ * (common/, lib/, modules/) are available in the package but not
+ * exported from the main entry point as they're primarily used by
+ * browser extensions via importScripts.
+ */
+// Types
+export * from './types/character';
+// System-agnostic IR (rebuild) - see REBUILD.md
+export * from './ir';
+export * from './render';
+// Cache Manager
+export * from './cache/CacheManager';
+export { CacheManager } from './cache/CacheManager';
+// Supabase Field Definitions
+export * from './supabase/fields';
+export { FIELD_SETS } from './supabase/fields';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,QAAQ;AACR,cAAc,mBAAmB,CAAC;AAElC,gDAAgD;AAChD,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AAEzB,gBAAgB;AAChB,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,6BAA6B;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ir/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * System-agnostic IR for DiceCloud characters. See REBUILD.md.
+ */
+export * from './types';
+export { normalize } from './normalize';
+export { deriveDnd, DND_ABILITIES } from './views/dnd5e';
+export type { Dnd5eView, AbilityView, PoolView, HitDicePool } from './views/dnd5e';
+export { IR_VERSION, toIRRow } from './persistence';
+export type { IRRow } from './persistence';
+export { upsertCharacterIR } from './sync';
+//# sourceMappingURL=index.d.ts.map

package/dist/ir/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ir/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/ir/index.js

@@ -0,0 +1,9 @@
+/**
+ * System-agnostic IR for DiceCloud characters. See REBUILD.md.
+ */
+export * from './types';
+export { normalize } from './normalize';
+export { deriveDnd, DND_ABILITIES } from './views/dnd5e';
+export { IR_VERSION, toIRRow } from './persistence';
+export { upsertCharacterIR } from './sync';
+//# sourceMappingURL=index.js.map

package/dist/ir/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ir/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/ir/normalize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * normalize(raw) -> IRCharacter
+ *
+ * Pure transform from a raw DiceCloud API response into the system-agnostic IR.
+ * No D&D assumptions: every attribute is carried with its type/reset, every
+ * action/spell keeps its real uses + consumed resources.
+ */
+import type { IRCharacter, RawDiceCloud } from './types';
+export declare function normalize(raw: RawDiceCloud): IRCharacter;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/ir/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/ir/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAGV,WAAW,EAKX,YAAY,EAEb,MAAM,SAAS,CAAC;AAsLjB,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CA6CxD"}

package/dist/ir/normalize.js

@@ -0,0 +1,207 @@
+const DND_ABILITIES = [
+    'strength', 'dexterity', 'constitution', 'intelligence', 'wisdom', 'charisma',
+];
+/**
+ * Best-effort system hint (never load-bearing). PF2e also uses the six abilities,
+ * so we additionally require D&D-5e-specific signals: a single proficiencyBonus
+ * variable and a class-based hit-dice attribute.
+ */
+function detectSystem(byVar) {
+    const hasAbilities = DND_ABILITIES.every((ab) => byVar[ab]);
+    const hasProfBonus = !!byVar['proficiencyBonus'];
+    const hasHitDice = Object.values(byVar).some((a) => a.type === 'hitDice');
+    return hasAbilities && hasProfBonus && hasHitDice ? 'dnd5e' : 'generic';
+}
+/** Coerce a DiceCloud value (number, calculation object, or string) to a number. */
+function numOf(v) {
+    if (v == null)
+        return 0;
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : 0;
+    if (typeof v === 'object')
+        return numOf(v.value ?? v.total ?? 0);
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+}
+/** True when a DiceCloud calculation/value is actually present (not just absent). */
+function has(v) {
+    return v != null && !(typeof v === 'object' && v.value == null && v.total == null);
+}
+/** Pull display text out of a DiceCloud description ({ text } | { value } | string). */
+function textOf(d) {
+    if (!d)
+        return undefined;
+    if (typeof d === 'string')
+        return d || undefined;
+    return d.text ?? d.value ?? undefined;
+}
+function resetOf(p) {
+    return p.reset ?? null;
+}
+/** Whether a property has been soft-deleted (truly gone). */
+function isRemoved(p) {
+    return !p || p.removed === true;
+}
+/**
+ * Whether a property is currently active. Deactivated properties (e.g. an
+ * unprepared spell, a toggled-off feature) are still imported - we carry this
+ * flag so adapters can grey them out rather than dropping data.
+ */
+function activeOf(p) {
+    return !p.inactive && !p.deactivatedBySelf && !p.deactivatedByAncestor;
+}
+function normalizeAttribute(p) {
+    const value = numOf(p.value);
+    const total = numOf(p.total);
+    const damage = numOf(p.damage);
+    const attr = {
+        id: p._id,
+        name: p.name ?? p.variableName ?? '',
+        variableName: p.variableName ?? '',
+        type: p.attributeType ?? 'stat',
+        value,
+        total,
+        damage,
+        reset: resetOf(p),
+        active: activeOf(p),
+        tags: Array.isArray(p.tags) ? p.tags : [],
+        description: textOf(p.description),
+    };
+    if (p.attributeType === 'ability') {
+        attr.modifier = has(p.modifier) ? numOf(p.modifier) : Math.floor((value - 10) / 2);
+    }
+    if (p.attributeType === 'hitDice' && p.hitDiceSize) {
+        attr.hitDiceSize = String(p.hitDiceSize);
+    }
+    if (p.attributeType === 'spellSlot' && has(p.spellSlotLevel)) {
+        attr.spellSlotLevel = numOf(p.spellSlotLevel);
+    }
+    return attr;
+}
+function normalizeSkill(p) {
+    return {
+        id: p._id,
+        name: p.name ?? p.variableName ?? '',
+        variableName: p.variableName ?? '',
+        skillType: p.skillType ?? 'skill',
+        value: numOf(p.value),
+        ability: p.ability || undefined,
+        proficiency: numOf(p.proficiency),
+        active: activeOf(p),
+        tags: Array.isArray(p.tags) ? p.tags : [],
+    };
+}
+function normalizeItem(p) {
+    return {
+        id: p._id,
+        name: p.name ?? '',
+        plural: p.plural || undefined,
+        quantity: p.quantity != null ? numOf(p.quantity) : 1,
+        equipped: !!p.equipped,
+        weight: has(p.weight) ? numOf(p.weight) : undefined,
+        value: has(p.value) ? numOf(p.value) : undefined,
+        description: textOf(p.description),
+        tags: Array.isArray(p.tags) ? p.tags : [],
+    };
+}
+function consumesOf(p) {
+    const consumed = p.resources?.attributesConsumed;
+    if (!Array.isArray(consumed))
+        return [];
+    return consumed.map((c) => ({
+        variableName: c.variableName || undefined,
+        propertyId: c._id || c.variableId || undefined,
+        amount: numOf(c.quantity ?? c.amount ?? 1),
+    }));
+}
+function normalizeAction(p, damageByParent) {
+    const kind = p.type === 'spell' ? 'spell' : p.type === 'feature' ? 'feature' : 'action';
+    const damage = (damageByParent[p._id] ?? [])
+        .map((d) => ({
+        formula: d.amount?.calculation ?? String(d.amount?.value ?? ''),
+        type: d.damageType || undefined,
+    }))
+        .filter((d) => d.formula);
+    const action = {
+        id: p._id,
+        name: p.name ?? '',
+        kind,
+        active: activeOf(p),
+        consumes: consumesOf(p),
+        damage,
+        tags: Array.isArray(p.tags) ? p.tags : [],
+        description: textOf(p.description),
+    };
+    const max = numOf(p.uses);
+    if (has(p.uses) && max > 0) {
+        const current = has(p.usesLeft) ? numOf(p.usesLeft) : Math.max(0, max - numOf(p.usesUsed));
+        action.uses = { current, max, reset: resetOf(p) };
+    }
+    if (has(p.attackRoll)) {
+        action.attack = { bonus: numOf(p.attackRoll) };
+    }
+    if (kind === 'spell') {
+        action.spell = {
+            level: numOf(p.level),
+            school: p.school || undefined,
+            castingTime: p.castingTime || undefined,
+            range: p.range || undefined,
+            duration: p.duration || undefined,
+            components: p.components || undefined,
+            concentration: p.components?.concentration ?? undefined,
+            ritual: p.components?.ritual ?? undefined,
+        };
+    }
+    return action;
+}
+/** Whether a property should appear in `actions` (things that do something). */
+function isActionLike(p) {
+    if (p.type === 'action' || p.type === 'spell')
+        return true;
+    // Include only features that have a limited-use pool (e.g. Channel Divinity).
+    if (p.type === 'feature')
+        return has(p.uses) && numOf(p.uses) > 0;
+    return false;
+}
+export function normalize(raw) {
+    var _a;
+    // Accept both the REST API shape ({ creatures[], creatureProperties[] }) and the
+    // extension's internal shape ({ creature, properties[] }).
+    const creature = raw?.creatures?.[0] ?? raw?.creature ?? {};
+    const allProps = raw?.creatureProperties ?? raw?.properties ?? [];
+    const props = allProps.filter((p) => !isRemoved(p));
+    const attributes = props
+        .filter((p) => p.type === 'attribute')
+        .map(normalizeAttribute);
+    const skills = props
+        .filter((p) => p.type === 'skill')
+        .map(normalizeSkill);
+    // Damage is stored as child `damage` properties pointing at their action/spell.
+    const damageByParent = {};
+    for (const p of props) {
+        if (p.type === 'damage' && p.parent?.id) {
+            (damageByParent[_a = p.parent.id] ?? (damageByParent[_a] = [])).push(p);
+        }
+    }
+    const actions = props.filter(isActionLike).map((p) => normalizeAction(p, damageByParent));
+    const inventory = props
+        .filter((p) => p.type === 'item')
+        .map(normalizeItem);
+    const byVar = {};
+    for (const a of attributes) {
+        if (a.variableName)
+            byVar[a.variableName] = a;
+    }
+    return {
+        id: creature._id ?? '',
+        name: creature.name ?? '',
+        portrait: creature.picture || creature.avatarPicture || undefined,
+        systemHint: detectSystem(byVar),
+        attributes,
+        skills,
+        actions,
+        inventory,
+        byVar,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/ir/normalize.js.map

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

package/dist/ir/persistence.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Persistence shape for the clouds_character_ir table (see the matching SQL
+ * migration). The IR is already plain JSON, so this just frames the upsert row
+ * and stamps the schema version.
+ */
+import type { IRCharacter, RawDiceCloud } from './types';
+/** Bump when the IR shape changes in a way consumers must migrate for. */
+export declare const IR_VERSION = 1;
+export interface IRRow {
+    dicecloud_character_id: string;
+    character_name: string;
+    system_hint: string;
+    ir: IRCharacter;
+    ir_version: number;
+    raw?: RawDiceCloud;
+}
+/**
+ * Build the row to upsert into clouds_character_ir.
+ *
+ *   supabase.from('clouds_character_ir')
+ *     .upsert(toIRRow(normalize(raw), raw), { onConflict: 'dicecloud_character_id' })
+ *
+ * Pass `raw` to keep a re-normalizable snapshot; omit it to store IR only.
+ */
+export declare function toIRRow(ir: IRCharacter, raw?: RawDiceCloud): IRRow;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/ir/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/ir/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,0EAA0E;AAC1E,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,MAAM,WAAW,KAAK;IACpB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,WAAW,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,KAAK,CASlE"}

package/dist/ir/persistence.js

@@ -0,0 +1,21 @@
+/** Bump when the IR shape changes in a way consumers must migrate for. */
+export const IR_VERSION = 1;
+/**
+ * Build the row to upsert into clouds_character_ir.
+ *
+ *   supabase.from('clouds_character_ir')
+ *     .upsert(toIRRow(normalize(raw), raw), { onConflict: 'dicecloud_character_id' })
+ *
+ * Pass `raw` to keep a re-normalizable snapshot; omit it to store IR only.
+ */
+export function toIRRow(ir, raw) {
+    return {
+        dicecloud_character_id: ir.id,
+        character_name: ir.name,
+        system_hint: ir.systemHint,
+        ir,
+        ir_version: IR_VERSION,
+        ...(raw ? { raw } : {}),
+    };
+}
+//# sourceMappingURL=persistence.js.map

package/dist/ir/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/ir/persistence.ts"],"names":[],"mappings":"AAOA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAW5B;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,EAAe,EAAE,GAAkB;IACzD,OAAO;QACL,sBAAsB,EAAE,EAAE,CAAC,EAAE;QAC7B,cAAc,EAAE,EAAE,CAAC,IAAI;QACvB,WAAW,EAAE,EAAE,CAAC,UAAU;QAC1B,EAAE;QACF,UAAU,EAAE,UAAU;QACtB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxB,CAAC;AACJ,CAAC"}

package/dist/ir/sync.d.ts

@@ -0,0 +1,12 @@
+import type { IRCharacter, RawDiceCloud } from './types';
+export interface SupabaseRestTarget {
+    url: string;
+    anonKey: string;
+}
+/**
+ * Normalize raw DiceCloud data and upsert it into clouds_character_ir.
+ * Returns the IR. Throws on a real upsert error; callers should treat IR sync as
+ * non-fatal (wrap in try/catch) so it never blocks the legacy sync.
+ */
+export declare function upsertCharacterIR(raw: RawDiceCloud, target: SupabaseRestTarget): Promise<IRCharacter>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/ir/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/ir/sync.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAsBtB"}

package/dist/ir/sync.js

@@ -0,0 +1,36 @@
+/**
+ * Write the system-agnostic IR to Supabase. Called from each sync path alongside
+ * the existing clouds_characters write, so the rebuild's data flows into its own
+ * table without disturbing the legacy path. See REBUILD.md.
+ *
+ * Uses the Supabase REST API via fetch so it works everywhere the extension runs
+ * (background service worker, content scripts, popups) regardless of whether a
+ * supabase-js client is in scope.
+ */
+import { normalize } from './normalize';
+import { toIRRow } from './persistence';
+/**
+ * Normalize raw DiceCloud data and upsert it into clouds_character_ir.
+ * Returns the IR. Throws on a real upsert error; callers should treat IR sync as
+ * non-fatal (wrap in try/catch) so it never blocks the legacy sync.
+ */
+export async function upsertCharacterIR(raw, target) {
+    const ir = normalize(raw);
+    if (!ir.id)
+        throw new Error('upsertCharacterIR: normalized IR has no character id');
+    const res = await fetch(`${target.url}/rest/v1/clouds_character_ir?on_conflict=dicecloud_character_id`, {
+        method: 'POST',
+        headers: {
+            apikey: target.anonKey,
+            Authorization: `Bearer ${target.anonKey}`,
+            'Content-Type': 'application/json',
+            Prefer: 'resolution=merge-duplicates,return=minimal',
+        },
+        body: JSON.stringify(toIRRow(ir)),
+    });
+    if (!res.ok) {
+        throw new Error(`clouds_character_ir upsert failed: ${res.status} ${await res.text()}`);
+    }
+    return ir;
+}
+//# sourceMappingURL=sync.js.map

package/dist/ir/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/ir/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAQxC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAiB,EACjB,MAA0B;IAE1B,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAEpF,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,MAAM,CAAC,GAAG,iEAAiE,EAC9E;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,aAAa,EAAE,UAAU,MAAM,CAAC,OAAO,EAAE;YACzC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,4CAA4C;SACrD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;KAClC,CACF,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}