sails-sqlite/lib/private/machines/destroy-manager.js

SQLite adapter for Sails/Waterline

module.exports = {
  friendlyName: 'Destroy manager',

  description: 'Destroy the specified SQLite connection manager.',

  extendedDescription:
    'For SQLite, this involves closing the database connection. Unlike other databases, SQLite does not use connection pools, so this operation is relatively straightforward.',

  sync: true,

  inputs: {
    manager: {
      description: 'The SQLite connection manager instance to destroy.',
      extendedDescription:
        'Only managers built using the `createManager()` method of this driver are supported. The database connection manager instance provided must not have been destroyed previously.',
      example: '===',
      required: true
    },

    meta: {
      friendlyName: 'Meta (custom)',
      description: 'Additional options to pass to the SQLite driver.',
      extendedDescription:
        'This is reserved for custom driver-specific extensions. Please refer to the better-sqlite3 documentation for more specific information.',
      example: '==='
    }
  },

  exits: {
    success: {
      description: 'The specified SQLite manager was successfully destroyed.',
      outputFriendlyName: 'Report',
      outputDescription:
        'The `meta` property is reserved for custom driver-specific extensions.',
      outputExample: '==='
    }
  },

  fn: ({ manager, meta }, exits) => {
    try {
      // Validate the manager
      if (
        typeof manager !== 'object' ||
        manager === null ||
        typeof manager.close !== 'function'
      ) {
        return exits.error(
          new Error(
            'The provided `manager` is not a valid SQLite manager. It should be a better-sqlite3 Database instance with a `close` method.'
          )
        )
      }

      // Check if the database is already closed
      if (!manager.open) {
        console.warn(
          'SQLite manager appears to already be closed, skipping destruction'
        )
        return exits.success({ meta })
      }

      // Use graceful cleanup if available (from enhanced create-manager)
      if (typeof manager.closeGracefully === 'function') {
        manager.closeGracefully()
      } else {
        // Fallback to basic close
        manager.close()
      }

      // Verify the connection is actually closed
      if (manager.open) {
        throw new Error('Failed to close SQLite database connection')
      }

      return exits.success({
        meta: {
          ...meta,
          destroyedAt: new Date().toISOString()
        }
      })
    } catch (error) {
      return exits.error(
        new Error(`Error destroying SQLite manager: ${error.message}`)
      )
    }
  }
}