@fleettools/core 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,62 @@
+export declare const VERSION = "0.1.0";
+export declare const TTL: {
+    readonly RESERVATION: number;
+    readonly LOCK: number;
+    readonly SESSION: number;
+    readonly OPERATION: number;
+};
+export declare const IMPORTANCE: {
+    readonly LOW: "low";
+    readonly NORMAL: "normal";
+    readonly HIGH: "high";
+    readonly URGENT: "urgent";
+};
+export type Importance = typeof IMPORTANCE[keyof typeof IMPORTANCE];
+export declare const SORTIE_STATUS: {
+    readonly OPEN: "open";
+    readonly IN_PROGRESS: "in_progress";
+    readonly BLOCKED: "blocked";
+    readonly CLOSED: "closed";
+};
+export type SortieStatus = typeof SORTIE_STATUS[keyof typeof SORTIE_STATUS];
+export declare const MISSION_STATUS: {
+    readonly PENDING: "pending";
+    readonly IN_PROGRESS: "in_progress";
+    readonly COMPLETED: "completed";
+};
+export type MissionStatus = typeof MISSION_STATUS[keyof typeof MISSION_STATUS];
+export declare const PRIORITY: {
+    readonly CRITICAL: 0;
+    readonly HIGH: 1;
+    readonly MEDIUM: 2;
+    readonly LOW: 3;
+};
+export type Priority = typeof PRIORITY[keyof typeof PRIORITY];
+export declare const EVENT_CATEGORIES: {
+    readonly PILOT: readonly ["pilot_registered", "pilot_active", "pilot_deregistered"];
+    readonly MESSAGE: readonly ["message_sent", "message_read", "message_acked", "thread_created", "thread_activity"];
+    readonly RESERVATION: readonly ["file_reserved", "file_released", "file_conflict"];
+    readonly SORTIE: readonly ["sortie_created", "sortie_started", "sortie_progress", "sortie_completed", "sortie_blocked", "sortie_status_changed"];
+    readonly MISSION: readonly ["mission_created", "mission_started", "mission_completed", "mission_synced"];
+    readonly CHECKPOINT: readonly ["checkpoint_created", "context_compacted", "fleet_recovered", "context_injected"];
+    readonly COORDINATION: readonly ["coordinator_decision", "coordinator_violation", "pilot_spawned", "pilot_completed", "review_started", "review_completed"];
+};
+export declare const PROGRAM_TYPE: {
+    readonly OPENCODE: "opencode";
+    readonly CLAUDE: "claude";
+    readonly STANDALONE: "standalone";
+    readonly UNKNOWN: "unknown";
+};
+export type ProgramType = typeof PROGRAM_TYPE[keyof typeof PROGRAM_TYPE];
+export declare const DB_FILENAME = "fleet.db";
+export declare const FLEET_DIR = ".fleet";
+export declare const MAX_QUERY_RESULTS = 1000;
+export declare const COMPACTION_THRESHOLD = 10000;
+export declare const CHECKPOINT_TRIGGER: {
+    readonly AUTO: "auto";
+    readonly MANUAL: "manual";
+    readonly ERROR: "error";
+    readonly CONTEXT_LIMIT: "context_limit";
+};
+export type CheckpointTrigger = typeof CHECKPOINT_TRIGGER[keyof typeof CHECKPOINT_TRIGGER];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,eAAO,MAAM,GAAG;;;;;CAKN,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE5E,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEzE,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/ids.d.ts

@@ -0,0 +1,71 @@
+/**
+ * FleetTools ID Generators
+ *
+ * Generates prefixed UUIDs for different entity types.
+ * All IDs follow the pattern: {prefix}-{uuid}
+ */
+/**
+ * FleetTools ID prefixes
+ */
+export declare const ID_PREFIXES: {
+    readonly MISSION: "msn-";
+    readonly WORK_ORDER: "wo-";
+    readonly CHECKPOINT: "chk-";
+    readonly EVENT: "evt-";
+};
+/**
+ * FleetTools version
+ */
+export declare const FLEETTOOLS_VERSION = "0.1.0";
+/**
+ * Branded ID types for compile-time safety
+ */
+export type MissionId = `msn-${string}`;
+export type WorkOrderId = `wo-${string}`;
+export type CheckpointId = `chk-${string}`;
+export type EventId = `evt-${string}`;
+/**
+ * Extract prefix from an ID
+ */
+export declare function extractPrefix(id: string): string | null;
+/**
+ * Check if an ID has a valid prefix
+ */
+export declare function isValidPrefixId(id: string, prefix: string): boolean;
+/**
+ * Generate a mission ID (msn-{uuid})
+ */
+export declare function generateMissionId(): MissionId;
+/**
+ * Generate a work order ID (wo-{uuid})
+ */
+export declare function generateWorkOrderId(): WorkOrderId;
+/**
+ * Generate a checkpoint ID (chk-{uuid})
+ */
+export declare function generateCheckpointId(): CheckpointId;
+/**
+ * Generate an event ID (evt-{uuid})
+ */
+export declare function generateEventId(): EventId;
+/**
+ * Generate an ISO 8601 timestamp
+ */
+export declare function generateTimestamp(): string;
+/**
+ * Type guard for MissionId
+ */
+export declare function isMissionId(id: string): id is MissionId;
+/**
+ * Type guard for WorkOrderId
+ */
+export declare function isWorkOrderId(id: string): id is WorkOrderId;
+/**
+ * Type guard for CheckpointId
+ */
+export declare function isCheckpointId(id: string): id is CheckpointId;
+/**
+ * Type guard for EventId
+ */
+export declare function isEventId(id: string): id is EventId;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,EAAE,CAAC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,EAAE,CAAC;AACzC,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,EAAE,CAAC;AAC3C,MAAM,MAAM,OAAO,GAAG,OAAO,MAAM,EAAE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AASD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAEjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,SAAS,CAEvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,WAAW,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,YAAY,CAE7D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,OAAO,CAEnD"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FleetTools Core Package
+ *
+ * Core utilities, ID generators, and shared types for FleetTools.
+ */
+export { ID_PREFIXES, FLEETTOOLS_VERSION, generateMissionId, generateWorkOrderId, generateCheckpointId, generateEventId, generateTimestamp, extractPrefix, isValidPrefixId, isMissionId, isWorkOrderId, isCheckpointId, isEventId, } from './ids.js';
+export { nowIso, toIso, fromUnixMs, fromIso, toUnixMs, nowUnixMs, formatDuration, durationBetween, addDuration, isPast, isFuture, formatDisplay, } from './timestamps.js';
+export type { MissionStatus, WorkOrderStatus, CheckpointStatus, Priority, AggregateType, EventMetadata, BaseEvent, Snapshot, PaginationOptions, TimeRange, DatabaseConfig, Result, } from './types.js';
+export { sleep, retry, deepClone, isValidJSON, safeJSONStringify, isValidFleetToolsId, extractUUIDFromId, generateSafeFilename, formatBytes, debounce, throttle, } from './utils.js';
+export type { MissionId, WorkOrderId, CheckpointId, EventId, } from './ids.js';
+//# 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;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,MAAM,EACN,KAAK,EACL,UAAU,EACV,OAAO,EACP,QAAQ,EACR,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,MAAM,EACN,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,MAAM,GACP,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,OAAO,GACR,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,238 @@
+// @bun
+// src/ids.ts
+import { randomUUID } from "crypto";
+var ID_PREFIXES = {
+  MISSION: "msn-",
+  WORK_ORDER: "wo-",
+  CHECKPOINT: "chk-",
+  EVENT: "evt-"
+};
+var FLEETTOOLS_VERSION = "0.1.0";
+function extractPrefix(id) {
+  const match = id.match(/^([a-z]{2,4}-)/);
+  return match?.[1] ?? null;
+}
+function isValidPrefixId(id, prefix) {
+  return id.startsWith(prefix) && extractPrefix(id) === prefix;
+}
+function generateUUID() {
+  return randomUUID();
+}
+function generateMissionId() {
+  return `msn-${generateUUID()}`;
+}
+function generateWorkOrderId() {
+  return `wo-${generateUUID()}`;
+}
+function generateCheckpointId() {
+  return `chk-${generateUUID()}`;
+}
+function generateEventId() {
+  return `evt-${generateUUID()}`;
+}
+function generateTimestamp() {
+  return new Date().toISOString();
+}
+function isMissionId(id) {
+  return isValidPrefixId(id, ID_PREFIXES.MISSION);
+}
+function isWorkOrderId(id) {
+  return isValidPrefixId(id, ID_PREFIXES.WORK_ORDER);
+}
+function isCheckpointId(id) {
+  return isValidPrefixId(id, ID_PREFIXES.CHECKPOINT);
+}
+function isEventId(id) {
+  return isValidPrefixId(id, ID_PREFIXES.EVENT);
+}
+// src/timestamps.ts
+function nowIso() {
+  return new Date().toISOString();
+}
+function toIso(date) {
+  return date.toISOString();
+}
+function fromUnixMs(ms) {
+  return new Date(ms).toISOString();
+}
+function fromIso(iso) {
+  return new Date(iso);
+}
+function toUnixMs(date) {
+  return date.getTime();
+}
+function nowUnixMs() {
+  return Date.now();
+}
+function formatDuration(ms) {
+  const seconds = Math.floor(ms / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const h = hours;
+  const m = minutes % 60;
+  const s = seconds % 60;
+  if (h > 0) {
+    return `${h}h ${m}m ${s}s`;
+  }
+  if (m > 0) {
+    return `${m}m ${s}s`;
+  }
+  return `${s}s`;
+}
+function durationBetween(startIso, endIso) {
+  const start = fromIso(startIso);
+  const end = fromIso(endIso);
+  return end.getTime() - start.getTime();
+}
+function addDuration(iso, ms) {
+  const date = fromIso(iso);
+  date.setTime(date.getTime() + ms);
+  return toIso(date);
+}
+function isPast(iso) {
+  return fromIso(iso).getTime() < Date.now();
+}
+function isFuture(iso) {
+  return fromIso(iso).getTime() > Date.now();
+}
+function formatDisplay(iso) {
+  return iso.replace("T", " ").replace(/\.\d+Z$/, "");
+}
+// src/utils.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, maxAttempts = 3, baseDelay = 1000) {
+  let lastError;
+  for (let attempt = 1;attempt <= maxAttempts; attempt++) {
+    try {
+      const result = await fn();
+      return { success: true, data: result };
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt === maxAttempts) {
+        break;
+      }
+      const delay = baseDelay * Math.pow(2, attempt - 1);
+      await sleep(delay);
+    }
+  }
+  return { success: false, error: lastError };
+}
+function deepClone(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (obj instanceof Date) {
+    return new Date(obj.getTime());
+  }
+  if (obj instanceof Array) {
+    return obj.map((item) => deepClone(item));
+  }
+  if (typeof obj === "object") {
+    const cloned = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        cloned[key] = deepClone(obj[key]);
+      }
+    }
+    return cloned;
+  }
+  return obj;
+}
+function isValidJSON(str) {
+  try {
+    JSON.parse(str);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function safeJSONStringify(obj, space) {
+  const seen = new WeakSet;
+  return JSON.stringify(obj, (key, value) => {
+    if (typeof value === "object" && value !== null) {
+      if (seen.has(value)) {
+        return "[Circular]";
+      }
+      seen.add(value);
+    }
+    return value;
+  }, space);
+}
+function isValidFleetToolsId(id) {
+  const validPrefixes = ["msn-", "wo-", "chk-", "evt-"];
+  const prefix = id.match(/^([a-z]{2,4}-)/);
+  return prefix ? validPrefixes.includes(prefix[1] || "") : false;
+}
+function extractUUIDFromId(id) {
+  const match = id.match(/^[a-z]{2,4}-(.+)$/);
+  return match?.[1] ?? null;
+}
+function generateSafeFilename(str) {
+  return str.toLowerCase().replace(/[^a-z0-9]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function formatBytes(bytes, decimals = 2) {
+  if (bytes === 0)
+    return "0 Bytes";
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + " " + sizes[i];
+}
+function debounce(fn, delay) {
+  let timeoutId;
+  return (...args) => {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => fn(...args), delay);
+  };
+}
+function throttle(fn, delay) {
+  let lastCall = 0;
+  return (...args) => {
+    const now = Date.now();
+    if (now - lastCall >= delay) {
+      lastCall = now;
+      fn(...args);
+    }
+  };
+}
+export {
+  toUnixMs,
+  toIso,
+  throttle,
+  sleep,
+  safeJSONStringify,
+  retry,
+  nowUnixMs,
+  nowIso,
+  isWorkOrderId,
+  isValidPrefixId,
+  isValidJSON,
+  isValidFleetToolsId,
+  isPast,
+  isMissionId,
+  isFuture,
+  isEventId,
+  isCheckpointId,
+  generateWorkOrderId,
+  generateTimestamp,
+  generateSafeFilename,
+  generateMissionId,
+  generateEventId,
+  generateCheckpointId,
+  fromUnixMs,
+  fromIso,
+  formatDuration,
+  formatDisplay,
+  formatBytes,
+  extractUUIDFromId,
+  extractPrefix,
+  durationBetween,
+  deepClone,
+  debounce,
+  addDuration,
+  ID_PREFIXES,
+  FLEETTOOLS_VERSION
+};

package/dist/timestamps.d.ts

@@ -0,0 +1,13 @@
+export declare function nowIso(): string;
+export declare function toIso(date: Date): string;
+export declare function fromUnixMs(ms: number): string;
+export declare function fromIso(iso: string): Date;
+export declare function toUnixMs(date: Date): number;
+export declare function nowUnixMs(): number;
+export declare function formatDuration(ms: number): string;
+export declare function durationBetween(startIso: string, endIso: string): number;
+export declare function addDuration(iso: string, ms: number): string;
+export declare function isPast(iso: string): boolean;
+export declare function isFuture(iso: string): boolean;
+export declare function formatDisplay(iso: string): string;
+//# sourceMappingURL=timestamps.d.ts.map

package/dist/timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../src/timestamps.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAExC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE3C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * FleetTools Core Types
+ */
+/**
+ * Status types for various entities
+ */
+export type MissionStatus = 'draft' | 'active' | 'in_progress' | 'completed' | 'cancelled' | 'archived';
+export type WorkOrderStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+export type CheckpointStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+/**
+ * Priority levels
+ */
+export type Priority = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Aggregate types for event sourcing
+ */
+export type AggregateType = 'mission' | 'workorder' | 'checkpoint';
+/**
+ * Event metadata for correlation and causation
+ */
+export interface EventMetadata {
+    correlationId?: string;
+    causationId?: string;
+    userId?: string;
+    sessionId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Base event interface
+ */
+export interface BaseEvent {
+    id: string;
+    type: string;
+    aggregateId: string;
+    aggregateType: AggregateType;
+    timestamp: string;
+    version: number;
+    data: unknown;
+    metadata?: EventMetadata;
+}
+/**
+ * Snapshot interface for event store
+ */
+export interface Snapshot {
+    id: string;
+    aggregateId: string;
+    aggregateType: AggregateType;
+    data: unknown;
+    version: number;
+    timestamp: string;
+}
+/**
+ * Pagination options
+ */
+export interface PaginationOptions {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Time range options
+ */
+export interface TimeRange {
+    from: string;
+    to: string;
+}
+/**
+ * Database configuration
+ */
+export interface DatabaseConfig {
+    path?: string;
+    readonly?: boolean;
+}
+/**
+ * Result type for operations that may fail
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,aAAa,GACb,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,QAAQ,GACR,MAAM,GACN,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FleetTools Utility Functions
+ */
+import type { MissionId, WorkOrderId, CheckpointId, EventId } from './ids.js';
+import type { Result } from './types.js';
+/**
+ * Sleep function for async delays
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, maxAttempts?: number, baseDelay?: number): Promise<Result<T>>;
+/**
+ * Deep clone function
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Validate JSON string
+ */
+export declare function isValidJSON(str: string): boolean;
+/**
+ * Safe JSON stringify with circular reference protection
+ */
+export declare function safeJSONStringify(obj: unknown, space?: number): string;
+/**
+ * Validate FleetTools ID format
+ */
+export declare function isValidFleetToolsId(id: string): id is MissionId | WorkOrderId | CheckpointId | EventId;
+/**
+ * Extract UUID from FleetTools ID
+ */
+export declare function extractUUIDFromId(id: string): string | null;
+/**
+ * Generate a safe filename from a string
+ */
+export declare function generateSafeFilename(str: string): string;
+/**
+ * Convert bytes to human readable format
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAAU,EACvB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAoBpB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAwBtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAWtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAItG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAUvE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@fleettools/core",
+  "version": "0.1.0",
+  "description": "Core utilities and types for FleetTools",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly",
+    "dev": "bun --watch src/index.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/bun": "^1.3.5"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}