@bquery/bquery 1.0.0

package/dist/motion.es.mjs

@@ -0,0 +1,104 @@
+const $ = async (e) => {
+  const t = typeof e == "function" ? e : e.update, c = document;
+  if (c.startViewTransition) {
+    await c.startViewTransition(() => t()).finished;
+    return;
+  }
+  t();
+}, h = (e) => {
+  const t = e.getBoundingClientRect();
+  return {
+    top: t.top,
+    left: t.left,
+    width: t.width,
+    height: t.height
+  };
+}, P = (e, t, c = {}) => {
+  const { duration: m = 300, easing: p = "ease-out", onComplete: i } = c, n = h(e);
+  if (n.width === 0 || n.height === 0)
+    return Promise.resolve();
+  const o = t.left - n.left, f = t.top - n.top, s = t.width / n.width, a = t.height / n.height;
+  if (o === 0 && f === 0 && s === 1 && a === 1)
+    return Promise.resolve();
+  const r = e;
+  return r.style.transform = `translate(${o}px, ${f}px) scale(${s}, ${a})`, r.style.transformOrigin = "top left", r.offsetHeight, new Promise((u) => {
+    const d = r.animate(
+      [
+        {
+          transform: `translate(${o}px, ${f}px) scale(${s}, ${a})`
+        },
+        { transform: "translate(0, 0) scale(1, 1)" }
+      ],
+      { duration: m, easing: p, fill: "forwards" }
+    );
+    d.onfinish = () => {
+      r.style.transform = "", r.style.transformOrigin = "", i?.(), u();
+    };
+  });
+}, v = async (e, t, c = {}) => {
+  const m = /* @__PURE__ */ new Map();
+  for (const i of e)
+    m.set(i, h(i));
+  t();
+  const p = e.map((i) => {
+    const n = m.get(i);
+    return n ? P(i, n, c) : Promise.resolve();
+  });
+  await Promise.all(p);
+}, F = {
+  stiffness: 100,
+  damping: 10,
+  mass: 1,
+  precision: 0.01
+}, x = (e, t = {}) => {
+  const { stiffness: c, damping: m, mass: p, precision: i } = {
+    ...F,
+    ...t
+  };
+  let n = e, o = 0, f = e, s = null, a = null;
+  const r = /* @__PURE__ */ new Set(), u = () => {
+    for (const l of r)
+      l(n);
+  }, d = () => {
+    const l = n - f, g = -c * l, w = -m * o, y = (g + w) / p;
+    if (o += y * (1 / 60), n += o * (1 / 60), u(), Math.abs(o) < i && Math.abs(l) < i) {
+      n = f, o = 0, s = null, u(), a?.(), a = null;
+      return;
+    }
+    s = requestAnimationFrame(d);
+  };
+  return {
+    to(l) {
+      return f = l, s !== null && cancelAnimationFrame(s), new Promise((g) => {
+        a = g, s = requestAnimationFrame(d);
+      });
+    },
+    current() {
+      return n;
+    },
+    stop() {
+      s !== null && (cancelAnimationFrame(s), s = null), o = 0, a?.(), a = null;
+    },
+    onChange(l) {
+      return r.add(l), () => r.delete(l);
+    }
+  };
+}, A = {
+  /** Gentle, slow-settling spring */
+  gentle: { stiffness: 80, damping: 15 },
+  /** Responsive, snappy spring */
+  snappy: { stiffness: 200, damping: 20 },
+  /** Bouncy, playful spring */
+  bouncy: { stiffness: 300, damping: 8 },
+  /** Stiff, quick spring with minimal overshoot */
+  stiff: { stiffness: 400, damping: 30 }
+};
+export {
+  h as capturePosition,
+  P as flip,
+  v as flipList,
+  x as spring,
+  A as springPresets,
+  $ as transition
+};
+//# sourceMappingURL=motion.es.mjs.map

package/dist/motion.es.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.es.mjs","sources":["../src/motion/index.ts"],"sourcesContent":["/**\n * Motion module providing view transitions, FLIP animations, and spring physics.\n * Designed to work with modern browser APIs while providing smooth fallbacks.\n *\n * @module bquery/motion\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Options for view transitions.\n */\nexport interface TransitionOptions {\n  /** The DOM update function to execute during transition */\n  update: () => void;\n}\n\n/**\n * Captured element bounds for FLIP animations.\n */\nexport interface ElementBounds {\n  top: number;\n  left: number;\n  width: number;\n  height: number;\n}\n\n/**\n * FLIP animation configuration options.\n */\nexport interface FlipOptions {\n  /** Animation duration in milliseconds */\n  duration?: number;\n  /** CSS easing function */\n  easing?: string;\n  /** Callback when animation completes */\n  onComplete?: () => void;\n}\n\n/**\n * Spring physics configuration.\n */\nexport interface SpringConfig {\n  /** Spring stiffness (default: 100) */\n  stiffness?: number;\n  /** Damping coefficient (default: 10) */\n  damping?: number;\n  /** Mass of the object (default: 1) */\n  mass?: number;\n  /** Velocity threshold for completion (default: 0.01) */\n  precision?: number;\n}\n\n/**\n * Spring instance for animating values.\n */\nexport interface Spring {\n  /** Start animating to target value */\n  to(target: number): Promise<void>;\n  /** Get current animated value */\n  current(): number;\n  /** Stop the animation */\n  stop(): void;\n  /** Subscribe to value changes */\n  onChange(callback: (value: number) => void): () => void;\n}\n\n// ============================================================================\n// View Transitions\n// ============================================================================\n\n/** Extended document type with View Transitions API */\ntype DocumentWithTransition = Document & {\n  startViewTransition?: (callback: () => void) => {\n    finished: Promise<void>;\n    ready: Promise<void>;\n    updateCallbackDone: Promise<void>;\n  };\n};\n\n/**\n * Execute a DOM update with view transition animation.\n * Falls back to immediate update when View Transitions API is unavailable.\n *\n * @param updateOrOptions - Update function or options object\n * @returns Promise that resolves when transition completes\n *\n * @example\n * ```ts\n * await transition(() => {\n *   $('#content').text('Updated');\n * });\n * ```\n */\nexport const transition = async (\n  updateOrOptions: (() => void) | TransitionOptions\n): Promise<void> => {\n  const update = typeof updateOrOptions === 'function' ? updateOrOptions : updateOrOptions.update;\n\n  const doc = document as DocumentWithTransition;\n\n  if (doc.startViewTransition) {\n    await doc.startViewTransition(() => update()).finished;\n    return;\n  }\n\n  update();\n};\n\n// ============================================================================\n// FLIP Animations\n// ============================================================================\n\n/**\n * Capture the current bounds of an element for FLIP animation.\n *\n * @param element - The DOM element to measure\n * @returns The element's current position and size\n */\nexport const capturePosition = (element: Element): ElementBounds => {\n  const rect = element.getBoundingClientRect();\n  return {\n    top: rect.top,\n    left: rect.left,\n    width: rect.width,\n    height: rect.height,\n  };\n};\n\n/**\n * Perform a FLIP (First, Last, Invert, Play) animation.\n * Animates an element from its captured position to its current position.\n *\n * @param element - The element to animate\n * @param firstBounds - The previously captured bounds\n * @param options - Animation configuration\n * @returns Promise that resolves when animation completes\n *\n * @example\n * ```ts\n * const first = capturePosition(element);\n * // ... DOM changes that move the element ...\n * await flip(element, first, { duration: 300 });\n * ```\n */\nexport const flip = (\n  element: Element,\n  firstBounds: ElementBounds,\n  options: FlipOptions = {}\n): Promise<void> => {\n  const { duration = 300, easing = 'ease-out', onComplete } = options;\n\n  // Last: Get current position\n  const lastBounds = capturePosition(element);\n\n  // Skip animation if element has zero dimensions (avoid division by zero)\n  if (lastBounds.width === 0 || lastBounds.height === 0) {\n    return Promise.resolve();\n  }\n\n  // Invert: Calculate the delta\n  const deltaX = firstBounds.left - lastBounds.left;\n  const deltaY = firstBounds.top - lastBounds.top;\n  const deltaW = firstBounds.width / lastBounds.width;\n  const deltaH = firstBounds.height / lastBounds.height;\n\n  // Skip animation if no change\n  if (deltaX === 0 && deltaY === 0 && deltaW === 1 && deltaH === 1) {\n    return Promise.resolve();\n  }\n\n  const htmlElement = element as HTMLElement;\n\n  // Apply inverted transform\n  htmlElement.style.transform = `translate(${deltaX}px, ${deltaY}px) scale(${deltaW}, ${deltaH})`;\n  htmlElement.style.transformOrigin = 'top left';\n\n  // Force reflow\n  void htmlElement.offsetHeight;\n\n  // Play: Animate back to current position\n  return new Promise((resolve) => {\n    const animation = htmlElement.animate(\n      [\n        {\n          transform: `translate(${deltaX}px, ${deltaY}px) scale(${deltaW}, ${deltaH})`,\n        },\n        { transform: 'translate(0, 0) scale(1, 1)' },\n      ],\n      { duration, easing, fill: 'forwards' }\n    );\n\n    animation.onfinish = () => {\n      htmlElement.style.transform = '';\n      htmlElement.style.transformOrigin = '';\n      onComplete?.();\n      resolve();\n    };\n  });\n};\n\n/**\n * FLIP helper for animating a list of elements.\n * Useful for reordering lists with smooth animations.\n *\n * @param elements - Array of elements to animate\n * @param performUpdate - Function that performs the DOM update\n * @param options - Animation configuration\n *\n * @example\n * ```ts\n * await flipList(listItems, () => {\n *   container.appendChild(container.firstChild); // Move first to last\n * });\n * ```\n */\nexport const flipList = async (\n  elements: Element[],\n  performUpdate: () => void,\n  options: FlipOptions = {}\n): Promise<void> => {\n  // First: Capture all positions\n  const positions = new Map<Element, ElementBounds>();\n  for (const el of elements) {\n    positions.set(el, capturePosition(el));\n  }\n\n  // Perform DOM update\n  performUpdate();\n\n  // Animate each element\n  const animations = elements.map((el) => {\n    const first = positions.get(el);\n    if (!first) return Promise.resolve();\n    return flip(el, first, options);\n  });\n\n  await Promise.all(animations);\n};\n\n// ============================================================================\n// Spring Physics\n// ============================================================================\n\n/**\n * Default spring configuration values.\n */\nconst DEFAULT_SPRING_CONFIG: Required<SpringConfig> = {\n  stiffness: 100,\n  damping: 10,\n  mass: 1,\n  precision: 0.01,\n};\n\n/**\n * Create a spring-based animation for smooth, physics-based motion.\n *\n * @param initialValue - Starting value for the spring\n * @param config - Spring physics configuration\n * @returns Spring instance for controlling the animation\n *\n * @example\n * ```ts\n * const x = spring(0, { stiffness: 120, damping: 14 });\n * x.onChange((value) => {\n *   element.style.transform = `translateX(${value}px)`;\n * });\n * await x.to(100);\n * ```\n */\nexport const spring = (initialValue: number, config: SpringConfig = {}): Spring => {\n  const { stiffness, damping, mass, precision } = {\n    ...DEFAULT_SPRING_CONFIG,\n    ...config,\n  };\n\n  let current = initialValue;\n  let velocity = 0;\n  let target = initialValue;\n  let animationFrame: number | null = null;\n  let resolvePromise: (() => void) | null = null;\n  const listeners = new Set<(value: number) => void>();\n\n  const notifyListeners = () => {\n    for (const listener of listeners) {\n      listener(current);\n    }\n  };\n\n  const step = () => {\n    // Spring physics calculation\n    const displacement = current - target;\n    const springForce = -stiffness * displacement;\n    const dampingForce = -damping * velocity;\n    const acceleration = (springForce + dampingForce) / mass;\n\n    velocity += acceleration * (1 / 60); // Assuming 60fps\n    current += velocity * (1 / 60);\n\n    notifyListeners();\n\n    // Check if spring has settled\n    if (Math.abs(velocity) < precision && Math.abs(displacement) < precision) {\n      current = target;\n      velocity = 0;\n      animationFrame = null;\n      notifyListeners();\n      resolvePromise?.();\n      resolvePromise = null;\n      return;\n    }\n\n    animationFrame = requestAnimationFrame(step);\n  };\n\n  return {\n    to(newTarget: number): Promise<void> {\n      target = newTarget;\n\n      if (animationFrame !== null) {\n        cancelAnimationFrame(animationFrame);\n      }\n\n      return new Promise((resolve) => {\n        resolvePromise = resolve;\n        animationFrame = requestAnimationFrame(step);\n      });\n    },\n\n    current(): number {\n      return current;\n    },\n\n    stop(): void {\n      if (animationFrame !== null) {\n        cancelAnimationFrame(animationFrame);\n        animationFrame = null;\n      }\n      velocity = 0;\n      resolvePromise?.();\n      resolvePromise = null;\n    },\n\n    onChange(callback: (value: number) => void): () => void {\n      listeners.add(callback);\n      return () => listeners.delete(callback);\n    },\n  };\n};\n\n/**\n * Preset spring configurations for common use cases.\n */\nexport const springPresets = {\n  /** Gentle, slow-settling spring */\n  gentle: { stiffness: 80, damping: 15 } as SpringConfig,\n  /** Responsive, snappy spring */\n  snappy: { stiffness: 200, damping: 20 } as SpringConfig,\n  /** Bouncy, playful spring */\n  bouncy: { stiffness: 300, damping: 8 } as SpringConfig,\n  /** Stiff, quick spring with minimal overshoot */\n  stiff: { stiffness: 400, damping: 30 } as SpringConfig,\n};\n"],"names":["transition","updateOrOptions","update","doc","capturePosition","element","rect","flip","firstBounds","options","duration","easing","onComplete","lastBounds","deltaX","deltaY","deltaW","deltaH","htmlElement","resolve","animation","flipList","elements","performUpdate","positions","el","animations","first","DEFAULT_SPRING_CONFIG","spring","initialValue","config","stiffness","damping","mass","precision","current","velocity","target","animationFrame","resolvePromise","listeners","notifyListeners","listener","step","displacement","springForce","dampingForce","acceleration","newTarget","callback","springPresets"],"mappings":"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"}

package/dist/platform/buckets.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Storage Buckets API wrapper.
+ * Provides a simplified interface for storing blobs and binary data.
+ * Falls back to IndexedDB when Storage Buckets API is not available.
+ */
+/**
+ * Bucket interface for blob storage operations.
+ */
+export interface Bucket {
+    /**
+     * Store a blob in the bucket.
+     * @param key - Unique identifier for the blob
+     * @param data - Blob data to store
+     */
+    put(key: string, data: Blob): Promise<void>;
+    /**
+     * Retrieve a blob from the bucket.
+     * @param key - Blob identifier
+     * @returns The stored blob or null if not found
+     */
+    get(key: string): Promise<Blob | null>;
+    /**
+     * Remove a blob from the bucket.
+     * @param key - Blob identifier
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * List all keys in the bucket.
+     * @returns Array of blob keys
+     */
+    keys(): Promise<string[]>;
+}
+/**
+ * Bucket manager for creating and accessing storage buckets.
+ */
+export declare const buckets: {
+    /**
+     * Open or create a storage bucket.
+     * @param name - Bucket name
+     * @returns Bucket instance for blob operations
+     */
+    open(name: string): Promise<Bucket>;
+};
+//# sourceMappingURL=buckets.d.ts.map

package/dist/platform/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../../src/platform/buckets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B;AAkED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;;;OAIG;eACc,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI1C,CAAC"}

package/dist/platform/cache.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Cache Storage API wrapper.
+ * Provides a simplified interface for caching responses and assets.
+ */
+/**
+ * Cache handle interface for managing cached resources.
+ */
+export interface CacheHandle {
+    /**
+     * Add a resource to the cache by URL.
+     * Fetches the resource and stores the response.
+     * @param url - URL to fetch and cache
+     */
+    add(url: string): Promise<void>;
+    /**
+     * Add multiple resources to the cache.
+     * @param urls - Array of URLs to fetch and cache
+     */
+    addAll(urls: string[]): Promise<void>;
+    /**
+     * Store a custom response in the cache.
+     * @param url - URL key for the cached response
+     * @param response - Response object to cache
+     */
+    put(url: string, response: Response): Promise<void>;
+    /**
+     * Retrieve a cached response.
+     * @param url - URL to look up
+     * @returns Cached Response or undefined if not found
+     */
+    match(url: string): Promise<Response | undefined>;
+    /**
+     * Remove a cached response.
+     * @param url - URL to remove from cache
+     * @returns True if the entry was deleted
+     */
+    remove(url: string): Promise<boolean>;
+    /**
+     * Get all cached request URLs.
+     * @returns Array of cached URLs
+     */
+    keys(): Promise<string[]>;
+}
+/**
+ * Cache manager for accessing the Cache Storage API.
+ */
+export declare const cache: {
+    /**
+     * Check if Cache Storage API is supported.
+     * @returns True if caches API is available
+     */
+    isSupported(): boolean;
+    /**
+     * Open or create a named cache.
+     * @param name - Cache name
+     * @returns CacheHandle for cache operations
+     */
+    open(name: string): Promise<CacheHandle>;
+    /**
+     * Delete a named cache.
+     * @param name - Cache name to delete
+     * @returns True if the cache was deleted
+     */
+    delete(name: string): Promise<boolean>;
+    /**
+     * List all cache names.
+     * @returns Array of cache names
+     */
+    keys(): Promise<string[]>;
+};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/platform/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B;AAkCD;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;;OAGG;mBACY,OAAO;IAItB;;;;OAIG;eACc,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ9C;;;;OAIG;iBACgB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5C;;;OAGG;YACW,OAAO,CAAC,MAAM,EAAE,CAAC;CAMhC,CAAC"}

package/dist/platform/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Platform module providing unified endpoints for web platform APIs.
+ * Offers consistent, promise-based interfaces with predictable errors.
+ *
+ * @module bquery/platform
+ */
+export { buckets } from './buckets';
+export type { Bucket } from './buckets';
+export { cache } from './cache';
+export type { CacheHandle } from './cache';
+export { notifications } from './notifications';
+export type { NotificationOptions } from './notifications';
+export { storage } from './storage';
+export type { IndexedDBOptions, StorageAdapter } from './storage';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/platform/notifications.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Web Notifications API wrapper.
+ * Provides a simplified interface for browser notifications.
+ */
+/**
+ * Notification options matching the standard NotificationOptions interface.
+ */
+export interface NotificationOptions {
+    /** Body text of the notification */
+    body?: string;
+    /** Icon URL for the notification */
+    icon?: string;
+    /** Badge icon for mobile devices */
+    badge?: string;
+    /** Tag for grouping notifications */
+    tag?: string;
+    /** Whether to require user interaction */
+    requireInteraction?: boolean;
+    /** Vibration pattern for mobile devices */
+    vibrate?: number[];
+    /** Additional data attached to the notification */
+    data?: unknown;
+}
+/**
+ * Notifications manager providing a clean interface for web notifications.
+ */
+export declare const notifications: {
+    /**
+     * Check if notifications are supported.
+     * @returns True if Notification API is available
+     */
+    isSupported(): boolean;
+    /**
+     * Get current permission status.
+     * @returns Current permission state
+     */
+    getPermission(): NotificationPermission;
+    /**
+     * Request notification permission from the user.
+     * @returns Promise resolving to the permission result
+     */
+    requestPermission(): Promise<NotificationPermission>;
+    /**
+     * Send a notification.
+     * Requires 'granted' permission.
+     * @param title - Notification title
+     * @param options - Optional notification settings
+     * @returns The Notification instance or null if not permitted
+     */
+    send(title: string, options?: NotificationOptions): Notification | null;
+};
+//# sourceMappingURL=notifications.d.ts.map

package/dist/platform/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/platform/notifications.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;mBACY,OAAO;IAItB;;;OAGG;qBACc,sBAAsB;IAKvC;;;OAGG;yBACwB,OAAO,CAAC,sBAAsB,CAAC;IAgB1D;;;;;;OAMG;gBACS,MAAM,YAAY,mBAAmB,GAAG,YAAY,GAAG,IAAI;CAaxE,CAAC"}

package/dist/platform/storage.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Unified storage adapters for web platform storage APIs.
+ * Provides a consistent, promise-based interface with predictable errors.
+ */
+/**
+ * Common interface for all storage adapters.
+ * All methods return promises for a unified async API.
+ */
+export interface StorageAdapter {
+    /**
+     * Retrieve a value by key.
+     * @param key - The storage key
+     * @returns The stored value or null if not found
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Store a value by key.
+     * @param key - The storage key
+     * @param value - The value to store
+     */
+    set<T>(key: string, value: T): Promise<void>;
+    /**
+     * Remove a value by key.
+     * @param key - The storage key
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Clear all stored values.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get all storage keys.
+     * @returns Array of all keys
+     */
+    keys(): Promise<string[]>;
+}
+/**
+ * IndexedDB configuration options.
+ */
+export interface IndexedDBOptions {
+    /** Database name */
+    name: string;
+    /** Object store name */
+    store: string;
+    /** Database version (optional) */
+    version?: number;
+}
+/**
+ * Storage factory providing access to different storage adapters.
+ */
+export declare const storage: {
+    /**
+     * Create a localStorage adapter.
+     * @returns StorageAdapter wrapping localStorage
+     */
+    local(): StorageAdapter;
+    /**
+     * Create a sessionStorage adapter.
+     * @returns StorageAdapter wrapping sessionStorage
+     */
+    session(): StorageAdapter;
+    /**
+     * Create an IndexedDB adapter with key-value interface.
+     * @param options - Database and store configuration
+     * @returns StorageAdapter wrapping IndexedDB
+     */
+    indexedDB(options: IndexedDBOptions): StorageAdapter;
+};
+//# sourceMappingURL=storage.d.ts.map

package/dist/platform/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/platform/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B;AAuDD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0ED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;aACM,cAAc;IAIvB;;;OAGG;eACQ,cAAc;IAIzB;;;;OAIG;uBACgB,gBAAgB,GAAG,cAAc;CAGrD,CAAC"}

package/dist/platform.es.mjs

@@ -0,0 +1,245 @@
+class d {
+  constructor(e) {
+    this.bucketName = e, this.dbPromise = null, this.storeName = "blobs";
+  }
+  openDB() {
+    if (this.dbPromise) return this.dbPromise;
+    const e = `bquery-bucket-${this.bucketName}`;
+    return this.dbPromise = new Promise((t, s) => {
+      const n = indexedDB.open(e, 1);
+      n.onupgradeneeded = () => {
+        const i = n.result;
+        i.objectStoreNames.contains(this.storeName) || i.createObjectStore(this.storeName);
+      }, n.onsuccess = () => t(n.result), n.onerror = () => s(n.error);
+    }), this.dbPromise;
+  }
+  async withStore(e, t) {
+    const s = await this.openDB();
+    return new Promise((n, i) => {
+      const a = s.transaction(this.storeName, e).objectStore(this.storeName), o = t(a);
+      o.onsuccess = () => n(o.result), o.onerror = () => i(o.error);
+    });
+  }
+  async put(e, t) {
+    await this.withStore("readwrite", (s) => s.put(t, e));
+  }
+  async get(e) {
+    return await this.withStore("readonly", (s) => s.get(e)) ?? null;
+  }
+  async remove(e) {
+    await this.withStore("readwrite", (t) => t.delete(e));
+  }
+  async keys() {
+    return (await this.withStore("readonly", (t) => t.getAllKeys())).map((t) => String(t));
+  }
+}
+const y = {
+  /**
+   * Open or create a storage bucket.
+   * @param name - Bucket name
+   * @returns Bucket instance for blob operations
+   */
+  async open(r) {
+    return new d(r);
+  }
+};
+class h {
+  constructor(e) {
+    this.cache = e;
+  }
+  async add(e) {
+    await this.cache.add(e);
+  }
+  async addAll(e) {
+    await this.cache.addAll(e);
+  }
+  async put(e, t) {
+    await this.cache.put(e, t);
+  }
+  async match(e) {
+    return this.cache.match(e);
+  }
+  async remove(e) {
+    return this.cache.delete(e);
+  }
+  async keys() {
+    return (await this.cache.keys()).map((t) => t.url);
+  }
+}
+const m = {
+  /**
+   * Check if Cache Storage API is supported.
+   * @returns True if caches API is available
+   */
+  isSupported() {
+    return "caches" in window;
+  },
+  /**
+   * Open or create a named cache.
+   * @param name - Cache name
+   * @returns CacheHandle for cache operations
+   */
+  async open(r) {
+    if (!this.isSupported())
+      throw new Error("bQuery: Cache Storage API not supported");
+    const e = await caches.open(r);
+    return new h(e);
+  },
+  /**
+   * Delete a named cache.
+   * @param name - Cache name to delete
+   * @returns True if the cache was deleted
+   */
+  async delete(r) {
+    return this.isSupported() ? caches.delete(r) : !1;
+  },
+  /**
+   * List all cache names.
+   * @returns Array of cache names
+   */
+  async keys() {
+    return this.isSupported() ? caches.keys() : [];
+  }
+}, S = {
+  /**
+   * Check if notifications are supported.
+   * @returns True if Notification API is available
+   */
+  isSupported() {
+    return "Notification" in window;
+  },
+  /**
+   * Get current permission status.
+   * @returns Current permission state
+   */
+  getPermission() {
+    return this.isSupported() ? Notification.permission : "denied";
+  },
+  /**
+   * Request notification permission from the user.
+   * @returns Promise resolving to the permission result
+   */
+  async requestPermission() {
+    return this.isSupported() ? Notification.permission === "granted" ? "granted" : Notification.permission === "denied" ? "denied" : Notification.requestPermission() : "denied";
+  },
+  /**
+   * Send a notification.
+   * Requires 'granted' permission.
+   * @param title - Notification title
+   * @param options - Optional notification settings
+   * @returns The Notification instance or null if not permitted
+   */
+  send(r, e) {
+    return this.isSupported() ? Notification.permission !== "granted" ? (console.warn("bQuery: Notification permission not granted"), null) : new Notification(r, e) : (console.warn("bQuery: Notifications not supported in this browser"), null);
+  }
+};
+class c {
+  constructor(e) {
+    this.storage = e;
+  }
+  async get(e) {
+    const t = this.storage.getItem(e);
+    if (t === null) return null;
+    try {
+      return JSON.parse(t);
+    } catch {
+      return t;
+    }
+  }
+  async set(e, t) {
+    const s = typeof t == "string" ? t : JSON.stringify(t);
+    this.storage.setItem(e, s);
+  }
+  async remove(e) {
+    this.storage.removeItem(e);
+  }
+  async clear() {
+    this.storage.clear();
+  }
+  async keys() {
+    return Object.keys(this.storage);
+  }
+}
+class l extends c {
+  constructor() {
+    super(localStorage);
+  }
+}
+class p extends c {
+  constructor() {
+    super(sessionStorage);
+  }
+}
+class w {
+  constructor(e) {
+    this.options = e, this.dbPromise = null;
+  }
+  /**
+   * Opens or creates the IndexedDB database.
+   */
+  openDB() {
+    return this.dbPromise ? this.dbPromise : (this.dbPromise = new Promise((e, t) => {
+      const s = indexedDB.open(this.options.name, this.options.version ?? 1);
+      s.onupgradeneeded = () => {
+        const n = s.result;
+        n.objectStoreNames.contains(this.options.store) || n.createObjectStore(this.options.store);
+      }, s.onsuccess = () => e(s.result), s.onerror = () => t(s.error);
+    }), this.dbPromise);
+  }
+  /**
+   * Executes a transaction on the object store.
+   */
+  async withStore(e, t) {
+    const s = await this.openDB();
+    return new Promise((n, i) => {
+      const a = s.transaction(this.options.store, e).objectStore(this.options.store), o = t(a);
+      o.onsuccess = () => n(o.result), o.onerror = () => i(o.error);
+    });
+  }
+  async get(e) {
+    return await this.withStore("readonly", (s) => s.get(e)) ?? null;
+  }
+  async set(e, t) {
+    await this.withStore("readwrite", (s) => s.put(t, e));
+  }
+  async remove(e) {
+    await this.withStore("readwrite", (t) => t.delete(e));
+  }
+  async clear() {
+    await this.withStore("readwrite", (e) => e.clear());
+  }
+  async keys() {
+    return (await this.withStore("readonly", (t) => t.getAllKeys())).map((t) => String(t));
+  }
+}
+const b = {
+  /**
+   * Create a localStorage adapter.
+   * @returns StorageAdapter wrapping localStorage
+   */
+  local() {
+    return new l();
+  },
+  /**
+   * Create a sessionStorage adapter.
+   * @returns StorageAdapter wrapping sessionStorage
+   */
+  session() {
+    return new p();
+  },
+  /**
+   * Create an IndexedDB adapter with key-value interface.
+   * @param options - Database and store configuration
+   * @returns StorageAdapter wrapping IndexedDB
+   */
+  indexedDB(r) {
+    return new w(r);
+  }
+};
+export {
+  y as buckets,
+  m as cache,
+  S as notifications,
+  b as storage
+};
+//# sourceMappingURL=platform.es.mjs.map