@wuwei-labs/srsly 2.3.3-canary.36.16828734028.0 → 3.0.0-beta.1

package/dist/cjs/instructions/updateContract.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * @purpose Simplified updateContract instruction wrapper
+ *
+ * Thin convenience wrapper around Codama-generated updateContract instruction.
+ * Allows updating any subset of contract fields while a contract has no active rental.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateContract = updateContract;
+const kit_1 = require("@solana/kit");
+const instructions_1 = require("../generated/codama/instructions");
+const config_1 = require("../utils/config");
+const signer_1 = require("../utils/signer");
+const amount_1 = require("../params/amount");
+const duration_1 = require("../params/duration");
+const schedule_1 = require("../params/schedule");
+const instructions_2 = require("../utils/instructions");
+/**
+ * Update an existing rental contract
+ *
+ * Allows the contract owner to update any subset of contract settings.
+ * Contract must not have an active rental.
+ *
+ * @param params - Contract update parameters
+ * @param config - Optional SDK configuration overrides
+ * @returns Kit instruction (or web3.js if PublicKey in config)
+ *
+ * @example
+ * ```typescript
+ * // Update only the rate
+ * const ix = await updateContract({
+ *   owner: wallet,
+ *   contract: contractAddress,
+ *   rate: 150 // Increase rate to 150 ATLAS
+ * });
+ *
+ * // Update multiple fields
+ * const ix2 = await updateContract({
+ *   owner: wallet,
+ *   contract: contractAddress,
+ *   rate: 100,
+ *   durationMax: { days: 60 },
+ *   paymentsFreq: '@weekly'
+ * });
+ *
+ * // With web3.js
+ * import { PublicKey } from '@solana/web3.js';
+ * setSdkConfig({ network: 'mainnet-beta', PublicKey });
+ * const web3Ix = await updateContract({
+ *   owner: keypair,
+ *   contract: contractPubkey,
+ *   rate: { atlas: 2.5 }
+ * });
+ * ```
+ */
+async function updateContract(params, config) {
+    // Merge config
+    const finalConfig = (0, config_1.mergeConfig)(config);
+    // Validate required params
+    if (!params.owner) {
+        throw new Error('owner is required');
+    }
+    if (!params.contract) {
+        throw new Error('contract is required');
+    }
+    // At least one field must be updated
+    if (params.rate === undefined &&
+        params.durationMin === undefined &&
+        params.durationMax === undefined &&
+        params.paymentsFreq === undefined &&
+        params.allowInstantCancel === undefined &&
+        params.reservationsDisabled === undefined) {
+        throw new Error('At least one field must be provided to update');
+    }
+    // Convert owner to transaction signer
+    const ownerSigner = (0, signer_1.toTransactionSigner)(params.owner);
+    // Convert optional parameters
+    const rateStardust = params.rate !== undefined ? (0, amount_1.convertAmount)(params.rate) : null;
+    const durationMinSeconds = params.durationMin !== undefined ? BigInt((0, duration_1.convertDuration)(params.durationMin)) : null;
+    const durationMaxSeconds = params.durationMax !== undefined ? BigInt((0, duration_1.convertDuration)(params.durationMax)) : null;
+    const normalizedSchedule = params.paymentsFreq !== undefined ? (0, schedule_1.normalizeSchedule)(params.paymentsFreq) : null;
+    // Validate duration logic if both are being updated
+    if (durationMinSeconds !== null && durationMaxSeconds !== null) {
+        if (durationMaxSeconds < durationMinSeconds) {
+            throw new Error(`durationMax (${durationMaxSeconds}s) must be >= durationMin (${durationMinSeconds}s)`);
+        }
+    }
+    // Get network-specific addresses
+    const addresses = (0, config_1.getAddresses)(config);
+    const programAddress = (0, kit_1.address)(addresses.srsly);
+    // Call Codama-generated instruction
+    const kitInstruction = await (0, instructions_1.getUpdateContractInstructionAsync)({
+        owner: ownerSigner,
+        contract: (0, kit_1.address)(params.contract),
+        rate: rateStardust,
+        durationMinSeconds,
+        durationMaxSeconds,
+        paymentsFeq: normalizedSchedule,
+        allowInstantCancel: params.allowInstantCancel ?? null,
+        reservationsDisabled: params.reservationsDisabled ?? null,
+    }, { programAddress });
+    return (0, instructions_2.prepareInstructions)(kitInstruction, {
+        computeUnits: params.computeUnits,
+        PublicKey: finalConfig.PublicKey
+    });
+}
+//# sourceMappingURL=updateContract.js.map

package/dist/cjs/instructions/updateContract.js.map

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

package/dist/cjs/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@wuwei-labs/srsly",
-  "version": "2.3.2",
-  "description": "",
-  "source": "./src/index.ts",
+  "version": "3.0.0-beta.1",
+  "description": "TypeScript SDK for SRSLY",
   "sideEffects": false,
   "publishConfig": {
     "access": "public"
@@ -11,53 +10,52 @@
     "dist/cjs",
     "dist/esm",
     "dist/types",
-    "target/idl/srsly.json",
-    "target/types/srsly.ts"
+    "src/idl/srsly.json"
   ],
   "keywords": [
     "SRSLY",
-    "Star",
-    "Atlas",
-    "sdk"
+    "Star Atlas",
+    "Solana",
+    "sdk",
+    "fleet rental"
   ],
   "scripts": {
-    "build": "pnpm run generate && pnpm run package",
-    "build:quick": "pnpm run generate && pnpm run package",
-    "package": "pnpm run package:cjs && pnpm run package:esm",
-    "package:cjs": "tsc -p tsconfig.cjs.json && tsconfig-to-dual-package tsconfig.cjs.json",
-    "package:esm": "tsc -p tsconfig.esm.json && tsconfig-to-dual-package tsconfig.esm.json",
-    "generate": "node generate.mjs",
-    "dev": "vitest",
-    "pretest": "pnpm run build:quick",
+    "build": "pnpm run generate && pnpm run compile",
+    "generate": "codama run js",
+    "generate:version": "node scripts/generate-version.js",
+    "compile": "pnpm run generate:version && pnpm run compile:cjs && pnpm run compile:esm",
+    "compile:cjs": "tsc -p tsconfig.cjs.json && tsconfig-to-dual-package tsconfig.cjs.json",
+    "compile:esm": "tsc -p tsconfig.esm.json && tsconfig-to-dual-package tsconfig.esm.json",
+    "clean": "rm -rf dist src/generated src/idl src/types src/version.ts",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "clean": "rm -rf dist target && cargo clean",
-    "docs": "typedoc",
-    "format": "prettier --write \"src/**/*.{ts,js,json}\" --ignore-path .prettierignore",
-    "format:check": "prettier --check \"src/**/*.{ts,js,json}\" --ignore-path .prettierignore",
+    "test:watch": "vitest",
+    "format": "prettier --write \"src/**/*.{ts,js,json}\" --ignore-path ../../.prettierignore",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json}\" --ignore-path ../../.prettierignore",
     "lint": "pnpm run format:check"
   },
   "author": "",
   "license": "ISC",
   "packageManager": "pnpm@10.13.1",
   "dependencies": {
+    "@codama/nodes-from-anchor": "^1.2.9",
+    "@codama/renderers-js": "^1.4.2",
     "@solana/kit": "^2.1.1",
-    "cron-parser": "^5.3.0"
-  },
-  "optionalDependencies": {
-    "@srsly/program": "workspace:*"
+    "@wuwei-labs/slyvault": "workspace:*"
   },
   "devDependencies": {
-    "@codama/nodes-from-anchor": "^1.1.13",
-    "@wuwei-labs/renderers-js": "^1.4.2",
     "@types/node": "^24.0.3",
-    "codama": "^1.2.13",
-    "nodemon": "^3.0.2",
+    "codama": "^1.3.7",
     "tsconfig-to-dual-package": "^1.2.0",
-    "typedoc": "^0.27.6",
     "typescript": "^5.9.2",
-    "vitest": "^3.2.4",
-    "webpack": "^5.99.9"
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@solana/web3.js": "^1.95.0"
+  },
+  "peerDependenciesMeta": {
+    "@solana/web3.js": {
+      "optional": true
+    }
   },
   "type": "commonjs"
 }

package/dist/cjs/params/amount.js

@@ -0,0 +1,125 @@
+"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;
+/**
+ * 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 or negative
+ *
+ * @example
+ * ```typescript
+ * convertAmount(100)                    // 10_000_000_000 stardust (100 ATLAS)
+ * convertAmount({ atlas: 10 })          // 1_000_000_000 stardust (10 ATLAS)
+ * convertAmount({ stardust: 1000000 })  // 1_000_000 stardust (0.01 ATLAS)
+ * ```
+ */
+function convertAmount(amount) {
+    let stardust;
+    // Handle plain number (ATLAS)
+    if (typeof amount === 'number') {
+        if (amount < 0) {
+            throw new Error(`Amount must be non-negative, got ${amount}`);
+        }
+        stardust = amount * STARDUST_PER_ATLAS;
+    }
+    // Handle object format
+    else if (typeof amount === 'object' && amount !== null) {
+        if ('atlas' in amount && amount.atlas !== undefined) {
+            if (amount.atlas < 0) {
+                throw new Error(`ATLAS amount must be non-negative, got ${amount.atlas}`);
+            }
+            stardust = amount.atlas * STARDUST_PER_ATLAS;
+        }
+        else if ('stardust' in amount && amount.stardust !== undefined) {
+            if (amount.stardust < 0) {
+                throw new Error(`Stardust amount must be non-negative, got ${amount.stardust}`);
+            }
+            stardust = amount.stardust;
+        }
+        else {
+            throw new Error(`Invalid amount format. Expected { atlas: number } or { stardust: number }. ` +
+                `Got: ${JSON.stringify(amount)}`);
+        }
+    }
+    else {
+        throw new Error(`Invalid amount type. Expected number or object. Got: ${typeof amount}`);
+    }
+    // Convert to bigint and ensure it's a whole number
+    const stardustBigInt = BigInt(Math.floor(stardust));
+    // Validate it fits in u64
+    if (stardustBigInt < 0n) {
+        throw new Error(`Amount resulted in negative stardust: ${stardustBigInt}`);
+    }
+    const MAX_U64 = 18446744073709551615n;
+    if (stardustBigInt > MAX_U64) {
+        throw new Error(`Amount too large. Max u64: ${MAX_U64}, got: ${stardustBigInt}`);
+    }
+    return stardustBigInt;
+}
+/**
+ * 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: 2)
+ * @returns Formatted ATLAS amount string
+ *
+ * @example
+ * ```typescript
+ * formatAmount(100_000_000n)      // "1.00 ATLAS"
+ * formatAmount(150_000_000n, 4)   // "1.5000 ATLAS"
+ * ```
+ */
+function formatAmount(stardust, decimals = 2) {
+    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/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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"}