@sly-rentals/core 0.1.0

package/dist/cjs/params/amount.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * @purpose Amount parameter conversion utilities
+ *
+ * Converts user-friendly ATLAS amounts to stardust (smallest unit) for use with Solana programs.
+ * 1 ATLAS = 100,000,000 stardust (8 decimal places)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertAmount = convertAmount;
+exports.stardustToAtlas = stardustToAtlas;
+exports.formatAmount = formatAmount;
+exports.validateAmount = validateAmount;
+/**
+ * Stardust per ATLAS (8 decimal places)
+ */
+const STARDUST_PER_ATLAS = 100_000_000;
+const MAX_U64 = 18446744073709551615n;
+/**
+ * Convert amount parameter to stardust (smallest unit)
+ *
+ * @param amount - Amount in any supported format
+ * @returns Amount in stardust (u64 for Solana program)
+ * @throws Error if amount is invalid, negative, or non-integer stardust
+ *
+ * @example
+ * ```typescript
+ * convertAmount(10_000_000_000)         // 10_000_000_000n stardust (100 ATLAS)
+ * convertAmount({ atlas: 10 })          // 1_000_000_000n stardust (10 ATLAS)
+ * convertAmount({ stardust: 1_000_000 }) // 1_000_000n stardust (0.01 ATLAS)
+ * ```
+ */
+function convertAmount(amount) {
+    if (typeof amount === 'number' || typeof amount === 'bigint') {
+        return toStardustBigInt(amount, 'stardust');
+    }
+    if (typeof amount !== 'object' || amount === null) {
+        throw new Error(`Invalid amount type. Expected number, bigint, or object. Got: ${typeof amount}`);
+    }
+    if ('atlas' in amount && amount.atlas !== undefined) {
+        if (amount.atlas < 0) {
+            throw new Error(`ATLAS amount must be non-negative, got ${amount.atlas}`);
+        }
+        return toStardustBigInt(amount.atlas * STARDUST_PER_ATLAS, 'atlas');
+    }
+    if ('stardust' in amount && amount.stardust !== undefined) {
+        return toStardustBigInt(amount.stardust, 'stardust');
+    }
+    throw new Error(`Invalid amount format. Expected number, bigint, { atlas: number }, or { stardust: number | bigint }. ` +
+        `Got: ${JSON.stringify(amount)}`);
+}
+function toStardustBigInt(raw, unit) {
+    if (typeof raw === 'bigint') {
+        if (raw < 0n)
+            throw new Error(`Amount must be non-negative, got ${raw}`);
+        if (raw > MAX_U64)
+            throw new Error(`Amount too large. Max u64: ${MAX_U64}, got: ${raw}`);
+        return raw;
+    }
+    if (!Number.isFinite(raw)) {
+        throw new Error(`Amount must be a finite number, got ${raw}`);
+    }
+    if (raw < 0) {
+        throw new Error(`Amount must be non-negative, got ${raw}`);
+    }
+    // The `{ atlas: ... }` path arrives here already multiplied by 1e8 — round
+    // to absorb floating-point drift like 1.5 * 1e8 → 150000000.00000003.
+    const value = unit === 'atlas' ? Math.round(raw) : raw;
+    if (!Number.isInteger(value)) {
+        throw new Error(`Stardust must be a whole number, got ${raw}. ` +
+            `For sub-stardust precision use \`{ atlas: ${raw / STARDUST_PER_ATLAS} }\` instead.`);
+    }
+    const big = BigInt(value);
+    if (big > MAX_U64)
+        throw new Error(`Amount too large. Max u64: ${MAX_U64}, got: ${big}`);
+    return big;
+}
+/**
+ * Convert stardust to ATLAS for display
+ *
+ * @param stardust - Amount in stardust
+ * @returns Amount in ATLAS (decimal)
+ *
+ * @example
+ * ```typescript
+ * stardustToAtlas(100_000_000n)  // 1.0 ATLAS
+ * stardustToAtlas(150_000_000n)  // 1.5 ATLAS
+ * ```
+ */
+function stardustToAtlas(stardust) {
+    const stardustNum = typeof stardust === 'bigint' ? Number(stardust) : stardust;
+    return stardustNum / STARDUST_PER_ATLAS;
+}
+/**
+ * Format amount for display
+ *
+ * @param stardust - Amount in stardust
+ * @param decimals - Number of decimal places (default: 8 for full precision)
+ * @returns Formatted ATLAS amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(100_000_000n)      // "1.00000000 ATLAS"
+ * formatAmount(150_000_000n, 2)   // "1.50 ATLAS"
+ * ```
+ */
+function formatAmount(stardust, decimals = 8) {
+    const atlas = stardustToAtlas(stardust);
+    return `${atlas.toFixed(decimals)} ATLAS`;
+}
+/**
+ * Validate amount is within reasonable bounds
+ *
+ * @param stardust - Amount in stardust
+ * @param min - Minimum allowed amount in stardust (default: 0)
+ * @param max - Maximum allowed amount in stardust (default: MAX_U64)
+ * @throws Error if amount is out of bounds
+ */
+function validateAmount(stardust, min = 0n, max = 18446744073709551615n) {
+    if (stardust < min) {
+        throw new Error(`Amount too small: ${formatAmount(stardust)}. ` + `Minimum: ${formatAmount(min)}`);
+    }
+    if (stardust > max) {
+        throw new Error(`Amount too large: ${formatAmount(stardust)}. ` + `Maximum: ${formatAmount(max)}`);
+    }
+}
+//# sourceMappingURL=amount.js.map

package/dist/cjs/params/amount.js.map

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

package/dist/cjs/params/duration.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * @purpose Duration parameter conversion utilities
+ *
+ * Converts user-friendly duration formats to seconds for use with Solana programs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertDuration = convertDuration;
+exports.validateDuration = validateDuration;
+exports.formatDuration = formatDuration;
+/**
+ * Time unit conversion constants
+ */
+const SECONDS_PER_MINUTE = 60;
+const SECONDS_PER_HOUR = 3600;
+const SECONDS_PER_DAY = 86400;
+const SECONDS_PER_WEEK = 604800;
+const SECONDS_PER_MONTH = 2678400; // 31 days
+/**
+ * Convert duration parameter to seconds
+ *
+ * @param duration - Duration in any supported format
+ * @returns Duration in seconds
+ * @throws Error if duration is invalid or negative
+ *
+ * @example
+ * ```typescript
+ * convertDuration(3600)              // 3600 seconds
+ * convertDuration({ hours: 1 })      // 3600 seconds
+ * convertDuration({ days: 7 })       // 604800 seconds
+ * convertDuration({ weeks: 2 })      // 1209600 seconds
+ * ```
+ */
+function convertDuration(duration) {
+    // Handle plain number (seconds)
+    if (typeof duration === 'number') {
+        if (duration < 0) {
+            throw new Error(`Duration must be positive, got ${duration}`);
+        }
+        return Math.floor(duration);
+    }
+    // Handle object format
+    if (typeof duration === 'object' && duration !== null) {
+        if ('seconds' in duration && duration.seconds !== undefined) {
+            return Math.floor(duration.seconds);
+        }
+        if ('minutes' in duration && duration.minutes !== undefined) {
+            return Math.floor(duration.minutes * SECONDS_PER_MINUTE);
+        }
+        if ('hours' in duration && duration.hours !== undefined) {
+            return Math.floor(duration.hours * SECONDS_PER_HOUR);
+        }
+        if ('days' in duration && duration.days !== undefined) {
+            return Math.floor(duration.days * SECONDS_PER_DAY);
+        }
+        if ('weeks' in duration && duration.weeks !== undefined) {
+            return Math.floor(duration.weeks * SECONDS_PER_WEEK);
+        }
+        if ('months' in duration && duration.months !== undefined) {
+            return Math.floor(duration.months * SECONDS_PER_MONTH);
+        }
+    }
+    throw new Error(`Invalid duration format. Expected number or object with time unit. ` +
+        `Got: ${JSON.stringify(duration)}`);
+}
+/**
+ * Validate duration limits
+ *
+ * Ensures duration is within reasonable bounds for rental contracts.
+ *
+ * @param durationSeconds - Duration in seconds
+ * @param min - Minimum allowed duration (default: 1 hour)
+ * @param max - Maximum allowed duration (default: 1 year)
+ * @throws Error if duration is out of bounds
+ */
+function validateDuration(durationSeconds, min = SECONDS_PER_HOUR, max = SECONDS_PER_DAY * 365) {
+    if (durationSeconds < min) {
+        throw new Error(`Duration too short: ${durationSeconds}s. Minimum: ${min}s (${formatDuration(min)})`);
+    }
+    if (durationSeconds > max) {
+        throw new Error(`Duration too long: ${durationSeconds}s. Maximum: ${max}s (${formatDuration(max)})`);
+    }
+}
+/**
+ * Format duration in seconds to human-readable string
+ *
+ * @param seconds - Duration in seconds
+ * @returns Human-readable duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(3600)   // "1 hour"
+ * formatDuration(86400)  // "1 day"
+ * formatDuration(7200)   // "2 hours"
+ * ```
+ */
+function formatDuration(seconds) {
+    if (seconds >= SECONDS_PER_MONTH) {
+        const months = Math.floor(seconds / SECONDS_PER_MONTH);
+        return `${months} month${months > 1 ? 's' : ''}`;
+    }
+    if (seconds >= SECONDS_PER_WEEK) {
+        const weeks = Math.floor(seconds / SECONDS_PER_WEEK);
+        return `${weeks} week${weeks > 1 ? 's' : ''}`;
+    }
+    if (seconds >= SECONDS_PER_DAY) {
+        const days = Math.floor(seconds / SECONDS_PER_DAY);
+        return `${days} day${days > 1 ? 's' : ''}`;
+    }
+    if (seconds >= SECONDS_PER_HOUR) {
+        const hours = Math.floor(seconds / SECONDS_PER_HOUR);
+        return `${hours} hour${hours > 1 ? 's' : ''}`;
+    }
+    if (seconds >= SECONDS_PER_MINUTE) {
+        const minutes = Math.floor(seconds / SECONDS_PER_MINUTE);
+        return `${minutes} minute${minutes > 1 ? 's' : ''}`;
+    }
+    return `${seconds} second${seconds !== 1 ? 's' : ''}`;
+}
+//# sourceMappingURL=duration.js.map

package/dist/cjs/params/duration.js.map

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

package/dist/cjs/params/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./amount"), exports);
+__exportStar(require("./duration"), exports);
+__exportStar(require("./schedule"), exports);
+__exportStar(require("./sol"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/params/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/params/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,6CAA2B;AAC3B,wCAAsB"}

package/dist/cjs/params/schedule.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * @purpose Payment schedule parameter conversion utilities
+ *
+ * Converts user-friendly schedule formats to strings for use with Solana programs.
+ * Supports common shortcuts and cron expressions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEDULE_SHORTCUTS = void 0;
+exports.normalizeSchedule = normalizeSchedule;
+exports.validateScheduleFormat = validateScheduleFormat;
+exports.formatSchedule = formatSchedule;
+exports.isScheduleShortcut = isScheduleShortcut;
+/**
+ * Common schedule shortcuts
+ */
+exports.SCHEDULE_SHORTCUTS = [
+    '@hourly',
+    '@daily',
+    '@weekly',
+    '@monthly',
+    '@yearly',
+    '@annually',
+    '@decasecond',
+    '@minute',
+    'hourly',
+    'daily',
+    'weekly',
+    'monthly',
+    'yearly',
+    'annually',
+    'decasecond',
+    'minute',
+];
+/**
+ * Mapping of shortcuts without @ prefix to their @ equivalents
+ */
+const SHORTCUT_TO_AT_PREFIX = {
+    hourly: '@hourly',
+    daily: '@daily',
+    weekly: '@weekly',
+    monthly: '@monthly',
+    yearly: '@yearly',
+    annually: '@annually',
+    decasecond: '@decasecond',
+    minute: '@minute',
+};
+/**
+ * Basic cron expression validation pattern
+ *
+ * Supports:
+ * - Standard 5-field cron: "0 * * * *"
+ * - Extended 6-field cron with seconds: "0 0 * * * *"
+ * - @shortcuts: "@hourly", "@daily", etc.
+ */
+const CRON_PATTERN = /^(@\w+|[\d\*\/\-,]+(\s+[\d\*\/\-,]+){4,5})$/;
+/**
+ * Normalize payment schedule input to program-compatible format
+ *
+ * @param schedule - Payment schedule string
+ * @returns Normalized schedule string for Solana program
+ * @throws Error if schedule format is invalid
+ *
+ * @example
+ * ```typescript
+ * normalizeSchedule('daily')           // '@daily'
+ * normalizeSchedule('@hourly')         // '@hourly'
+ * normalizeSchedule('0 * * * *')       // '0 * * * *'
+ * normalizeSchedule('0 0 * * * *')     // '0 0 * * * *' (with seconds)
+ * ```
+ */
+function normalizeSchedule(schedule) {
+    if (!schedule || typeof schedule !== 'string') {
+        throw new Error(`Invalid schedule format. Expected string, got: ${typeof schedule}`);
+    }
+    // Trim whitespace
+    const trimmed = schedule.trim();
+    if (!trimmed) {
+        throw new Error('Schedule cannot be empty');
+    }
+    // If it already has @ prefix, validate and return
+    if (trimmed.startsWith('@')) {
+        if (!validateScheduleFormat(trimmed)) {
+            throw new Error(`Invalid schedule shortcut: ${trimmed}`);
+        }
+        return trimmed.toLowerCase();
+    }
+    // Check if it's a known shortcut without @ prefix
+    const lowerTrimmed = trimmed.toLowerCase();
+    if (lowerTrimmed in SHORTCUT_TO_AT_PREFIX) {
+        return SHORTCUT_TO_AT_PREFIX[lowerTrimmed];
+    }
+    // Otherwise treat as cron expression - validate and return as-is
+    if (!validateScheduleFormat(trimmed)) {
+        throw new Error(`Invalid schedule format. Expected @shortcut or cron expression. ` +
+            `Valid shortcuts: ${Object.keys(SHORTCUT_TO_AT_PREFIX).join(', ')}. ` +
+            `Got: "${trimmed}"`);
+    }
+    return trimmed;
+}
+/**
+ * Validate schedule format
+ *
+ * Checks if a schedule string is either:
+ * - A valid @shortcut
+ * - A valid cron expression (5 or 6 fields)
+ *
+ * @param schedule - Schedule string to validate
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * validateScheduleFormat('@daily')     // true
+ * validateScheduleFormat('0 * * * *')  // true
+ * validateScheduleFormat('invalid')    // false
+ * ```
+ */
+function validateScheduleFormat(schedule) {
+    if (!schedule || typeof schedule !== 'string') {
+        return false;
+    }
+    const trimmed = schedule.trim();
+    // Check if it's a @shortcut
+    if (trimmed.startsWith('@')) {
+        const shortcut = trimmed.toLowerCase();
+        return exports.SCHEDULE_SHORTCUTS.includes(shortcut);
+    }
+    // Check if it matches cron pattern
+    return CRON_PATTERN.test(trimmed);
+}
+/**
+ * Convert schedule string to human-readable description
+ *
+ * @param schedule - Normalized schedule string
+ * @returns Human-readable description
+ *
+ * @example
+ * ```typescript
+ * formatSchedule('@daily')     // "Daily"
+ * formatSchedule('@hourly')    // "Hourly"
+ * formatSchedule('0 * * * *')  // "Custom: 0 * * * *"
+ * ```
+ */
+function formatSchedule(schedule) {
+    const trimmed = schedule.trim().toLowerCase();
+    // Handle @shortcuts
+    if (trimmed.startsWith('@')) {
+        const shortcut = trimmed.slice(1); // Remove @
+        return shortcut.charAt(0).toUpperCase() + shortcut.slice(1);
+    }
+    // Handle cron expressions
+    return `Custom: ${trimmed}`;
+}
+/**
+ * Check if a schedule is a known shortcut
+ *
+ * @param schedule - Schedule string to check
+ * @returns True if it's a shortcut (with or without @)
+ */
+function isScheduleShortcut(schedule) {
+    const lower = schedule.toLowerCase();
+    return exports.SCHEDULE_SHORTCUTS.includes(lower);
+}
+//# sourceMappingURL=schedule.js.map

package/dist/cjs/params/schedule.js.map

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

package/dist/cjs/params/sol.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @purpose SOL parameter conversion utilities
+ *
+ * Converts user-friendly SOL amounts to lamports (smallest unit) for use with Solana programs.
+ * 1 SOL = 1,000,000,000 lamports (9 decimal places)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertSol = convertSol;
+/**
+ * Lamports per SOL (9 decimal places)
+ */
+const LAMPORTS_PER_SOL = 1_000_000_000;
+const MAX_U64 = 18446744073709551615n;
+/**
+ * Convert SOL parameter to lamports (smallest unit)
+ *
+ * @param amount - Amount in any supported format
+ * @returns Amount in lamports as bigint (u64 for Solana program)
+ * @throws Error if amount is invalid, negative, or non-integer lamports
+ *
+ * @example
+ * ```typescript
+ * convertSol(10_000_000)               // 10_000_000n lamports (0.01 SOL)
+ * convertSol({ sol: 0.1 })             // 100_000_000n lamports (0.1 SOL)
+ * convertSol({ lamports: 10_000_000 }) // 10_000_000n lamports
+ * ```
+ */
+function convertSol(amount) {
+    // Bare number / bigint — treat as lamports.
+    if (typeof amount === 'number' || typeof amount === 'bigint') {
+        return toLamportsBigInt(amount, 'lamports');
+    }
+    if (typeof amount !== 'object' || amount === null) {
+        throw new Error(`Invalid SOL amount type. Expected number, bigint, or object. Got: ${typeof amount}`);
+    }
+    if ('sol' in amount && amount.sol !== undefined) {
+        if (amount.sol < 0) {
+            throw new Error(`SOL amount must be non-negative, got ${amount.sol}`);
+        }
+        return toLamportsBigInt(amount.sol * LAMPORTS_PER_SOL, 'sol');
+    }
+    if ('lamports' in amount && amount.lamports !== undefined) {
+        return toLamportsBigInt(amount.lamports, 'lamports');
+    }
+    throw new Error(`Invalid SOL amount format. Expected number, bigint, { sol: number }, or { lamports: number | bigint }. ` +
+        `Got: ${JSON.stringify(amount)}`);
+}
+function toLamportsBigInt(raw, unit) {
+    if (typeof raw === 'bigint') {
+        if (raw < 0n)
+            throw new Error(`Amount must be non-negative, got ${raw}`);
+        if (raw > MAX_U64)
+            throw new Error(`Amount too large. Max u64: ${MAX_U64}, got: ${raw}`);
+        return raw;
+    }
+    if (!Number.isFinite(raw)) {
+        throw new Error(`Amount must be a finite number, got ${raw}`);
+    }
+    if (raw < 0) {
+        throw new Error(`Amount must be non-negative, got ${raw}`);
+    }
+    // Bare numbers + { lamports } must be integers (lamports are atomic).
+    // The `{ sol: ... }` path arrives here already multiplied by 1e9 — round
+    // down to absorb floating-point drift like 0.1 * 1e9 → 99999999.99999999.
+    const value = unit === 'sol' ? Math.round(raw) : raw;
+    if (!Number.isInteger(value)) {
+        throw new Error(`Lamports must be a whole number, got ${raw}. ` +
+            `For sub-lamport precision use \`{ sol: ${raw / LAMPORTS_PER_SOL} }\` instead.`);
+    }
+    const big = BigInt(value);
+    if (big > MAX_U64)
+        throw new Error(`Amount too large. Max u64: ${MAX_U64}, got: ${big}`);
+    return big;
+}
+//# sourceMappingURL=sol.js.map

package/dist/cjs/params/sol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sol.js","sourceRoot":"","sources":["../../../src/params/sol.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAyCH,gCA2BC;AAhDD;;GAEG;AACH,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC,MAAM,OAAO,GAAG,qBAA2B,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CAAC,MAAgB;IACzC,4CAA4C;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7D,OAAO,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,qEAAqE,OAAO,MAAM,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAChD,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,GAAG,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,UAAU,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yGAAyG;QACvG,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAoB,EAAE,IAAwB;IACtE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,GAAG,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;QACzE,IAAI,GAAG,GAAG,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC;QACzF,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,sEAAsE;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,IAAI;YAC7C,0CAA0C,GAAG,GAAG,gBAAgB,eAAe,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,GAAG,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC;IACzF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cjs/pda/constants.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Constants used for PDA derivation across SRSLY, SAGE, and Thread programs
+ * @module pda/constants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THREAD_FIBER_SEED = exports.THREAD_SEED = exports.ANTEGEN_FIBER_PROGRAM = exports.ANTEGEN_THREAD_PROGRAM = exports.QUEUED_RENTAL_SEED = exports.ACTIVE_RENTAL_SEED = exports.CONFIG_SEED = exports.BORROWER_STATE_SEED = exports.RENTAL_AUTHORITY_SEED = exports.RENTAL_SEED = exports.CONTRACT_SEED = exports.PROFILE_FACTION_SEED = exports.SAGE_PLAYER_PROFILE_SEED = exports.STARBASE_PLAYER_SEED = exports.STARBASE_SEED = exports.FACTION_MAPPING = exports.FACTION_COORDINATES = void 0;
+exports.isValidFactionName = isValidFactionName;
+exports.getFactionName = getFactionName;
+exports.getFactionCoordinates = getFactionCoordinates;
+/**
+ * Faction-specific coordinates for starbase derivation in SAGE
+ * These coordinates are used to derive starbase PDAs
+ */
+exports.FACTION_COORDINATES = {
+    mud: { x: 0, y: -39 },
+    oni: { x: -40, y: 30 },
+    ustur: { x: 40, y: 30 },
+};
+/**
+ * Mapping of numeric faction IDs to faction names
+ */
+exports.FACTION_MAPPING = {
+    1: 'mud',
+    2: 'oni',
+    3: 'ustur',
+};
+/**
+ * Seed constants for SAGE program PDA derivation
+ */
+exports.STARBASE_SEED = 'Starbase';
+exports.STARBASE_PLAYER_SEED = 'starbase_player';
+exports.SAGE_PLAYER_PROFILE_SEED = 'sage_player_profile';
+exports.PROFILE_FACTION_SEED = 'player_faction';
+/**
+ * Seed constants for SRSLY program PDA derivation
+ */
+exports.CONTRACT_SEED = 'rental_contract';
+exports.RENTAL_SEED = 'rental_state';
+exports.RENTAL_AUTHORITY_SEED = 'rental_authority';
+exports.BORROWER_STATE_SEED = 'borrower_state';
+exports.CONFIG_SEED = 'config';
+exports.ACTIVE_RENTAL_SEED = 'active';
+exports.QUEUED_RENTAL_SEED = 'queued';
+/**
+ * Antegen program addresses and seed constants for PDA derivation
+ */
+exports.ANTEGEN_THREAD_PROGRAM = 'AgTv5w1UvUb6zeqkThwMrztGu9hpepBu8YLghuR4dpSx';
+exports.ANTEGEN_FIBER_PROGRAM = 'AgFv5afjW9DmSPkiEvJ1er5bAAmRUqaBeTB6Cr8e1hKx';
+exports.THREAD_SEED = 'thread';
+exports.THREAD_FIBER_SEED = 'thread_fiber';
+/**
+ * Type guard to check if a value is a valid faction name
+ */
+function isValidFactionName(faction) {
+    return faction === 'mud' || faction === 'oni' || faction === 'ustur';
+}
+/**
+ * Get faction name from numeric faction ID
+ */
+function getFactionName(factionId) {
+    const name = exports.FACTION_MAPPING[factionId];
+    if (!name) {
+        throw new Error(`Invalid faction ID: ${factionId}. Expected 1 (mud), 2 (oni), or 3 (ustur)`);
+    }
+    return name;
+}
+/**
+ * Get faction coordinates by name
+ */
+function getFactionCoordinates(faction) {
+    const coords = exports.FACTION_COORDINATES[faction.toLowerCase()];
+    if (!coords) {
+        throw new Error(`Invalid faction: ${faction}. Expected 'mud', 'oni', or 'ustur'`);
+    }
+    return coords;
+}
+//# sourceMappingURL=constants.js.map

package/dist/cjs/pda/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/pda/constants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmDH,gDAEC;AAKD,wCAMC;AAKD,sDAMC;AAzED;;;GAGG;AACU,QAAA,mBAAmB,GAA6C;IAC3E,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;IACtB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;CACxB,CAAC;AAEF;;GAEG;AACU,QAAA,eAAe,GAA2B;IACrD,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,OAAO;CACX,CAAC;AAEF;;GAEG;AACU,QAAA,aAAa,GAAG,UAAU,CAAC;AAC3B,QAAA,oBAAoB,GAAG,iBAAiB,CAAC;AACzC,QAAA,wBAAwB,GAAG,qBAAqB,CAAC;AACjD,QAAA,oBAAoB,GAAG,gBAAgB,CAAC;AAErD;;GAEG;AACU,QAAA,aAAa,GAAG,iBAAiB,CAAC;AAClC,QAAA,WAAW,GAAG,cAAc,CAAC;AAC7B,QAAA,qBAAqB,GAAG,kBAAkB,CAAC;AAC3C,QAAA,mBAAmB,GAAG,gBAAgB,CAAC;AACvC,QAAA,WAAW,GAAG,QAAQ,CAAC;AACvB,QAAA,kBAAkB,GAAG,QAAQ,CAAC;AAC9B,QAAA,kBAAkB,GAAG,QAAQ,CAAC;AAE3C;;GAEG;AACU,QAAA,sBAAsB,GAAG,8CAA8C,CAAC;AACxE,QAAA,qBAAqB,GAAG,8CAA8C,CAAC;AACvE,QAAA,WAAW,GAAG,QAAQ,CAAC;AACvB,QAAA,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,OAAO,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAC9C,MAAM,IAAI,GAAG,uBAAe,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,2CAA2C,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,MAAM,GAAG,2BAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,qCAAqC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}