@wuwei-labs/srsly 2.0.0-beta.7 → 2.3.3-canary.36.16828734028.0

package/dist/cjs/utils/payment-frequency.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * @purpose Payment frequency conversion utilities mirroring Rust implementation
+ * @reviewed 2025-07-29
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentFrequencyToSeconds = paymentFrequencyToSeconds;
+exports.calculateDurationForPeriods = calculateDurationForPeriods;
+exports.paymentFrequencyStringToSeconds = paymentFrequencyStringToSeconds;
+exports.validateDurationAlignment = validateDurationAlignment;
+exports.normalizePaymentSchedule = normalizePaymentSchedule;
+const payment_frequency_1 = require("../types/payment-frequency");
+const payment_frequency_2 = require("../types/payment-frequency");
+const cron_1 = require("./cron");
+/**
+ * Payment frequency conversion utilities
+ * Mirrors the Rust implementation in programs/srsly/src/utils.rs
+ * Uses auto-generated constants and mappings from Rust source
+ */
+// Auto-synced constants from Rust constants.rs
+const { SECONDS_PER_DECASECOND, SECONDS_PER_MINUTE, SECONDS_PER_HOUR, SECONDS_PER_DAY, SECONDS_PER_WEEK, SECONDS_PER_MONTH, } = payment_frequency_2.PAYMENT_FREQUENCY_CONSTANTS;
+/**
+ * Converts a PaymentFrequency enum value to seconds
+ * @deprecated Use calculateDurationForPeriods with cron expressions instead
+ * Kept for backwards compatibility only
+ */
+function paymentFrequencyToSeconds(frequency) {
+    switch (frequency) {
+        case payment_frequency_1.PaymentFrequency.Decasecond:
+            return SECONDS_PER_DECASECOND;
+        case payment_frequency_1.PaymentFrequency.Minute:
+            return SECONDS_PER_MINUTE;
+        case payment_frequency_1.PaymentFrequency.Hourly:
+            return SECONDS_PER_HOUR;
+        case payment_frequency_1.PaymentFrequency.Daily:
+        case payment_frequency_1.PaymentFrequency.DailyOld:
+            return SECONDS_PER_DAY;
+        case payment_frequency_1.PaymentFrequency.Weekly:
+            return SECONDS_PER_WEEK;
+        case payment_frequency_1.PaymentFrequency.Monthly:
+            return SECONDS_PER_MONTH;
+        case payment_frequency_1.PaymentFrequency.Custom:
+            throw new Error('Custom payment frequency does not have a fixed interval. Use cron expression to calculate.');
+        default:
+            throw new Error(`Unknown payment frequency: ${frequency}`);
+    }
+}
+/**
+ * Calculate duration in seconds for a given number of payment periods
+ * Uses cron parsing for accurate calculation with any schedule
+ * Mirrors Rust's calculate_duration_for_periods function
+ */
+function calculateDurationForPeriods(schedule, periods, fromTimestamp = Math.floor(Date.now() / 1000)) {
+    if (!(0, cron_1.validateCronExpression)(schedule)) {
+        throw new Error(`Invalid payment schedule: ${schedule}`);
+    }
+    const { times } = (0, cron_1.calculatePaymentSchedule)(schedule, fromTimestamp, 365 * 24 * 60 * 60, periods);
+    if (times.length < periods) {
+        throw new Error(`Could not calculate ${periods} payments within a year for schedule: ${schedule}`);
+    }
+    // Return duration from start to the Nth payment
+    return times[periods - 1] - fromTimestamp;
+}
+/**
+ * Converts a payment frequency string to seconds
+ * @deprecated Use calculateDurationForPeriods with the actual schedule string
+ * Kept for backwards compatibility only
+ */
+function paymentFrequencyStringToSeconds(frequencyString) {
+    // Strip @ prefix if present (contracts store as "@daily", "@hourly", etc.)
+    const normalizedFrequency = frequencyString.startsWith('@')
+        ? frequencyString.slice(1)
+        : frequencyString;
+    const frequency = payment_frequency_2.PAYMENT_FREQUENCY_MAP[normalizedFrequency];
+    if (frequency === undefined) {
+        throw new Error(`Invalid payment frequency string: ${frequencyString} (normalized: ${normalizedFrequency})`);
+    }
+    return paymentFrequencyToSeconds(frequency);
+}
+/**
+ * Validates that a duration is a multiple of the payment frequency
+ * @deprecated No longer needed with period-based durations
+ * Periods are always aligned by definition
+ */
+function validateDurationAlignment(duration, frequencyString) {
+    // With period-based durations, alignment is automatic
+    // This function is kept for backwards compatibility only
+    return;
+}
+/**
+ * Normalizes payment schedule input to a cron expression.
+ * Now that cron-parser handles @ shortcuts natively, we just validate and normalize.
+ *
+ * @param input - Payment schedule (e.g., '@daily', 'daily', '0 0 * * *')
+ * @returns Normalized schedule string for the Rust program
+ */
+function normalizePaymentSchedule(input) {
+    // Common shortcuts without @ prefix (for backwards compatibility)
+    const shortcutsWithoutAt = ['hourly', 'daily', 'weekly', 'monthly', 'yearly', 'annually', 'decasecond', 'minute'];
+    // Add @ prefix if it's a known shortcut without @
+    const lowerInput = input.toLowerCase();
+    if (shortcutsWithoutAt.includes(lowerInput)) {
+        input = `@${lowerInput}`;
+    }
+    // Validate the expression
+    if (!(0, cron_1.validateCronExpression)(input)) {
+        throw new Error(`Invalid payment schedule: ${input}`);
+    }
+    return input;
+}
+//# sourceMappingURL=payment-frequency.js.map

package/dist/cjs/utils/payment-frequency.js.map

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

package/dist/cjs/utils/schedule-builder.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * @purpose Fluent API for building and previewing payment schedules
+ * @reviewed 2025-08-05
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleBuilder = void 0;
+exports.createSchedule = createSchedule;
+const cron_1 = require("./cron");
+const payment_frequency_1 = require("./payment-frequency");
+const schedule_validation_1 = require("./schedule-validation");
+/**
+ * Builder for payment schedules with validation and preview.
+ */
+class ScheduleBuilder {
+    schedule;
+    /**
+     * Create from PaymentFrequency enum or string.
+     */
+    static fromFrequency(frequency) {
+        const cron = typeof frequency === 'string'
+            ? (0, payment_frequency_1.normalizePaymentSchedule)(frequency)
+            : (0, cron_1.paymentFrequencyToCron)(frequency);
+        return new ScheduleBuilder(cron);
+    }
+    /**
+     * Create from custom cron expression.
+     */
+    static fromCron(expression) {
+        if (!(0, cron_1.validateCronExpression)(expression)) {
+            throw new Error('Invalid cron expression: ' + expression);
+        }
+        return new ScheduleBuilder(expression);
+    }
+    /**
+     * Create schedule for common intervals.
+     */
+    static every(interval, value) {
+        let cron;
+        switch (interval) {
+            case 'minutes':
+                if (value === 1) {
+                    cron = '0 * * * * *';
+                }
+                else if (60 % value === 0) {
+                    cron = '0 */' + value + ' * * * *';
+                }
+                else {
+                    throw new Error('Cannot create schedule for every ' + value + ' minutes');
+                }
+                break;
+            case 'hours':
+                if (value === 1) {
+                    cron = '@hourly';
+                }
+                else if (24 % value === 0) {
+                    cron = '0 0 */' + value + ' * * *';
+                }
+                else {
+                    throw new Error('Cannot create schedule for every ' + value + ' hours');
+                }
+                break;
+            case 'days':
+                if (value === 1) {
+                    cron = '@daily';
+                }
+                else if (value === 7) {
+                    cron = '@weekly';
+                }
+                else {
+                    cron = '0 0 0 */' + value + ' * *';
+                }
+                break;
+        }
+        return new ScheduleBuilder(cron);
+    }
+    constructor(schedule) {
+        this.schedule = schedule;
+    }
+    /**
+     * Preview payment schedule.
+     */
+    preview(startTime, duration, rate) {
+        const { times, totalPayments } = (0, cron_1.calculatePaymentSchedule)(this.schedule, startTime, duration, 10);
+        const payments = times.map((time, index) => ({
+            time,
+            date: new Date(time * 1000),
+            paymentNumber: index + 1
+        }));
+        const preview = {
+            schedule: this.schedule,
+            payments,
+            totalCount: totalPayments,
+            firstPayment: payments[0]?.date,
+            lastPayment: times[times.length - 1]
+                ? new Date(times[times.length - 1] * 1000)
+                : undefined,
+        };
+        if (rate !== undefined && rate > 0) {
+            preview.amountPerPayment = rate;
+            preview.totalAmount = rate * totalPayments;
+        }
+        return preview;
+    }
+    /**
+     * Validate schedule against rental constraints.
+     */
+    validate(duration, minDuration, maxDuration) {
+        return (0, schedule_validation_1.validateRentalSchedule)(this.schedule, duration, minDuration, maxDuration);
+    }
+    /**
+     * Get human-readable description.
+     */
+    describe() {
+        const descriptions = {
+            '@hourly': 'Every hour',
+            '@daily': 'Daily',
+            '@weekly': 'Weekly',
+            '@monthly': 'Monthly',
+            '*/10 * * * * *': 'Every 10 seconds',
+            '0 * * * * *': 'Every minute',
+        };
+        const desc = descriptions[this.schedule];
+        return desc ? desc + ' (' + this.schedule + ')' : this.schedule;
+    }
+    toString() {
+        return this.schedule;
+    }
+    getCronExpression() {
+        return this.schedule;
+    }
+}
+exports.ScheduleBuilder = ScheduleBuilder;
+function createSchedule(type, options) {
+    switch (type) {
+        case 'hourly':
+        case 'daily':
+        case 'weekly':
+        case 'monthly':
+            return ScheduleBuilder.fromFrequency(type);
+        case 'every':
+            if (options.minutes) {
+                return ScheduleBuilder.every('minutes', options.minutes);
+            }
+            else if (options.hours) {
+                return ScheduleBuilder.every('hours', options.hours);
+            }
+            else if (options.days) {
+                return ScheduleBuilder.every('days', options.days);
+            }
+            throw new Error('Invalid interval options');
+        case 'cron':
+            return ScheduleBuilder.fromCron(options);
+        default:
+            throw new Error('Unknown schedule type: ' + type);
+    }
+}
+//# sourceMappingURL=schedule-builder.js.map

package/dist/cjs/utils/schedule-builder.js.map

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

package/dist/cjs/utils/schedule-validation.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * @purpose Payment schedule validation utilities for rental contracts
+ * @reviewed 2025-08-05
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRentalSchedule = validateRentalSchedule;
+exports.validateFrequencyForDuration = validateFrequencyForDuration;
+const cron_1 = require("./cron");
+const payment_frequency_1 = require("./payment-frequency");
+const payment_frequency_2 = require("../types/payment-frequency");
+/**
+ * Validate rental payment schedule.
+ *
+ * @param schedule - Payment schedule (frequency string or cron)
+ * @param duration - Rental duration in seconds
+ * @param minDuration - Minimum duration
+ * @param maxDuration - Maximum duration
+ * @returns Validation result
+ */
+function validateRentalSchedule(schedule, duration, minDuration, maxDuration) {
+    const errors = [];
+    const warnings = [];
+    // Normalize schedule
+    let normalizedSchedule;
+    try {
+        normalizedSchedule = (0, payment_frequency_1.normalizePaymentSchedule)(schedule);
+    }
+    catch (error) {
+        errors.push('Invalid payment schedule');
+        return { valid: false, errors, warnings };
+    }
+    // Validate cron
+    if (!(0, cron_1.validateCronExpression)(normalizedSchedule)) {
+        errors.push('Invalid cron expression');
+        return { valid: false, errors, warnings };
+    }
+    // Validate duration bounds
+    if (duration < minDuration) {
+        errors.push('Duration is less than minimum');
+    }
+    if (duration > maxDuration) {
+        errors.push('Duration exceeds maximum');
+    }
+    // Check duration alignment for standard frequencies
+    try {
+        const parsed = (0, cron_1.parseScheduleString)(normalizedSchedule);
+        if (parsed.type === 'enum' && payment_frequency_2.CRON_TO_PAYMENT_FREQUENCY[normalizedSchedule]) {
+            try {
+                const frequencySeconds = (0, payment_frequency_1.paymentFrequencyStringToSeconds)(normalizedSchedule);
+                if (duration % frequencySeconds !== 0) {
+                    warnings.push('Duration is not aligned with payment frequency');
+                }
+            }
+            catch {
+                // Custom expression
+            }
+        }
+    }
+    catch {
+        // Continue
+    }
+    // Calculate payments
+    const now = Math.floor(Date.now() / 1000);
+    let paymentInfo;
+    try {
+        paymentInfo = (0, cron_1.calculatePaymentSchedule)(normalizedSchedule, now, duration);
+        if (paymentInfo.totalPayments === 0) {
+            errors.push('No payments would occur');
+        }
+        else if (paymentInfo.totalPayments === 1) {
+            warnings.push('Only one payment will occur');
+        }
+    }
+    catch (error) {
+        errors.push('Failed to calculate payment schedule');
+        return { valid: false, errors, warnings, normalizedSchedule };
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        normalizedSchedule,
+        paymentCount: paymentInfo.totalPayments,
+        firstPayment: paymentInfo.times[0] ? new Date(paymentInfo.times[0] * 1000) : undefined,
+        lastPayment: paymentInfo.times[paymentInfo.times.length - 1]
+            ? new Date(paymentInfo.times[paymentInfo.times.length - 1] * 1000)
+            : undefined,
+    };
+}
+/**
+ * Check if frequency is appropriate for duration.
+ *
+ * @param frequency - Payment frequency
+ * @param duration - Duration in seconds
+ * @returns Validation result with suggestions
+ */
+function validateFrequencyForDuration(frequency, duration) {
+    const hour = 3600;
+    const day = 86400;
+    const week = 604800;
+    // Calculate payments
+    const normalizedSchedule = (0, payment_frequency_1.normalizePaymentSchedule)(frequency);
+    const now = Math.floor(Date.now() / 1000);
+    const { totalPayments } = (0, cron_1.calculatePaymentSchedule)(normalizedSchedule, now, duration);
+    const suggestions = [];
+    let appropriate = true;
+    let reason;
+    // Too many payments
+    if (totalPayments > 100) {
+        appropriate = false;
+        reason = 'Too many payments';
+        if (duration >= week) {
+            suggestions.push('@daily', '@weekly');
+        }
+        else if (duration >= day) {
+            suggestions.push('@hourly', '@daily');
+        }
+    }
+    // Too few payments
+    if (totalPayments < 2) {
+        appropriate = false;
+        reason = 'Too few payments';
+        if (duration >= week * 4) {
+            suggestions.push('@weekly', '@daily');
+        }
+        else if (duration >= week) {
+            suggestions.push('@daily');
+        }
+        else if (duration >= day) {
+            suggestions.push('@hourly');
+        }
+    }
+    return { appropriate, reason, suggestions };
+}
+//# sourceMappingURL=schedule-validation.js.map

package/dist/cjs/utils/schedule-validation.js.map

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

package/dist/cjs/utils/signer.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * @purpose Universal signer handling utilities for @solana/kit compatibility
+ * @reviewed 2025-07-29
+ *
+ * This module provides utilities to handle different signer types in a unified way
+ * while ensuring compatibility with @solana/kit. Supports string addresses for
+ * browser usage and TransactionSigner objects for Node.js usage.
+ *
+ * Note: web3.js signers (Keypair, etc.) are explicitly not supported.
+ * Use address strings or @solana/kit TransactionSigner objects instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidSignerError = void 0;
+exports.validateSigner = validateSigner;
+exports.createTransactionSigner = createTransactionSigner;
+exports.isSignerObject = isSignerObject;
+exports.isAddressString = isAddressString;
+const kit_1 = require("@solana/kit");
+/**
+ * Error thrown when an invalid signer type is provided.
+ *
+ * @class InvalidSignerError
+ */
+class InvalidSignerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidSignerError';
+    }
+}
+exports.InvalidSignerError = InvalidSignerError;
+/**
+ * Validates signer compatibility with @solana/kit.
+ *
+ * @param signer - The signer to validate
+ * @throws {InvalidSignerError} If the signer is not compatible
+ */
+function validateSigner(signer) {
+    if (typeof signer === 'string') {
+        // Validate that the string is a valid Solana address
+        try {
+            // Use @solana/kit's address() function to validate - it will throw if invalid
+            (0, kit_1.address)(signer);
+            return;
+        }
+        catch (error) {
+            throw new InvalidSignerError(`Invalid address string: "${signer}". ${error instanceof Error ? error.message : 'Unknown validation error'}\n\n` +
+                'Expected a valid base58-encoded Solana address (32-44 characters).\n' +
+                'Examples:\n' +
+                '  - "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"\n' +
+                '  - "So11111111111111111111111111111111111111112"');
+        }
+    }
+    if (signer && typeof signer === 'object') {
+        const signerObj = signer;
+        // Check for web3.js Keypair or similar patterns
+        if ('publicKey' in signerObj) {
+            throw new InvalidSignerError('web3.js signers (Keypair, etc.) are not supported. ' +
+                'Use a base58 address string or TransactionSigner from @solana/kit instead.\n\n' +
+                'Examples:\n' +
+                '  - Browser: "base58AddressString"\n' +
+                '  - Node.js: createNoopSigner(address("base58AddressString"))');
+        }
+        // Check for valid @solana/kit signer patterns
+        if ('address' in signerObj || typeof signerObj.signTransactions === 'function') {
+            // If it has an address property, validate that the address is valid
+            if ('address' in signerObj) {
+                try {
+                    // Ensure the address property is a valid Address type
+                    if (!(0, kit_1.isAddress)(signerObj.address)) {
+                        throw new InvalidSignerError(`Signer object has invalid address property. Expected Address type from @solana/kit.`);
+                    }
+                }
+                catch (error) {
+                    throw new InvalidSignerError(`Signer object has invalid address property: ${error instanceof Error ? error.message : 'Unknown validation error'}`);
+                }
+            }
+            return;
+        }
+        // Unknown signer object format
+        throw new InvalidSignerError('Invalid signer format. Expected:\n' +
+            '  - base58 address string (browser usage)\n' +
+            '  - TransactionSigner from @solana/kit (Node.js usage)\n' +
+            '  - Object with address property');
+    }
+    throw new InvalidSignerError('Signer must be a string address or compatible signer object');
+}
+/**
+ * Creates TransactionSigner from UniversalSigner input with validation.
+ *
+ * Converts string addresses to TransactionSigner objects and validates compatibility.
+ * Supports both browser (string addresses) and Node.js (TransactionSigner) usage.
+ *
+ * @param signer - String address or kit-compatible signer
+ * @returns TransactionSigner with .address property for PDA derivation and signing
+ * @throws {InvalidSignerError} If the signer is not compatible
+ *
+ * @example
+ * ```typescript
+ * const signer = createTransactionSigner("9Wz...WWM");
+ * const nodeSigner = createTransactionSigner(wallet);
+ * ```
+ */
+function createTransactionSigner(signer) {
+    // Validate the signer first
+    validateSigner(signer);
+    // Handle string address case (browser usage)
+    if (typeof signer === 'string') {
+        const addr = (0, kit_1.address)(signer);
+        return (0, kit_1.createNoopSigner)(addr);
+    }
+    // Handle signer object cases (already validated TransactionSigner objects)
+    return signer;
+}
+/**
+ * Type guard to check if a value is a signer object (not a string).
+ */
+function isSignerObject(signer) {
+    return typeof signer !== 'string';
+}
+/**
+ * Type guard to check if a value is an address string.
+ */
+function isAddressString(signer) {
+    return typeof signer === 'string';
+}
+//# sourceMappingURL=signer.js.map

package/dist/cjs/utils/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../../src/utils/signer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAgCH,wCA8DC;AAkBD,0DAYC;AAKD,wCAIC;AAKD,0CAEC;AA1ID,qCAA2F;AAE3F;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAYD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAe;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,qDAAqD;QACrD,IAAI,CAAC;YACH,8EAA8E;YAC9E,IAAA,aAAO,EAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,MAAM,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,MAAM;gBAC/G,sEAAsE;gBACtE,aAAa;gBACb,sDAAsD;gBACtD,mDAAmD,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,MAA6B,CAAC;QAEhD,gDAAgD;QAChD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD;gBACnD,gFAAgF;gBAChF,aAAa;gBACb,sCAAsC;gBACtC,+DAA+D,CAClE,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC/E,oEAAoE;YACpE,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,sDAAsD;oBACtD,IAAI,CAAC,IAAA,eAAS,EAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,kBAAkB,CAC1B,qFAAqF,CACtF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,kBAAkB,CAC1B,+CAA+C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CACrH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,MAAM,IAAI,kBAAkB,CAC1B,oCAAoC;YAClC,6CAA6C;YAC7C,0DAA0D;YAC1D,kCAAkC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,6DAA6D,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,uBAAuB,CAAC,MAAuB;IAC7D,4BAA4B;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,6CAA6C;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAA,aAAO,EAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAA,sBAAgB,EAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,2EAA2E;IAC3E,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAC5B,MAAuB;IAEvB,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAuB;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC"}

package/dist/cjs/utils/smart-params.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @purpose Smart parameter types for intuitive SDK usage with ATLAS-first design
+ * @reviewed 2025-08-05
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.percentage = exports.amount = exports.duration = void 0;
+/**
+ * Duration builder functions for cleaner syntax.
+ *
+ * @example
+ * import { duration } from '@wuwei-labs/srsly';
+ *
+ * const oneWeek = duration.days(7);
+ * const twoHours = duration.hours(2);
+ * const customTime = duration.weeks(2).add(duration.days(3));
+ */
+exports.duration = {
+    seconds: (n) => ({ seconds: n }),
+    minutes: (n) => ({ minutes: n }),
+    hours: (n) => ({ hours: n }),
+    days: (n) => ({ days: n }),
+    weeks: (n) => ({ weeks: n }),
+    months: (n) => ({ months: n }),
+};
+/**
+ * Amount builder functions for explicit units.
+ *
+ * @example
+ * import { amount } from '@wuwei-labs/srsly';
+ *
+ * const payment = amount.atlas(1.5);
+ * const precise = amount.stardust(150_000_001);
+ */
+exports.amount = {
+    atlas: (n) => ({ atlas: n }),
+    stardust: (n) => ({ stardust: n }),
+};
+/**
+ * Percentage builder functions.
+ *
+ * @example
+ * import { percentage } from '@wuwei-labs/srsly';
+ *
+ * const tenPercent = percentage.percent(10);
+ * const precise = percentage.basisPoints(1050); // 10.5%
+ */
+exports.percentage = {
+    percent: (n) => ({ percent: n }),
+    basisPoints: (n) => ({ basisPoints: n }),
+};
+//# sourceMappingURL=smart-params.js.map

package/dist/cjs/utils/smart-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-params.js","sourceRoot":"","sources":["../../../src/utils/smart-params.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqEH;;;;;;;;;GASG;AACU,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvD,KAAK,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnD,IAAI,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnD,MAAM,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;CAC7C,CAAC;AAEX;;;;;;;;GAQG;AACU,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,CAAS,EAAe,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAS,EAAe,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;CAC/C,CAAC;AAEX;;;;;;;;GAQG;AACU,QAAA,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC,CAAS,EAAmB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACzD,WAAW,EAAE,CAAC,CAAS,EAAmB,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;CACzD,CAAC"}

package/dist/esm/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * @purpose Export all config-related operations for SRSLY SDK
+ * @reviewed 2025-07-31
+ */
+export { initializeConfig } from './initialize';
+export { updateConfig } from './update';
+//# sourceMappingURL=index.js.map

package/dist/esm/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAA+B,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAA2B,MAAM,UAAU,CAAC"}