RubyGems - smriti - Versions diffs - 0.5.0 - Mend

smriti 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (124) hide show

checksums.yaml +7 -0
data/LICENSE +21 -0
data/README.md +168 -0
data/Rakefile +15 -0
data/app/assets/images/smriti/android-chrome-192x192.png +0 -0
data/app/assets/images/smriti/android-chrome-512x512.png +0 -0
data/app/assets/images/smriti/apple-touch-icon.png +0 -0
data/app/assets/images/smriti/favicon-16x16.png +0 -0
data/app/assets/images/smriti/favicon-32x32.png +0 -0
data/app/assets/images/smriti/favicon-48x48.png +0 -0
data/app/assets/images/smriti/favicon.ico +0 -0
data/app/assets/images/smriti/favicon.svg +18 -0
data/app/assets/images/smriti/logo.svg +18 -0
data/app/assets/images/smriti/mask-icon.svg +5 -0
data/app/assets/stylesheets/smriti/application.css +1040 -0
data/app/controllers/smriti/admin/application_controller.rb +135 -0
data/app/controllers/smriti/admin/dashboard_controller.rb +32 -0
data/app/controllers/smriti/admin/mat_view_definitions_controller.rb +372 -0
data/app/controllers/smriti/admin/mat_view_runs_controller.rb +185 -0
data/app/controllers/smriti/admin/preferences_controller.rb +91 -0
data/app/helpers/smriti/admin/datatable_helper.rb +249 -0
data/app/helpers/smriti/admin/localized_digit_helper.rb +70 -0
data/app/helpers/smriti/admin/ui_helper.rb +539 -0
data/app/javascript/smriti/application.js +8 -0
data/app/javascript/smriti/controllers/application.js +10 -0
data/app/javascript/smriti/controllers/body_setup_controller.js +120 -0
data/app/javascript/smriti/controllers/datatable_controller.js +351 -0
data/app/javascript/smriti/controllers/details_controller.js +200 -0
data/app/javascript/smriti/controllers/drawer_controller.js +470 -0
data/app/javascript/smriti/controllers/flash_controller.js +112 -0
data/app/javascript/smriti/controllers/index.js +10 -0
data/app/javascript/smriti/controllers/mv_confirm_controller.js +435 -0
data/app/javascript/smriti/controllers/tabs_controller.js +184 -0
data/app/javascript/smriti/controllers/tooltip_controller.js +525 -0
data/app/javascript/smriti/controllers/turbo_frame_lifecycle_controller.js +342 -0
data/app/jobs/smriti/application_job.rb +144 -0
data/app/jobs/smriti/create_view_job.rb +87 -0
data/app/jobs/smriti/delete_view_job.rb +89 -0
data/app/jobs/smriti/refresh_view_job.rb +94 -0
data/app/models/concerns/smriti_i18n.rb +139 -0
data/app/models/concerns/smriti_paginate.rb +70 -0
data/app/models/concerns/smriti_query_helper.rb +36 -0
data/app/models/smriti/application_record.rb +39 -0
data/app/models/smriti/mat_view_definition.rb +254 -0
data/app/models/smriti/mat_view_run.rb +275 -0
data/app/views/layouts/smriti/_footer.html.erb +47 -0
data/app/views/layouts/smriti/_header.html.erb +25 -0
data/app/views/layouts/smriti/admin.html.erb +47 -0
data/app/views/layouts/smriti/turbo_frame.html.erb +3 -0
data/app/views/smriti/admin/dashboard/index.html.erb +38 -0
data/app/views/smriti/admin/mat_view_definitions/_definition_actions.html.erb +94 -0
data/app/views/smriti/admin/mat_view_definitions/_dt-index-empty-row.html.erb +11 -0
data/app/views/smriti/admin/mat_view_definitions/_dt-index-row.html.erb +27 -0
data/app/views/smriti/admin/mat_view_definitions/empty.html.erb +1 -0
data/app/views/smriti/admin/mat_view_definitions/form.html.erb +79 -0
data/app/views/smriti/admin/mat_view_definitions/index.html.erb +10 -0
data/app/views/smriti/admin/mat_view_definitions/show.html.erb +40 -0
data/app/views/smriti/admin/mat_view_runs/_dt-index-empty-row.html.erb +11 -0
data/app/views/smriti/admin/mat_view_runs/_dt-index-row.html.erb +41 -0
data/app/views/smriti/admin/mat_view_runs/index.html.erb +1 -0
data/app/views/smriti/admin/mat_view_runs/show.html.erb +64 -0
data/app/views/smriti/admin/preferences/show.html.erb +49 -0
data/app/views/smriti/admin/ui/_card.html.erb +15 -0
data/app/views/smriti/admin/ui/_datatable.html.erb +34 -0
data/app/views/smriti/admin/ui/_datatable_filters.html.erb +45 -0
data/app/views/smriti/admin/ui/_datatable_tbody.html.erb +11 -0
data/app/views/smriti/admin/ui/_datatable_tfoot.html.erb +70 -0
data/app/views/smriti/admin/ui/_datatable_thead.html.erb +105 -0
data/app/views/smriti/admin/ui/_details.html.erb +10 -0
data/app/views/smriti/admin/ui/_flash.html.erb +6 -0
data/app/views/smriti/admin/ui/_table.html.erb +8 -0
data/config/importmap.rb +9 -0
data/config/locales/ar.yml +223 -0
data/config/locales/de.yml +230 -0
data/config/locales/en-AU-ocker.yml +223 -0
data/config/locales/en-AU.yml +202 -0
data/config/locales/en-BORK.yml +225 -0
data/config/locales/en-CA.yml +223 -0
data/config/locales/en-GB.yml +223 -0
data/config/locales/en-LOL.yml +219 -0
data/config/locales/en-SCOT.yml +223 -0
data/config/locales/en-SHAKESPEARE.yml +225 -0
data/config/locales/en-US-pirate.yml +222 -0
data/config/locales/en-US.yml +225 -0
data/config/locales/en-YODA.yml +221 -0
data/config/locales/en.yml +223 -0
data/config/locales/es.yml +226 -0
data/config/locales/fa.yml +223 -0
data/config/locales/fr-CA.yml +227 -0
data/config/locales/fr.yml +227 -0
data/config/locales/he.yml +218 -0
data/config/locales/hi.yml +223 -0
data/config/locales/it.yml +225 -0
data/config/locales/ja-JP.yml +215 -0
data/config/locales/pt.yml +225 -0
data/config/locales/ru.yml +228 -0
data/config/locales/ur.yml +225 -0
data/config/locales/zh-CN.yml +214 -0
data/config/locales/zh-TW.yml +214 -0
data/config/routes.rb +36 -0
data/lib/ext/exception.rb +20 -0
data/lib/generators/smriti/install/install_generator.rb +86 -0
data/lib/generators/smriti/install/templates/create_mat_view_definitions.rb +29 -0
data/lib/generators/smriti/install/templates/create_mat_view_runs.rb +32 -0
data/lib/generators/smriti/install/templates/smriti_initializer.rb +23 -0
data/lib/smriti/admin/auth_bridge.rb +93 -0
data/lib/smriti/admin/default_auth.rb +62 -0
data/lib/smriti/configuration.rb +58 -0
data/lib/smriti/engine.rb +82 -0
data/lib/smriti/helpers/ui_test_ids.rb +49 -0
data/lib/smriti/jobs/adapter.rb +81 -0
data/lib/smriti/service_response.rb +75 -0
data/lib/smriti/services/base_service.rb +471 -0
data/lib/smriti/services/check_matview_exists.rb +76 -0
data/lib/smriti/services/concurrent_refresh.rb +94 -0
data/lib/smriti/services/create_view.rb +173 -0
data/lib/smriti/services/delete_view.rb +111 -0
data/lib/smriti/services/regular_refresh.rb +90 -0
data/lib/smriti/services/swap_refresh.rb +181 -0
data/lib/smriti/version.rb +21 -0
data/lib/smriti.rb +64 -0
data/lib/tasks/helpers.rb +185 -0
data/lib/tasks/smriti_tasks.rake +151 -0
metadata +206 -0

data/app/javascript/smriti/controllers/turbo_frame_lifecycle_controller.js ADDED Viewed

@@ -0,0 +1,342 @@
+/**
+ * Copyright Codevedas Inc. 2025-present
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * FrameLifecycleController
+ * ------------------------
+ * @classdesc Stimulus controller orchestrating Turbo Frame and Turbo Stream lifecycles.
+ *
+ * Responsibilities:
+ * - Add datatable context headers to outgoing Turbo Frame requests.
+ * - Show and clear a unified “busy” state on frames and <body>.
+ * - Handle both frame navigations and streamed responses.
+ * - Track multiple concurrent busy frames safely.
+ *
+ * Key Methods:
+ * - `_handleBeforeFetch`, `_handleComplete`: frame navigation lifecycle.
+ * - `_handleBeforeStreamRender`: stream render interception.
+ * - `_setFrameBusy`, `_setBodyBusy`: visual busy state management.
+ * - `_bindFrame`, `_unbindFrame`: frame event lifecycle binding.
+ *
+ * Events handled:
+ * - `turbo:before-fetch-request`
+ * - `turbo:frame-load`
+ * - `turbo:fetch-request-error`
+ * - `turbo:before-stream-render`
+ */
+import { Controller } from "@hotwired/stimulus";
+export default class extends Controller {
+  /** @type {string[]} Stimulus targets: one or more <turbo-frame> elements to observe. */
+  static targets = ["frame"];
+  /** @type {string[]} CSS classes toggled on frames and <body> when busy. */
+  static classes = ["busy"];
+  /** @type {object} Configurable values (ARIA attribute name for busy state). */
+  static values = {
+    busyAttribute: { type: String, default: "aria-busy" },
+  };
+  // ────────────────────────────────────────────────────────────────
+  // Initialization and Lifecycle
+  // ────────────────────────────────────────────────────────────────
+  /**
+   * Initialize internal state and bind `this` for handlers.
+   */
+  initialize() {
+    /** @type {Set<HTMLElement>} currently-busy frames */
+    this._busyFrames = new Set();
+    this._handleBeforeFetch = this._handleBeforeFetch.bind(this);
+    this._handleComplete = this._handleComplete.bind(this);
+    this._handleBeforeStreamRender = this._handleBeforeStreamRender.bind(this);
+    this._flushBusyFrames = this._flushBusyFrames.bind(this);
+    /** Symbol to temporarily store affected frames on a <turbo-stream>. */
+    this._affectedKey = Symbol("mvAffectedFrames");
+  }
+  /**
+   * Stimulus lifecycle: connect.
+   * - Cache <body> reference.
+   * - Bind Turbo events on all frames.
+   * - Subscribe to global stream render event.
+   */
+  connect() {
+    this.bodyElement = document.body;
+    this.frameTargets.forEach((frame) => this._bindFrame(frame));
+    document.addEventListener("drawer:refresh", this._flushBusyFrames);
+    document.addEventListener(
+      "turbo:before-stream-render",
+      this._handleBeforeStreamRender,
+    );
+  }
+  /**
+   * Stimulus lifecycle: disconnect.
+   * - Unbind frame listeners.
+   * - Remove global stream listener.
+   * - Clear busy state.
+   */
+  disconnect() {
+    this.frameTargets.forEach((frame) => this._unbindFrame(frame));
+    document.removeEventListener("drawer:refresh", this._flushBusyFrames);
+    document.removeEventListener(
+      "turbo:before-stream-render",
+      this._handleBeforeStreamRender,
+    );
+    this._busyFrames.forEach((f) => this._setFrameBusy(f, false));
+    this._busyFrames.clear();
+    this._setBodyBusy(false);
+  }
+  /**
+   * Stimulus callback: when a frame target connects.
+   * @param {HTMLElement} frame
+   */
+  frameTargetConnected(frame) {
+    this._bindFrame(frame);
+  }
+  /**
+   * Stimulus callback: when a frame target disconnects.
+   * @param {HTMLElement} frame
+   */
+  frameTargetDisconnected(frame) {
+    this._unbindFrame(frame);
+    this._busyFrames.delete(frame);
+    if (this._busyFrames.size === 0) this._setBodyBusy(false);
+  }
+  // ────────────────────────────────────────────────────────────────
+  // Turbo Frame Lifecycle Handlers
+  // ────────────────────────────────────────────────────────────────
+  /**
+   * Handle outgoing Turbo Frame requests.
+   * Adds datatable headers and marks frame busy.
+   *
+   * @param {CustomEvent} event turbo:before-fetch-request
+   */
+  _handleBeforeFetch(event) {
+    const frame = /** @type {HTMLElement} */ (event.currentTarget);
+    // Add datatable context headers
+    const params = new URL(window.location).searchParams;
+    event.detail.fetchOptions.headers["X-DtSearch"] =
+      params.get("dtsearch") || "";
+    event.detail.fetchOptions.headers["X-DtSort"] = params.get("dtsort") || "";
+    event.detail.fetchOptions.headers["X-DtFilter"] =
+      params.get("dtfilter") || "";
+    event.detail.fetchOptions.headers["X-DtPage"] = params.get("dtpage") || "1";
+    event.detail.fetchOptions.headers["X-DtPerPage"] =
+      params.get("dtperpage") || "25";
+    this._setFrameBusy(frame, true);
+    this._setBodyBusy(true);
+  }
+  /**
+   * Handle completed or failed Turbo Frame loads.
+   *
+   * @param {CustomEvent} event turbo:frame-load | turbo:fetch-request-error
+   */
+  _handleComplete(event) {
+    const frame = /** @type {HTMLElement} */ (event.currentTarget);
+    this._setFrameBusy(frame, false);
+    if (this._busyFrames.size === 0) this._setBodyBusy(false);
+  }
+  // ────────────────────────────────────────────────────────────────
+  // Turbo Stream Lifecycle Handlers
+  // ────────────────────────────────────────────────────────────────
+  /**
+   * Clear all busy states.
+   * Used when drawers or other UI elements may have interrupted frame loads.
+   */
+  _flushBusyFrames() {
+    this._busyFrames.forEach((f) => this._setFrameBusy(f, false));
+    this._busyFrames.clear();
+    this._setBodyBusy(false);
+    // Notify datatables to refresh, since now no frames are busy
+    // and they may have been affected by the drawer action.
+    document.dispatchEvent(
+      new CustomEvent("datatable:refresh", {
+        bubbles: false,
+        cancelable: false,
+      }),
+    );
+  }
+  /**
+   * Handle streamed updates (no frame navigation).
+   * Marks affected frames busy before render and clears after.
+   *
+   * @param {CustomEvent} event turbo:before-stream-render
+   */
+  _handleBeforeStreamRender(event) {
+    const streamEl = event.target; // <turbo-stream>
+    const affected = this._framesAffectedByStream(streamEl);
+    if (affected.length > 0) {
+      affected.forEach((f) => this._setFrameBusy(f, true));
+      this._setBodyBusy(true);
+    }
+    // Stash affected frames for cleanup
+    streamEl[this._affectedKey] = affected;
+    // Wrap the render function for post-render cleanup
+    const originalRender = event.detail.render;
+    event.detail.render = (el) => {
+      try {
+        originalRender(el);
+      } finally {
+        const frames = streamEl[this._affectedKey] || [];
+        frames.forEach((f) => this._setFrameBusy(f, false));
+        delete streamEl[this._affectedKey];
+        if (this._busyFrames.size === 0) this._setBodyBusy(false);
+      }
+    };
+  }
+  /**
+   * Determine which frames a stream will affect.
+   *
+   * @param {HTMLElement} streamEl <turbo-stream> element
+   * @return {HTMLElement[]} affected frames
+   */
+  _framesAffectedByStream(streamEl) {
+    const targetId = streamEl.getAttribute("target");
+    const targetsSelector = streamEl.getAttribute("targets");
+    const out = new Set();
+    // target="id"
+    if (targetId) {
+      const el = document.getElementById(targetId);
+      let frame = null;
+      if (el) {
+        frame = el.tagName === "TURBO-FRAME" ? el : el.closest("turbo-frame");
+      }
+      if (frame && this._isManagedFrame(frame)) out.add(frame);
+    }
+    // targets="selector"
+    if (targetsSelector) {
+      document.querySelectorAll(targetsSelector).forEach((node) => {
+        const frame = node.closest("turbo-frame");
+        if (frame && this._isManagedFrame(frame)) out.add(frame);
+      });
+    }
+    return Array.from(out);
+  }
+  // ────────────────────────────────────────────────────────────────
+  // Binding Helpers
+  // ────────────────────────────────────────────────────────────────
+  /**
+   * Attach Turbo lifecycle events to a frame.
+   * @param {HTMLElement} frame
+   */
+  _bindFrame(frame) {
+    if (frame.__mvLifecycleBound) return;
+    frame.addEventListener(
+      "turbo:before-fetch-request",
+      this._handleBeforeFetch,
+    );
+    frame.addEventListener("turbo:frame-load", this._handleComplete);
+    frame.addEventListener("turbo:fetch-request-error", this._handleComplete);
+    frame.__mvLifecycleBound = true;
+  }
+  /**
+   * Detach Turbo lifecycle events from a frame.
+   * @param {HTMLElement} frame
+   */
+  _unbindFrame(frame) {
+    if (!frame.__mvLifecycleBound) return;
+    frame.removeEventListener(
+      "turbo:before-fetch-request",
+      this._handleBeforeFetch,
+    );
+    frame.removeEventListener("turbo:frame-load", this._handleComplete);
+    frame.removeEventListener(
+      "turbo:fetch-request-error",
+      this._handleComplete,
+    );
+    delete frame.__mvLifecycleBound;
+  }
+  // ────────────────────────────────────────────────────────────────
+  // Busy State Helpers
+  // ────────────────────────────────────────────────────────────────
+  /**
+   * Determine if a frame belongs to this controller.
+   * @param {HTMLElement} frame
+   * @return {boolean}
+   */
+  _isManagedFrame(frame) {
+    return this.frameTargets.includes
+      ? this.frameTargets.includes(frame)
+      : this.frameTargets.indexOf?.(frame) >= 0;
+  }
+  /**
+   * Mark or unmark a frame as busy, coercing child elements to their frame.
+   *
+   * @param {HTMLElement} node - may be the frame or a child element.
+   * @param {boolean} busy
+   */
+  _setFrameBusy(node, busy) {
+    if (!node) return;
+    // Normalize to the owning <turbo-frame>
+    let frame =
+      node.tagName === "TURBO-FRAME" ? node : node.closest?.("turbo-frame");
+    if (!frame || !this._isManagedFrame(frame)) return;
+    if (busy) {
+      this._busyFrames.add(frame);
+      frame.setAttribute(this.busyAttributeValue, "true");
+      frame.setAttribute("busy", "");
+      if (this.hasBusyClass) frame.classList.add(this.busyClass);
+    } else {
+      this._busyFrames.delete(frame);
+      frame.removeAttribute(this.busyAttributeValue);
+      frame.removeAttribute("busy");
+      if (this.hasBusyClass) frame.classList.remove(this.busyClass);
+    }
+  }
+  /**
+   * Apply or clear busy indicators on <body>.
+   *
+   * @param {boolean} busy
+   */
+  _setBodyBusy(busy) {
+    if (!this.bodyElement) return;
+    if (busy) {
+      this.bodyElement.setAttribute(this.busyAttributeValue, "true");
+      this.bodyElement.setAttribute("busy", "");
+      if (this.hasBusyClass) this.bodyElement.classList.add(this.busyClass);
+    } else {
+      this.bodyElement.removeAttribute(this.busyAttributeValue);
+      this.bodyElement.removeAttribute("busy");
+      if (this.hasBusyClass) this.bodyElement.classList.remove(this.busyClass);
+    }
+  }
+}

data/app/jobs/smriti/application_job.rb ADDED Viewed

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+##
+# Top-level namespace for the smriti engine.
+#
+# All classes, modules, and services for materialised view management
+# are defined under this namespace.
+#
+# @example Accessing a job
+#   Smriti::ApplicationJob
+#
+module Smriti
+  ##
+  # Base class for all background jobs in the smriti engine.
+  #
+  # Inherits from {ActiveJob::Base} and provides a common superclass
+  # for engine jobs such as {Smriti::CreateViewJob} and {Smriti::RefreshViewJob}.
+  #
+  # @abstract
+  #
+  # @see Smriti::CreateViewJob
+  # @see Smriti::RefreshViewJob
+  # @see Smriti::DeleteViewJob
+  #
+  # @example Defining a custom job
+  #   class MyCustomJob < Smriti::ApplicationJob
+  #     def perform(mat_view_definition_id)
+  #       # custom logic here
+  #     end
+  #   end
+  #
+  class ApplicationJob < ActiveJob::Base
+    private
+    def record_run(definition, operation, &)
+      start = monotime
+      run = start_run(definition, operation)
+      response = yield
+      finalize_run(run, response, elapsed_ms(start))
+      response.to_h
+    rescue StandardError => e
+      fail_run(run, e, elapsed_ms(start))
+      raise e
+    end
+    ##
+    # Begin a {Smriti::MatViewRun} row for lifecycle tracking.
+    #
+    # @api private
+    #
+    # @return [Smriti::MatViewRun]
+    #
+    def start_run(definition, operation)
+      Smriti::MatViewRun.create!(
+        mat_view_definition: definition,
+        status: :running,
+        started_at: Time.current,
+        operation: operation
+      )
+    end
+    ##
+    # Finalize the run with success/failure, timing, and meta from the response.
+    #
+    # @api private
+    #
+    # @param run [Smriti::MatViewRun]
+    # @param response [Smriti::ServiceResponse, nil] may be nil if exception raised
+    # @param duration_ms [Integer]
+    # @return [void]
+    #
+    def finalize_run(run, response, duration_ms)
+      base_attrs = {
+        finished_at: Time.current,
+        duration_ms: duration_ms,
+        meta: { request: response.request, response: response.response }.compact
+      }
+      if response.success?
+        run.update!(base_attrs.merge(status: :success, error: nil))
+      else
+        run.update!(base_attrs.merge(status: :failed, error: response.error))
+      end
+    end
+    ##
+    # Mark the run failed due to an exception.
+    #
+    # @api private
+    #
+    # @param run [Smriti::MatViewRun]
+    # @param exception [Exception]
+    # @param duration_ms [Integer]
+    # @return [void]
+    #
+    def fail_run(run, exception, duration_ms)
+      run&.update!(
+        error: exception.mv_serialize_error,
+        finished_at: Time.current,
+        duration_ms: duration_ms,
+        status: :failed
+      )
+    end
+    ##
+    # Monotonic clock getter (for elapsed-time measurement).
+    #
+    # @api private
+    # @return [Float] seconds
+    #
+    def monotime = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    ##
+    # Convert monotonic start time to elapsed milliseconds.
+    #
+    # @api private
+    # @param start [Float]
+    # @return [Integer] elapsed ms
+    #
+    def elapsed_ms(start) = ((monotime - start) * 1000).round
+    ##
+    # Normalize the strategy argument into a symbol or default.
+    #
+    # @api private
+    #
+    # @param arg [Symbol, String, nil]
+    # @return [Symbol] One of `:estimated`, `:exact`, or `:none` by default.
+    #
+    def normalize_strategy(arg)
+      case arg
+      when String, Symbol
+        arg.to_sym
+      else
+        :none
+      end
+    end
+  end
+end

data/app/jobs/smriti/create_view_job.rb ADDED Viewed

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+##
+# Top-level namespace for the smriti engine.
+module Smriti
+  ##
+  # ActiveJob that handles *creation* of PostgreSQL materialised views for a
+  # given {Smriti::MatViewDefinition}.
+  #
+  # The job:
+  # 1. Normalizes the `force` argument.
+  # 2. Looks up the target {Smriti::MatViewDefinition}.
+  # 3. Starts a {Smriti::MatViewRun} row to track lifecycle/timing, with `operation: :create`.
+  # 4. Executes {Smriti::Services::CreateView}.
+  # 5. Finalizes the run with success/failure, duration, and meta.
+  #
+  # @see Smriti::Services::CreateView
+  # @see Smriti::MatViewDefinition
+  # @see Smriti::MatViewRun
+  #
+  # @example Enqueue a create job
+  #   Smriti::CreateViewJob.perform_later(definition.id, force: true)
+  #
+  # @example Inline run (test/dev)
+  #   Smriti::CreateViewJob.new.perform(definition.id, false)
+  #
+  class CreateViewJob < ApplicationJob
+    ##
+    # Queue name for the job.
+    #
+    # Uses `Smriti.configuration.job_queue` when configured, otherwise `:default`.
+    #
+    # @return [void]
+    #
+    queue_as { Smriti.configuration.job_queue || :default }
+    ##
+    # Perform the create job for the given materialised view definition.
+    #
+    # @api public
+    #
+    # @param mat_view_definition_id [Integer, String] ID of {Smriti::MatViewDefinition}.
+    # @param force_arg [Boolean, Hash, nil] Optional flag or hash (`{ force: true }`)
+    # @param row_count_strategy_arg [:Symbol, String] One of: `:estimated`, `:exact`, `:none` or `nil`.
+    #
+    # @return [Hash] Serialized {Smriti::ServiceResponse#to_h}:
+    #   - `:status` [Symbol]
+    #   - `:error` [String, nil]
+    #   - `:duration_ms` [Integer]
+    #   - `:meta` [Hash]
+    #
+    # @raise [StandardError] Re-raised on unexpected failure after marking the run failed.
+    #
+    def perform(mat_view_definition_id, force_arg = nil, row_count_strategy_arg = nil)
+      definition = Smriti::MatViewDefinition.find(mat_view_definition_id)
+      record_run(definition, :create) do
+        Smriti::Services::CreateView.new(definition,
+                                         force: force?(force_arg),
+                                         row_count_strategy: normalize_strategy(row_count_strategy_arg)).call
+      end
+    end
+    private
+    ##
+    # Normalize the `force` argument into a boolean.
+    #
+    # Accepts either a boolean-ish value or a Hash (e.g., `{ force: true }` or `{ "force" => true }`).
+    #
+    # @api private
+    #
+    # @param arg [Object] Raw argument; commonly `true/false`, `nil`
+    # @return [Boolean] Coerced force flag.
+    #
+    def force?(arg)
+      return false if arg.nil?
+      !!arg
+    end
+  end
+end

data/app/jobs/smriti/delete_view_job.rb ADDED Viewed

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+# Copyright Codevedas Inc. 2025-present
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+##
+# Top-level namespace for the smriti engine.
+module Smriti
+  ##
+  # ActiveJob that handles *deletion* of PostgreSQL materialised views via
+  # {Smriti::Services::DeleteView}.
+  #
+  # This job mirrors {Smriti::CreateViewJob} and {Smriti::RefreshViewJob}:
+  # it times the run and persists lifecycle state in {Smriti::MatViewRun}.
+  #
+  # @see Smriti::Services::DeleteView
+  # @see Smriti::MatViewDefinition
+  # @see Smriti::MatViewRun
+  #
+  # @example Enqueue a delete job
+  #   Smriti::DeleteViewJob.perform_later(definition.id, cascade: true)
+  #
+  # @example Inline run (test/dev)
+  #   Smriti::DeleteViewJob.new.perform(definition.id, false)
+  #
+  class DeleteViewJob < ApplicationJob
+    ###
+    # cascade flag for the service call
+    # @return [Boolean]
+    attr_reader :cascade
+    ##
+    # Queue name for the job.
+    #
+    # Uses `Smriti.configuration.job_queue` when configured, otherwise `:default`.
+    #
+    queue_as { Smriti.configuration.job_queue || :default }
+    ##
+    # Perform the job for the given materialised view definition.
+    #
+    # @api public
+    #
+    # @param mat_view_definition_id [Integer, String] ID of {Smriti::MatViewDefinition}.
+    # @param cascade_arg [Boolean, String, Integer, Hash, nil] Cascade option.
+    # @param row_count_strategy_arg [:Symbol, String] One of: `:estimated`, `:exact`, `:none` or `nil`.
+    #
+    # @return [Hash] Serialized {Smriti::ServiceResponse#to_h}:
+    #   - `:status` [Symbol]
+    #   - `:error` [String, nil]
+    #   - `:duration_ms` [Integer]
+    #   - `:meta` [Hash]
+    #
+    # @raise [StandardError] Re-raised on unexpected failure after marking the run failed.
+    #
+    def perform(mat_view_definition_id, cascade_arg = nil, row_count_strategy_arg = nil)
+      definition = Smriti::MatViewDefinition.find(mat_view_definition_id)
+      record_run(definition, :drop) do
+        Smriti::Services::DeleteView.new(definition,
+                                         cascade: cascade?(cascade_arg),
+                                         row_count_strategy: normalize_strategy(row_count_strategy_arg)).call
+      end
+    end
+    private
+    ##
+    # Evaluate if a value is "truthy" for cascade.
+    #
+    # @api private
+    # @param value [TrueClass, FalseClass, String, Integer, nil, Object]
+    # @return [Boolean]
+    #
+    def cascade?(value)
+      case value
+      when true
+        true
+      when String
+        %w[true 1 yes].include?(value.strip.downcase)
+      when Integer
+        value == 1
+      else
+        false
+      end
+    end
+  end
+end